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

​
Prerequisites

​
Enable Fireworks routing

fireconnect login
fireconnect opencode on
Restart OpenCode after enabling, then confirm routing: 
fireconnect opencode status

​
Using Fire Pass

Use your fpk_... key during login or with --api-key: 
fireconnect opencode on --api-key fpk_...
FireConnect detects Fire Pass keys and defaults OpenCode to glm-fast-latest.

​
Default model

OpenCode routes a single default model (no opus/sonnet/haiku alias slots). The default is glm-fast-latest, written to config as fireworks-ai/glm-fast-latest. Short model IDs like glm-5p1 are expanded to full Fireworks paths (for example, accounts/fireworks/models/glm-5p1).

​
What gets written

FireConnect merges a fireworks-ai provider block into ~/.config/opencode/opencode.json:
  • An OpenAI-compatible adapter pointed at https://api.fireworks.ai/inference/v1
  • A default model set to fireworks-ai/<model-id> (for example, fireworks-ai/glm-fast-latest)
  • Your other providers are left untouched
FireConnect snapshots your original opencode.json before the first change. The snapshot lives in ~/.fireconnect/opencode/. Running fireconnect opencode off restores the file byte-for-byte.

​
API key handling

  • The API key is stored as {env:FIREWORKS_API_KEY} — never a literal in the config file
  • Keychain mode installs a shell profile hook that exports FIREWORKS_API_KEY="$(fireconnect key export)" when you launch OpenCode
  • OpenCode’s auth.json is never touched

​
Browsing and picking models

fireconnect opencode model list              # browse serverless endpoints
fireconnect opencode model select            # pick OpenCode's default model
fireconnect opencode model select --search glm
fireconnect opencode model list resolves the API key from the OS keychain or global config. Fire Pass keys (fpk_...) show Fire Pass-supported routers only.

​
CLI reference

fireconnect opencode on              # Enable Fireworks routing
fireconnect opencode off             # Restore original config
fireconnect opencode status          # Check current provider and model
fireconnect opencode model list      # Browse serverless endpoints
fireconnect opencode model select    # Pick a model interactively
fireconnect opencode model reset     # Reset model to default
fireconnect opencode help            # Show harness-specific help
Run fireconnect opencode help for all options.

​
Switch models

fireconnect opencode on --main glm-5p1

​
Turn off Fireworks routing

fireconnect opencode off
This restores your previous opencode.json from the backup in ~/.fireconnect/opencode/.

​
Use a non-default config file

fireconnect opencode on --config-path /path/to/opencode.json

​
Fireworks on Microsoft Foundry

OpenCode supports Fireworks on Microsoft Foundry (CLI: --provider azure or on --azure). See the FireConnect overview and Microsoft Foundry integration guide for portal setup.

​
Configure and enable

export AZURE_API_KEY=<your-azure-api-key>

fireconnect configure \
  --provider azure \
  --base-url https://<resource>.services.ai.azure.com \
  --api-key $AZURE_API_KEY

fireconnect opencode on --main FW-GLM-5.1
One-off routing without changing global config: 
fireconnect opencode on \
  --azure \
  --base-url https://<resource>.services.ai.azure.com \
  --main FW-MiniMax-M2.5
Pass your Foundry deployment name with --main — not a Fireworks serverless short ID like glm-latest.

​
What gets written

FireConnect adds a fireworks-azure provider labeled Fireworks on Microsoft Foundry to opencode.json, pointed at your Foundry OpenAI-compatible endpoint (.../openai/v1). The default model reference becomes fireworks-azure/<deployment-name>. fireconnect opencode model list and model select browse the Fireworks serverless catalog only. With Foundry, switch deployments with on --main <deployment-name>.

​
Turn off Foundry routing

To switch back to the Fireworks gateway, change the global provider and re-enable: 
fireconnect configure --provider fireworks
fireconnect opencode on
To remove FireConnect entirely and restore your original opencode.json: 
fireconnect opencode off
See Turn off Foundry routing for details on global config behavior and uninstall.

​
Built-in provider connection

OpenCode also supports connecting to Fireworks directly without FireConnect:
  1. Type /connect in OpenCode and search for fireworks.ai
  2. Paste your Fireworks API key and press Enter
  3. Type /models and select a model (for Fire Pass, choose a supported model such as GLM Fast Latest)

​
Source

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