Claude Code

Fireworks AI supports Claude Code through our Anthropic-compatible API, enabling you to use powerful open-source models as a drop-in replacement for Claude’s models.

Choose Your Model

Select a model below—all code snippets on this page will update automatically.

Kimi-2.5
GLM-5

Moonshot’s flagship agent model optimized for coding, reasoning, and long-context tasks. Features 256k context window and native multimodal capabilities.

Quick Setup

The easiest way to configure Claude Code with Fireworks is via the .claude/settings.json file:

Step 1: Create Settings File

Create a .claude/settings.json file in one of these locations: Option A: Home directory (recommended)

~/.claude/settings.json

Option B: Project directory

./.claude/settings.json  (in your current project folder)

Add the following configuration:

Kimi-2.5
GLM-5

{
    "$schema": "https://json.schemastore.org/claude-code-settings.json",
    "apiKeyHelper": "bash -c 'echo your-fireworks-api-key'",
    "env": {
        "ANTHROPIC_BASE_URL": "https://api.fireworks.ai/inference",
        "ANTHROPIC_MODEL": "accounts/fireworks/models/kimi-k2p5",
        "ANTHROPIC_SMALL_FAST_MODEL": "accounts/fireworks/models/kimi-k2p5",
        "ANTHROPIC_DEFAULT_SONNET_MODEL": "accounts/fireworks/models/kimi-k2p5",
        "ANTHROPIC_DEFAULT_HAIKU_MODEL": "accounts/fireworks/models/kimi-k2p5",
        "ANTHROPIC_DEFAULT_OPUS_MODEL": "accounts/fireworks/models/kimi-k2p5",
        "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1"
    },
    "model": "accounts/fireworks/models/kimi-k2p5"
}

{
    "$schema": "https://json.schemastore.org/claude-code-settings.json",
    "apiKeyHelper": "bash -c 'echo your-fireworks-api-key'",
    "env": {
        "ANTHROPIC_BASE_URL": "https://api.fireworks.ai/inference",
        "ANTHROPIC_MODEL": "accounts/fireworks/models/glm-5",
        "ANTHROPIC_SMALL_FAST_MODEL": "accounts/fireworks/models/glm-5",
        "ANTHROPIC_DEFAULT_SONNET_MODEL": "accounts/fireworks/models/glm-5",
        "ANTHROPIC_DEFAULT_HAIKU_MODEL": "accounts/fireworks/models/glm-5",
        "ANTHROPIC_DEFAULT_OPUS_MODEL": "accounts/fireworks/models/glm-5",
        "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1"
    },
    "model": "accounts/fireworks/models/glm-5"
}

Setting all model override flags (ANTHROPIC_SMALL_FAST_MODEL, ANTHROPIC_DEFAULT_SONNET_MODEL, etc.) ensures Claude Code’s subagents (Explore, Web Search, etc.) use Fireworks models instead of defaulting to Anthropic’s Claude.

Step 2: Launch Claude Code

claude

Claude Code will automatically detect the configuration and use Fireworks models.

Configuration Details

API Key

Generate a Fireworks API key from app.fireworks.ai. Replace your-fireworks-api-key with your actual key.

Model Names

Use Fireworks model IDs directly without the fireworks_ai/ prefix:

Model	Model ID
Kimi-2.5	`accounts/fireworks/models/kimi-k2p5`
GLM-5	`accounts/fireworks/models/glm-5`

All Model Overrides

For complete compatibility with Claude Code’s subagents, set all model environment variables:

Kimi-2.5
GLM-5

{
    "$schema": "https://json.schemastore.org/claude-code-settings.json",
    "apiKeyHelper": "bash -c 'echo your-fireworks-api-key'",
    "env": {
        "ANTHROPIC_BASE_URL": "https://api.fireworks.ai/inference",
        "ANTHROPIC_MODEL": "accounts/fireworks/models/kimi-k2p5",
        "ANTHROPIC_SMALL_FAST_MODEL": "accounts/fireworks/models/kimi-k2p5",
        "ANTHROPIC_DEFAULT_SONNET_MODEL": "accounts/fireworks/models/kimi-k2p5",
        "ANTHROPIC_DEFAULT_HAIKU_MODEL": "accounts/fireworks/models/kimi-k2p5",
        "ANTHROPIC_DEFAULT_OPUS_MODEL": "accounts/fireworks/models/kimi-k2p5",
        "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1"
    },
    "model": "accounts/fireworks/models/kimi-k2p5"
}

