Claude Code

FireConnect routes Claude Code through Fireworks AI models. See the FireConnect overview for install and CLI basics.

Change models: fireconnect claude on --model <id> (or --opus / --sonnet / …). See Models.

Prerequisites

Claude Code installed
A Fireworks API key (fw_...) or a Fire Pass key (fpk_...)
The FireConnect CLI v0.9.1+ (see Install)

Azure routing not implemented yet for Claude Code. fireconnect claude on always configures direct Fireworks, even when global config has --provider azure or you pass --azure. See Microsoft Foundry in FireConnect.

Enable Fireworks routing

fireconnect login
fireconnect claude on

Or pass the key once:

fireconnect claude on --api-key fw_...

Restart Claude Code after enabling, then test with:

hi

After fireconnect claude on, start a new Claude Code session or run /model to pick up model changes. To use a new model in the same session, start a new session or /exit and resume with claude --resume <id>.

Change models

fireconnect model list --search glm
fireconnect claude on --model firerouter               # main only
fireconnect claude on --interactive                    # wizard for all six slots
fireconnect claude on --opus glm-fast-latest --sonnet glm-fast-latest
fireconnect claude status

Slot flags are independent. Re-running on without flags keeps your current mapping.

Using Fire Pass

Use your fpk_... key during login or with --api-key:

fireconnect claude on --api-key fpk_...

FireConnect detects Fire Pass keys and routes all model aliases to kimi-fast-latest.

Example model mapping

When you run fireconnect claude on without model flags, FireConnect applies the mapping below. First-time setup opens an interactive model picker unless you pass --non-interactive. Override any slot with --model, --opus, --sonnet, --haiku, --fable, or --subagent.

Alias	Standard key (`fw_...`)	Fire Pass key (`fpk_...`)
main	`firerouter` on first connect when Claude already has Anthropic auth (OAuth / `sk-ant-…`) or workspace BYOK; otherwise `kimi-fast-latest`	`kimi-fast-latest`
opus	`glm-fast-latest`	`kimi-fast-latest`
sonnet	`glm-fast-latest`	`kimi-fast-latest`
haiku	`deepseek-v4-flash`	`kimi-fast-latest`
fable	`kimi-fast-latest`	`kimi-fast-latest`
subagent	`deepseek-v4-flash`	`kimi-fast-latest`

Short model IDs expand automatically. FireConnect appends [1m] on 1M-context models (not on subagent). FireConnect saves your chosen mapping per key type. Reopen the wizard anytime:

fireconnect claude on --interactive

Use --non-interactive to skip the wizard and apply saved preferences or the example mapping above. --interactive cannot be combined with model flags like --model or --opus. In the wizard, toggle between fast models (routers on the high-speed path) and non-fast models (pinned model IDs that stay stable across catalog updates).

What gets written

FireConnect writes these settings to ~/.claude/settings.json. Claude Code authenticates via the X-Fireworks-Api-Key custom header (not apiKeyHelper). The Fireworks key is written to the file with mode 0600:

{
  "model": "kimi-fast-latest",
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.fireworks.ai/inference",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-fast-latest[1m]",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-fast-latest[1m]",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-v4-flash",
    "ANTHROPIC_DEFAULT_FABLE_MODEL": "kimi-fast-latest",
    "CLAUDE_CODE_SUBAGENT_MODEL": "deepseek-v4-flash",
    "ANTHROPIC_CUSTOM_HEADERS": "X-Fireworks-Api-Key: YOUR_FIREWORKS_API_KEY"
  }
}

FireConnect saves a backup of your previous provider settings to ~/.fireconnect/claude/ so fireconnect claude off can restore them.

Web search MCP

When you run fireconnect claude on, FireConnect can install the Fireworks WebSearch MCP for eligible accounts. FireConnect WebSearch integration is Claude Code only today; other harnesses are coming soon. The MCP itself works from any harness that supports HTTP MCP. See the WebSearch MCP guide for the endpoint URL, bearer token auth, and manual setup on Claude Code or other tools. When installation succeeds, fireconnect claude on prints a confirmation such as Web search → fireworks-websearch (installed). Restart Claude Code, then run /mcp and connect to fireworks-websearch. fireconnect claude off removes the managed MCP entry and restores your previous ~/.claude/settings.json (including any permissions rules).

