> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fireworks.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Claude Code

> Use Claude Code with Fireworks AI models

<Info>
  Fireworks offers **200+ models**—set the **model endpoint** in your configuration; each model lists the value on its page in the [Fireworks Model Library](https://app.fireworks.ai/models).
</Info>

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

The two tabs below are **examples** (Kimi K2.6 and GLM-5). Select one to update the code snippets on this page.

<Tabs>
  <Tab title="Kimi-2.6">
    Moonshot's flagship agent model optimized for coding, reasoning, and long-context tasks. Features 256k context window and native multimodal capabilities.
  </Tab>

  <Tab title="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.
  </Tab>
</Tabs>

## 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:

<Tabs>
  <Tab title="Kimi-2.6">
    ```json theme={null}
    {
        "$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-k2p6",
            "ANTHROPIC_SMALL_FAST_MODEL": "accounts/fireworks/models/kimi-k2p6",
            "ANTHROPIC_DEFAULT_SONNET_MODEL": "accounts/fireworks/models/kimi-k2p6",
            "ANTHROPIC_DEFAULT_HAIKU_MODEL": "accounts/fireworks/models/kimi-k2p6",
            "ANTHROPIC_DEFAULT_OPUS_MODEL": "accounts/fireworks/models/kimi-k2p6"
        },
        "model": "accounts/fireworks/models/kimi-k2p6"
    }
    ```
  </Tab>

  <Tab title="GLM-5">
    ```json theme={null}
    {
        "$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"
        },
        "model": "accounts/fireworks/models/glm-5"
    }
    ```
  </Tab>
</Tabs>

<Tip>
  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.
</Tip>

### Step 2: Launch Claude Code

```bash theme={null}
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](https://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.6 | `accounts/fireworks/models/kimi-k2p6` |
| GLM-5    | `accounts/fireworks/models/glm-5`     |

### All Model Overrides

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

<Tabs>
  <Tab title="Kimi-2.6">
    ```json theme={null}
    {
        "$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-k2p6",
            "ANTHROPIC_SMALL_FAST_MODEL": "accounts/fireworks/models/kimi-k2p6",
            "ANTHROPIC_DEFAULT_SONNET_MODEL": "accounts/fireworks/models/kimi-k2p6",
            "ANTHROPIC_DEFAULT_HAIKU_MODEL": "accounts/fireworks/models/kimi-k2p6",
            "ANTHROPIC_DEFAULT_OPUS_MODEL": "accounts/fireworks/models/kimi-k2p6"
        },
        "model": "accounts/fireworks/models/kimi-k2p6"
    }
    ```
  </Tab>

  <Tab title="GLM-5">
    ```json theme={null}
    {
        "$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"
        },
        "model": "accounts/fireworks/models/glm-5"
    }
    ```
  </Tab>
</Tabs>

### Environment Variables Alternative

If you prefer environment variables over settings.json, use `ANTHROPIC_AUTH_TOKEN` (not `ANTHROPIC_API_KEY`) to ensure proper authentication with Fireworks:

<Tabs>
  <Tab title="Kimi-2.6">
    ```bash theme={null}
    export ANTHROPIC_BASE_URL="https://api.fireworks.ai/inference"
    export ANTHROPIC_AUTH_TOKEN="your-fireworks-api-key"
    export ANTHROPIC_MODEL="accounts/fireworks/models/kimi-k2p6"
    export ANTHROPIC_SMALL_FAST_MODEL="accounts/fireworks/models/kimi-k2p6"
    export ANTHROPIC_DEFAULT_SONNET_MODEL="accounts/fireworks/models/kimi-k2p6"
    export ANTHROPIC_DEFAULT_HAIKU_MODEL="accounts/fireworks/models/kimi-k2p6"
    export ANTHROPIC_DEFAULT_OPUS_MODEL="accounts/fireworks/models/kimi-k2p6"
    ```
  </Tab>

  <Tab title="GLM-5">
    ```bash theme={null}
    export ANTHROPIC_BASE_URL="https://api.fireworks.ai/inference"
    export ANTHROPIC_AUTH_TOKEN="your-fireworks-api-key"
    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"
    ```
  </Tab>
</Tabs>

<Tip>
  **Why `ANTHROPIC_AUTH_TOKEN` instead of `ANTHROPIC_API_KEY`?** When using environment variables, Claude Code uses `ANTHROPIC_AUTH_TOKEN` for passthrough authentication with third-party providers. When using `settings.json`, the `apiKeyHelper` field handles authentication, so `ANTHROPIC_AUTH_TOKEN` is not required in the `env` section.
</Tip>

## 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:**

```yaml theme={null}
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:**

<Tabs>
  <Tab title="Kimi-2.6">
    ```json theme={null}
    {
        "$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-k2p6",
            "ANTHROPIC_SMALL_FAST_MODEL": "accounts/fireworks/models/kimi-k2p6",
            "ANTHROPIC_DEFAULT_SONNET_MODEL": "accounts/fireworks/models/kimi-k2p6",
            "ANTHROPIC_DEFAULT_HAIKU_MODEL": "accounts/fireworks/models/kimi-k2p6",
            "ANTHROPIC_DEFAULT_OPUS_MODEL": "accounts/fireworks/models/kimi-k2p6"
        },
        "model": "accounts/fireworks/models/kimi-k2p6"
    }
    ```
  </Tab>

  <Tab title="GLM-5">
    ```json theme={null}
    {
        "$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"
        },
        "model": "accounts/fireworks/models/glm-5"
    }
    ```
  </Tab>
</Tabs>

### Portkey

[Portkey](https://portkey.ai) 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:**

<Tabs>
  <Tab title="Kimi-2.6">
    ```json theme={null}
    {
        "$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-k2p6",
            "ANTHROPIC_SMALL_FAST_MODEL": "accounts/fireworks/models/kimi-k2p6",
            "ANTHROPIC_DEFAULT_SONNET_MODEL": "accounts/fireworks/models/kimi-k2p6",
            "ANTHROPIC_DEFAULT_HAIKU_MODEL": "accounts/fireworks/models/kimi-k2p6",
            "ANTHROPIC_DEFAULT_OPUS_MODEL": "accounts/fireworks/models/kimi-k2p6"
        },
        "model": "accounts/fireworks/models/kimi-k2p6"
    }
    ```
  </Tab>

  <Tab title="GLM-5">
    ```json theme={null}
    {
        "$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"
        },
        "model": "accounts/fireworks/models/glm-5"
    }
    ```
  </Tab>
</Tabs>

<Tip>
  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`).
</Tip>

## Suggested Models

<CardGroup cols={2}>
  <Card title="Kimi-2.6" icon="sparkles">
    Moonshot's flagship agent model optimized for coding, reasoning, and long-context tasks. Features 256k context window and native multimodal capabilities.
  </Card>

  <Card title="GLM-5" icon="robot">
    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.
  </Card>
</CardGroup>

## Why Use Fireworks with Claude Code?

* **Cost Savings**: Significantly lower cost per token compared to Claude's native pricing
* **Adaptive serverless limits**: Throughput scales with usage instead of relying on a fixed hourly subscription tier. See [Serverless rate limits](/serverless/rate-limits).
* **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](/ecosystem/integrations/agent-frameworks)
* Learn about [function calling](/guides/function-calling) with Fireworks
* Check out [reasoning models](/guides/reasoning) for complex tasks

## Need Help?

For assistance with Claude Code integration, [contact our team](https://fireworks.ai/contact) or join our [Discord community](https://discord.gg/fireworks-ai).