{
    "$schema": "https://json.schemastore.org/claude-code-settings.json",
    "apiKeyHelper": "bash -c 'echo your-fireworks-api-key'",
    "env": {
        "ANTHROPIC_BASE_URL": "https://api.fireworks.ai/inference",
        "ANTHROPIC_MODEL": "accounts/fireworks/models/glm-5",
        "ANTHROPIC_SMALL_FAST_MODEL": "accounts/fireworks/models/glm-5",
        "ANTHROPIC_DEFAULT_SONNET_MODEL": "accounts/fireworks/models/glm-5",
        "ANTHROPIC_DEFAULT_HAIKU_MODEL": "accounts/fireworks/models/glm-5",
        "ANTHROPIC_DEFAULT_OPUS_MODEL": "accounts/fireworks/models/glm-5",
        "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1"
    },
    "model": "accounts/fireworks/models/glm-5"
}

Environment Variables Alternative

If you prefer environment variables over settings.json:

Kimi-2.5
GLM-5

export ANTHROPIC_API_KEY="your-fireworks-api-key"
export ANTHROPIC_BASE_URL="https://api.fireworks.ai/inference"
export ANTHROPIC_MODEL="accounts/fireworks/models/kimi-k2p5"
export ANTHROPIC_SMALL_FAST_MODEL="accounts/fireworks/models/kimi-k2p5"
export ANTHROPIC_DEFAULT_SONNET_MODEL="accounts/fireworks/models/kimi-k2p5"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="accounts/fireworks/models/kimi-k2p5"
export ANTHROPIC_DEFAULT_OPUS_MODEL="accounts/fireworks/models/kimi-k2p5"
export CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS="1"

export ANTHROPIC_API_KEY="your-fireworks-api-key"
export ANTHROPIC_BASE_URL="https://api.fireworks.ai/inference"
export ANTHROPIC_MODEL="accounts/fireworks/models/glm-5"
export ANTHROPIC_SMALL_FAST_MODEL="accounts/fireworks/models/glm-5"
export ANTHROPIC_DEFAULT_SONNET_MODEL="accounts/fireworks/models/glm-5"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="accounts/fireworks/models/glm-5"
export ANTHROPIC_DEFAULT_OPUS_MODEL="accounts/fireworks/models/glm-5"
export CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS="1"

Middleware/Proxy Providers

You can use LLM middleware providers like LiteLLM or Portkey to add features like request logging, rate limiting, and unified API access across multiple providers.

LiteLLM Proxy (Self-Hosted)

Host LiteLLM yourself as a middleware proxy with passthrough to Fireworks’ Anthropic-compatible endpoint: 1. LiteLLM config.yaml:

general_settings:
  allow_client_side_credentials: true
  pass_through_endpoints:
    - path: "/fw-anthropic"
      target: "https://api.fireworks.ai/inference"
      include_subpath: true
      forward_headers: true

2. Claude Code settings:

Kimi-2.5
GLM-5

{
    "$schema": "https://json.schemastore.org/claude-code-settings.json",
    "apiKeyHelper": "bash -c 'echo your-fireworks-api-key'",
    "env": {
        "ANTHROPIC_BASE_URL": "https://<YOUR_LITELLM_HOST_IP_OR_DOMAIN>/fw-anthropic",
        "ANTHROPIC_MODEL": "accounts/fireworks/models/kimi-k2p5",
        "ANTHROPIC_SMALL_FAST_MODEL": "accounts/fireworks/models/kimi-k2p5",
        "ANTHROPIC_DEFAULT_SONNET_MODEL": "accounts/fireworks/models/kimi-k2p5",
        "ANTHROPIC_DEFAULT_HAIKU_MODEL": "accounts/fireworks/models/kimi-k2p5",
        "ANTHROPIC_DEFAULT_OPUS_MODEL": "accounts/fireworks/models/kimi-k2p5",
        "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1"
    },
    "model": "accounts/fireworks/models/kimi-k2p5"
}

{
    "$schema": "https://json.schemastore.org/claude-code-settings.json",
    "apiKeyHelper": "bash -c 'echo your-fireworks-api-key'",
    "env": {
        "ANTHROPIC_BASE_URL": "https://<YOUR_LITELLM_HOST_IP_OR_DOMAIN>/fw-anthropic",
        "ANTHROPIC_MODEL": "accounts/fireworks/models/glm-5",
        "ANTHROPIC_SMALL_FAST_MODEL": "accounts/fireworks/models/glm-5",
        "ANTHROPIC_DEFAULT_SONNET_MODEL": "accounts/fireworks/models/glm-5",
        "ANTHROPIC_DEFAULT_HAIKU_MODEL": "accounts/fireworks/models/glm-5",
        "ANTHROPIC_DEFAULT_OPUS_MODEL": "accounts/fireworks/models/glm-5",
        "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1"
    },
    "model": "accounts/fireworks/models/glm-5"
}

Portkey

Portkey provides a managed gateway for routing requests to Fireworks with additional observability and control features. 1. Portkey Provider Setup: In your Portkey dashboard, create an Anthropic provider with these settings:

Provider: Anthropic
Custom Host: https://api.fireworks.ai/inference/v1
API Key: Your Fireworks API key

2. Claude Code settings:

Kimi-2.5
GLM-5

