Skip to main content
FireConnect is an open-source CLI that routes agentic coding harnesses through Fireworks AI models. Install once, then enable or disable Fireworks routing per harness without editing config files by hand.

Claude Code

Anthropic-compatible routing with multi-slot model aliases

OpenCode

OpenAI-compatible adapter in opencode.json

Codex

OpenAI Codex CLI via the Responses API

Pi

Pi agent settings and auth

​
Prerequisites

  • A Fireworks API key (fw_...) or a Fire Pass key (fpk_...)
  • Node.js (the installer can install it via Homebrew or apt if it is missing)
  • At least one supported harness installed locally

​
Install

curl -fsSL https://raw.githubusercontent.com/fw-ai/fireconnect/main/install.sh | bash
For non-interactive setup: 
curl -fsSL https://raw.githubusercontent.com/fw-ai/fireconnect/main/install.sh | FIREWORKS_API_KEY="fw_..." bash
Fire Pass users can pass a fpk_... key directly. FireConnect detects the key type and applies the correct defaults. The installer:
  • Clones the CLI to ~/.fireconnect/cli and adds a fireconnect launcher to ~/.local/bin
  • Runs fireconnect configure to register harnesses and store your API key preference
  • Uses Node.js to update harness settings (it does not install or update npm packages)
After install, enable a harness: 
fireconnect claude on      # Claude Code (default starting point)
fireconnect opencode on    # OpenCode
fireconnect codex on       # Codex
fireconnect pi on          # Pi

​
CLI design

FireConnect uses harness-first syntax: fireconnect <harness> <command> Bare harness names run on (for example, fireconnect claude is the same as fireconnect claude on).

​
Global commands

fireconnect configure    # Register harnesses and API key preferences
fireconnect uninstall    # Disable all harnesses, restore configs, remove CLI
fireconnect help         # Show help

​
Per-harness commands

Each harness (claude, opencode, codex, pi) supports:
  • fireconnect <harness> on — Route through Fireworks
  • fireconnect <harness> off — Restore your previous config
  • fireconnect <harness> status — Show provider, auth, and models
  • fireconnect <harness> model list — Browse serverless models
  • fireconnect <harness> model select — Pick a model interactively
  • fireconnect <harness> model reset — Reset models to defaults
  • fireconnect <harness> help — Harness-specific help
Run fireconnect help for the overview, or fireconnect claude help (and similarly for other harnesses) for harness-level options.

​
API key resolution

When a command needs your Fireworks key, FireConnect resolves it in this order:
  1. Explicit --api-key
  2. Harness-local stored key (for example, in ~/.claude/settings.json)
  3. Global ~/.fireconnect/config.json
  4. FIREWORKS_API_KEY environment variable
Short model IDs are accepted everywhere and expanded to full Fireworks paths automatically.
Short IDBest forNotes
glm-latestAll-around use, agentic tasksDefault for main and opus slots in Claude Code. Strong reasoning, 1M context.
glm-5p1General use (lighter)Default sonnet slot in Claude Code. Good balance of speed and quality.
minimax-m2p5Background / fast tasksDefault haiku and subagent slots in Claude Code. Lowest latency.

​
Fire Pass keys

Fire Pass keys (fpk_...) default all slots to glm-latest. The model browser shows Fire Pass-supported routers: glm-latest, kimi-fast-latest, and kimi-k2p7-code-fast.
Codex does not support Fire Pass keys yet. Use a standard Fireworks API key (fw_...) with Codex.

​
Migration from earlier syntax

FireConnect 0.5.0 moved to harness-first commands. If you have older docs or scripts, update them:
BeforeAfter
fireconnect onfireconnect claude on
fireconnect offfireconnect claude off
fireconnect statusfireconnect claude status
fireconnect listfireconnect claude status
fireconnect set --main <id>fireconnect claude on --main <id>
fireconnect resetfireconnect claude model reset
fireconnect on --harness opencodefireconnect opencode on
fireconnect model listfireconnect <harness> model list

​
Source

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