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

​
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: 
{
    "env": {
        "ANTHROPIC_API_KEY": "YOUR_FIREWORKS_API_KEY",
        "ANTHROPIC_BASE_URL": "https://api.fireworks.ai/inference",
        "ANTHROPIC_MODEL": "accounts/fireworks/models/kimi-k2p5",
        "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1"
    }
}

​
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:
ModelModel ID
Kimi-2.5accounts/fireworks/models/kimi-k2p5

​
All Model Overrides

For complete compatibility with Claude Code’s subagents, set all model environment variables: 
{
    "env": {
        "ANTHROPIC_API_KEY": "YOUR_FIREWORKS_API_KEY",
        "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"
    }
}

​
Environment Variables Alternative

If you prefer environment variables over settings.json: 
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"

​
Alternative: LiteLLM Proxy

For advanced features like interleaved thinking or when using specific model capabilities, you can use Fireworks’ LiteLLM proxy endpoint: 
{
    "apiKeyHelper": "bash -c 'echo $FIREWORKS_API_KEY'",
    "env": {
        "ANTHROPIC_BASE_URL": "https://litellm.fireworks.ai",
        "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"
    }
}
This approach uses apiKeyHelper to pass your API key from the environment variable.

​
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.

​
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

​
Need Help?

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