> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fireworks.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

> Route Claude Code, OpenCode, Codex, and Pi through Fireworks AI models

[FireConnect](https://github.com/fw-ai/fireconnect) is an open-source CLI that routes agentic coding harnesses through [Fireworks AI](https://fireworks.ai) models. Install once, then enable or disable Fireworks routing per harness without editing config files by hand.

<CardGroup cols={2}>
  <Card title="Claude Code" icon="terminal" href="/ecosystem/fireconnect/claude-code">
    Anthropic-compatible routing with multi-slot model aliases
  </Card>

  <Card title="OpenCode" icon="terminal" href="/ecosystem/fireconnect/opencode">
    OpenAI-compatible adapter in `opencode.json`
  </Card>

  <Card title="Codex" icon="terminal" href="/ecosystem/fireconnect/codex">
    OpenAI Codex CLI via the Responses API
  </Card>

  <Card title="Pi" icon="terminal" href="/ecosystem/fireconnect/pi">
    Pi agent settings and auth
  </Card>
</CardGroup>

## Prerequisites

* A [Fireworks API key](https://app.fireworks.ai/settings/users/api-keys) (`fw_...`) or a [Fire Pass](/firepass) 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

```bash theme={null}
curl -fsSL https://raw.githubusercontent.com/fw-ai/fireconnect/main/install.sh | bash
```

For non-interactive setup:

```bash theme={null}
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:

```bash theme={null}
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

```bash theme={null}
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

## Recommended models

Short model IDs are accepted everywhere and expanded to full Fireworks paths automatically.

| Short ID       | Best for                      | Notes                                                                             |
| -------------- | ----------------------------- | --------------------------------------------------------------------------------- |
| `glm-latest`   | All-around use, agentic tasks | Default for `main` and `opus` slots in Claude Code. Strong reasoning, 1M context. |
| `glm-5p1`      | General use (lighter)         | Default `sonnet` slot in Claude Code. Good balance of speed and quality.          |
| `minimax-m2p5` | Background / fast tasks       | Default `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`.

<Warning>
  Codex does not support Fire Pass keys yet. Use a standard Fireworks API key (`fw_...`) with Codex.
</Warning>

## Migration from earlier syntax

FireConnect 0.5.0 moved to harness-first commands. If you have older docs or scripts, update them:

| Before                              | After                               |
| ----------------------------------- | ----------------------------------- |
| `fireconnect on`                    | `fireconnect claude on`             |
| `fireconnect off`                   | `fireconnect claude off`            |
| `fireconnect status`                | `fireconnect claude status`         |
| `fireconnect list`                  | `fireconnect claude status`         |
| `fireconnect set --main <id>`       | `fireconnect claude on --main <id>` |
| `fireconnect reset`                 | `fireconnect claude model reset`    |
| `fireconnect on --harness opencode` | `fireconnect opencode on`           |
| `fireconnect model list`            | `fireconnect <harness> model list`  |

## Source

FireConnect is open source: [github.com/fw-ai/fireconnect](https://github.com/fw-ai/fireconnect)