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

​
Prerequisites

​
Enable Fireworks routing

export FIREWORKS_API_KEY=fw_...
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, model select, or model reset, settings are updated immediately. To use a new model in the same session, run /model in Claude Code, start a new session, or /exit and resume with claude --resume <id>.

​
Using Fire Pass

Use your fpk_... key instead of a standard fw_... key: 
fireconnect claude on --api-key fpk_...
FireConnect detects Fire Pass keys and routes all model aliases to glm-latest.

​
Default model mapping

AliasStandard key (fw_...)Fire Pass key (fpk_...)
mainglm-latestglm-latest
opusglm-latestglm-latest
sonnetglm-5p1glm-latest
haikuminimax-m2p5glm-latest
subagentminimax-m2p5glm-latest
Short model IDs like glm-latest are expanded to full Fireworks paths (for example, accounts/fireworks/routers/glm-latest[1m]).

​
What gets written

FireConnect writes these settings to ~/.claude/settings.json: 
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.fireworks.ai/inference",
    "ANTHROPIC_API_KEY": "fw_YOUR_FIREWORKS_API_KEY",
    "ANTHROPIC_AUTH_TOKEN": "fw_YOUR_FIREWORKS_API_KEY",
    "ANTHROPIC_MODEL": "accounts/fireworks/routers/glm-latest[1m]",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "accounts/fireworks/routers/glm-latest[1m]",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "accounts/fireworks/models/glm-5p1",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "accounts/fireworks/models/minimax-m2p5",
    "CLAUDE_CODE_SUBAGENT_MODEL": "accounts/fireworks/models/minimax-m2p5"
  }
}
FireConnect writes both ANTHROPIC_API_KEY (preferred) and ANTHROPIC_AUTH_TOKEN (compatibility alias) with the same Fireworks key. It saves a backup of your previous provider settings to ~/.fireconnect/claude/ so fireconnect claude off can restore them.

​
Browsing and picking models

fireconnect claude model list              # browse callable serverless endpoints
fireconnect claude model select            # pick a model for Claude Code
fireconnect claude model select --slot sonnet   # update one alias

​
fireconnect claude model list

Lists serverless models from the Fireworks API (supports_serverless=true) and merges known public platform routers (glm-latest, kimi-fast-latest, kimi-latest, kimi-k2p6-turbo, and kimi-k2p7-code-fast). Every row is tagged serverless. 
fireconnect claude model list
fireconnect claude model list --search glm
fireconnect claude model list --json
Resolves the key from --api-key, harness settings, ~/.fireconnect/config.json, or FIREWORKS_API_KEY. Fire Pass keys (fpk_...) show Fire Pass-supported routers only.

​
fireconnect claude model select

Interactive picker. Requires a terminal and Fireworks to be enabled. 
fireconnect claude model select
fireconnect claude model select --slot sonnet
fireconnect claude model select --slot sonnet --search glm

​
fireconnect claude status vs fireconnect claude model list

CommandShows
fireconnect claude statusYour current provider, auth, and configured alias mapping
fireconnect claude model listAvailable serverless endpoints from the Fireworks API

​
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 model list # Browse serverless models
fireconnect claude model select   # Pick a model interactively
fireconnect claude model reset    # Reset model aliases to defaults
fireconnect claude help       # Show harness-specific help
Run fireconnect claude help for all options.

​
Switch models

fireconnect claude on --main glm-latest --sonnet glm-5p1 --haiku minimax-m2p5 --subagent minimax-m2p5
Or pick interactively: 
fireconnect claude model select --slot opus

​
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