{
    "$schema": "https://json.schemastore.org/claude-code-settings.json",
    "env": {
        "ANTHROPIC_BASE_URL": "https://api.portkey.ai",
        "ANTHROPIC_AUTH_TOKEN": "your-portkey-api-key",
        "ANTHROPIC_CUSTOM_HEADERS": "x-portkey-api-key: your-portkey-api-key\nx-portkey-provider: your-custom-fireworks-provider\nanthropic-version: 2023-06-01",
        "ANTHROPIC_MODEL": "accounts/fireworks/models/kimi-k2p5",
        "ANTHROPIC_SMALL_FAST_MODEL": "accounts/fireworks/models/kimi-k2p5",
        "ANTHROPIC_DEFAULT_SONNET_MODEL": "accounts/fireworks/models/kimi-k2p5",
        "ANTHROPIC_DEFAULT_HAIKU_MODEL": "accounts/fireworks/models/kimi-k2p5",
        "ANTHROPIC_DEFAULT_OPUS_MODEL": "accounts/fireworks/models/kimi-k2p5",
        "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1"
    },
    "model": "accounts/fireworks/models/kimi-k2p5"
}

{
    "$schema": "https://json.schemastore.org/claude-code-settings.json",
    "env": {
        "ANTHROPIC_BASE_URL": "https://api.portkey.ai",
        "ANTHROPIC_AUTH_TOKEN": "your-portkey-api-key",
        "ANTHROPIC_CUSTOM_HEADERS": "x-portkey-api-key: your-portkey-api-key\nx-portkey-provider: your-custom-fireworks-provider\nanthropic-version: 2023-06-01",
        "ANTHROPIC_MODEL": "accounts/fireworks/models/glm-5",
        "ANTHROPIC_SMALL_FAST_MODEL": "accounts/fireworks/models/glm-5",
        "ANTHROPIC_DEFAULT_SONNET_MODEL": "accounts/fireworks/models/glm-5",
        "ANTHROPIC_DEFAULT_HAIKU_MODEL": "accounts/fireworks/models/glm-5",
        "ANTHROPIC_DEFAULT_OPUS_MODEL": "accounts/fireworks/models/glm-5",
        "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1"
    },
    "model": "accounts/fireworks/models/glm-5"
}

Replace your-portkey-api-key with your Portkey API key and your-custom-fireworks-provider with the name of your custom Anthropic-compatible provider in Portkey that points to Fireworks (e.g., @fireworks-kimi or @fireworks-glm).

Supported Models

Kimi-2.5

Moonshot’s flagship agent model optimized for coding, reasoning, and long-context tasks. Features 256k context window and native multimodal capabilities.

GLM-5

Zhipu AI’s large-scale model for code generation, reasoning, AI agents with tool use, and long-context tasks. Alternative to Claude Sonnet 4.5, GPT-5, and Gemini 3 Pro.

Why Use Fireworks with Claude Code?

Cost Savings: Significantly lower cost per token compared to Claude’s native pricing
No Rate Limits: No hourly quotas or surprise throttling
Model Choice: Access to the latest open-source models
Privacy: Your code stays within your chosen infrastructure
Transparent Pricing: Clear per-token pricing without subscription tiers

Next Steps

Explore other Agent Frameworks
Learn about function calling with Fireworks
Check out reasoning models for complex tasks

Need Help?

For assistance with Claude Code integration, contact our team or join our Discord community.

Get Started

Developer Pass

Deployments

Models & Inference

Fine Tuning

Administration

Security & Compliance

Integrations

Choose Your Model

Quick Setup

Step 1: Create Settings File

Step 2: Launch Claude Code

Configuration Details

API Key

Model Names

All Model Overrides

Environment Variables Alternative

Middleware/Proxy Providers

LiteLLM Proxy (Self-Hosted)

Portkey

Supported Models

Kimi-2.5

GLM-5

Why Use Fireworks with Claude Code?

Next Steps

Need Help?

Get Started

Developer Pass

Deployments

Models & Inference

Fine Tuning

Administration

Security & Compliance

Integrations

​Choose Your Model

​Quick Setup

​Step 1: Create Settings File

​Step 2: Launch Claude Code

​Configuration Details

​API Key

​Model Names

​All Model Overrides

​Environment Variables Alternative

​Middleware/Proxy Providers

​LiteLLM Proxy (Self-Hosted)

​Portkey

​Supported Models

Kimi-2.5

GLM-5

​Why Use Fireworks with Claude Code?

​Next Steps

​Need Help?

Choose Your Model

Quick Setup

Step 1: Create Settings File

Step 2: Launch Claude Code

Configuration Details

API Key

Model Names

All Model Overrides

Environment Variables Alternative

Middleware/Proxy Providers

LiteLLM Proxy (Self-Hosted)

Portkey

Supported Models

Why Use Fireworks with Claude Code?

Next Steps

Need Help?