Browsing and picking models

fireconnect model list --search glm
fireconnect claude on --sonnet kimi-latest

fireconnect model list shows serverless endpoints and pricing. fireconnect claude status shows your current mapping and rates. Fire Pass keys only list Fire Pass routers. FireConnect rejects --model firerouter with Fire Pass (fpk_...) on every harness; use an fw_... key.

FireRouter

Route requests through FireRouter. FireConnect rejects --model firerouter with Fire Pass (fpk_...) on every harness; use an fw_... key.

fireconnect claude on --model firerouter
fireconnect claude on --opus firerouter --anthropic-api-key sk-ant-...

Use --model firerouter for main, or slot flags like --opus firerouter. Pass --anthropic-api-key sk-ant-... on on, or store it once with fireconnect configure --anthropic-api-key sk-ant-.... Bias savings vs quality with --routing-preference (1-5; default 3):

fireconnect claude on --model firerouter --routing-preference 4

See Routing preferences.

Session usage

Claude Code’s /model picker shows Anthropic list prices, not Fireworks serverless rates. For actual spend, use fireconnect claude usage. It reads Claude Code session logs and estimates Fireworks cost from your configured models.

fireconnect claude usage                    # latest session
fireconnect claude usage --last-n 5         # five most recent parent sessions
fireconnect claude usage --session <id>     # session id prefix or path to a .jsonl log
fireconnect claude usage --plain            # plain-text summary (scripts)
fireconnect claude usage --verbose          # per-request token rows
fireconnect claude usage --json             # machine-readable output

Pair with fireconnect claude status for per-slot Fireworks rates and fireconnect model list to browse serverless pricing.

Claude Code pricing estimates

Claude Code’s cost column in the /model picker still uses Anthropic list prices. The session usage section above is the better place to estimate real Fireworks spend. FireConnect cannot override Claude Code’s price column. For example, a kimi-fast-latest main mapping may show Opus-tier estimates while Fireworks bills at serverless rates. Check the billing dashboard for actual spend.

Troubleshooting

Text-only models and images

Claude Code cannot mark a model as non-vision. Pasting an image on a text-only slot (for example glm-fast-latest or deepseek-v4-flash) can break the session. Recover with /rewind, then avoid images on that slot or map it to a vision model (for example kimi-fast-latest):

fireconnect claude on --sonnet kimi-fast-latest

fireconnect claude on warns when your mapping includes text-only models. fireconnect claude status labels each slot vision or text-only.

CLI reference

fireconnect claude on         # Route Claude Code through Fireworks
fireconnect claude off        # Restore your previous provider
fireconnect claude status     # Show the current provider and model mapping
fireconnect claude usage      # Session token usage and estimated Fireworks cost
fireconnect claude help       # Show harness-specific help

Run fireconnect claude help for all options.

Turn off Fireworks routing

fireconnect claude off

This restores your previous ~/.claude/settings.json from the backup saved in ~/.fireconnect/claude/.

Uninstall

To remove FireConnect from your machine entirely (all harnesses):

fireconnect uninstall

Source

FireConnect is open source: github.com/fw-ai/fireconnect

Get Started

Serverless

Deployments

Models & Inference

Training

Fire Pass

Fireworks Nexus

Administration

Security & Compliance

Integrations

Reference

Prerequisites

Enable Fireworks routing

Change models

Using Fire Pass

Example model mapping

What gets written

Web search MCP

Browsing and picking models

FireRouter

Session usage

Claude Code pricing estimates

Troubleshooting

Text-only models and images

CLI reference

Turn off Fireworks routing

Uninstall

Source

​Prerequisites

​Enable Fireworks routing

​Change models

​Using Fire Pass

​Example model mapping

​What gets written

​Web search MCP

​Browsing and picking models

​FireRouter

​Session usage

​Claude Code pricing estimates

​Troubleshooting

​Text-only models and images

​CLI reference

​Turn off Fireworks routing

​Uninstall

​Source

Prerequisites

Enable Fireworks routing

Change models

Using Fire Pass

Example model mapping

What gets written

Web search MCP

Browsing and picking models

FireRouter

Session usage

Claude Code pricing estimates

Troubleshooting

Text-only models and images

CLI reference

Turn off Fireworks routing

Uninstall

Source