Prerequisites
- Claude Code installed
- A Fireworks API key (
fw_...) or a Fire Pass key (fpk_...) - The FireConnect CLI (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 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 yourfpk_... key during login or with --api-key:
glm-fast-latest.
Default model mapping
| Alias | Standard key (fw_...) | Fire Pass key (fpk_...) |
|---|---|---|
| main | glm-fast-latest | glm-fast-latest |
| opus | glm-fast-latest | glm-fast-latest |
| fable | glm-fast-latest | glm-fast-latest |
| sonnet | glm-5p1 | glm-fast-latest |
| haiku | deepseek-v4-flash | glm-fast-latest |
| subagent | deepseek-v4-flash | glm-fast-latest |
glm-fast-latest are expanded to full Fireworks paths (for example, accounts/fireworks/routers/glm-fast-latest[1m]). FireConnect appends the [1m] suffix on main, opus, and fable so Claude Code enables 1M context. The subagent slot is written without [1m] because Claude Code forwards that value verbatim to the provider API.
What gets written
FireConnect writes these settings to~/.claude/settings.json (no literal API key in the file — the key lives in the OS keychain and is fetched at runtime via apiKeyHelper):
apiKeyHelper at runtime to fetch the key from the OS keychain. FireConnect 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
Lists serverless models from the Fireworks API (supports_serverless=true) and merges known public platform routers (glm-latest, glm-fast-latest, glm-5p2-fast, kimi-fast-latest, kimi-latest, kimi-k2p6-turbo, and kimi-k2p7-code-fast). Every row is tagged serverless.
--api-key, the OS keychain, ~/.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 status vs fireconnect claude model list
| Command | Shows |
|---|---|
fireconnect claude status | Your current provider, auth, configured alias mapping, and Fireworks serverless rates per slot |
fireconnect claude model list | Available serverless endpoints from the Fireworks API, with IN / OUT pricing where known |
Claude Code pricing estimates
Claude Code’s/model picker and session cost estimates use Anthropic list prices, not Fireworks serverless rates. For example, the default glm-fast-latest mapping may show Opus-tier estimates around 25 per Mtok while Fireworks bills at model-specific serverless rates (often much lower).
FireConnect cannot override Claude Code’s price column. Use fireconnect claude status and fireconnect claude model list for Fireworks rates, and check the billing dashboard for actual spend.
FireConnect also writes ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION with Fireworks rates for your main model — that text appears as the subtitle on the custom picker entry at the bottom of /model, not in the price column.
CLI reference
fireconnect claude help for all options.
Switch models
Turn off Fireworks routing
~/.claude/settings.json from the backup saved in ~/.fireconnect/claude/.