> ## Documentation Index
> Fetch the complete documentation index at: https://fireworks.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Overview
> Route Claude Code, OpenCode, Codex, Pi, Cursor, VS Code, and Deep Agents through Fireworks AI or Microsoft Foundry models
[FireConnect](https://github.com/fw-ai/fireconnect) is an open-source CLI that routes agentic coding harnesses through Fireworks models. Install once, sign in once, then flip any supported harness on or off without hand-editing config files.
Choose where inference runs:
* **Direct Fireworks routing** (default): the [Fireworks gateway](https://fireworks.ai). Sign in with `fireconnect login` or use a Fireworks API key (`fw_...`) or [Fire Pass](/docs/firepass) key (`fpk_...`).
* **Fireworks on Microsoft Foundry**: models in your Azure subscription, billed through Azure. See [Microsoft Foundry](/docs/ecosystem/fireconnect/microsoft-foundry).
New here? Install and sign in below, then open the [harness guide](#choose-your-harness) for the tool you use. Try the [side-by-side demo](/docs/ecosystem/fireconnect/demo) if you want to compare before switching.
## Prerequisites
* A [Fireworks API key](https://app.fireworks.ai/settings/users/api-keys) (`fw_...`) or [Fire Pass](/docs/firepass) key (`fpk_...`) for direct routing
* For Foundry: Azure resource, API key, and deployment. See [portal setup](/docs/ecosystem/integrations/azure-foundry).
* Node.js 18+
* At least one supported harness installed locally
## Install
```bash theme={null}
curl -fsSL https://raw.githubusercontent.com/fw-ai/fireconnect/main/install.sh | bash
fireconnect login
```
The installer clones the CLI to `~/.fireconnect/cli`, installs dependencies, and adds `~/.local/bin/fireconnect`. It does **not** sign you in or write harness settings.
After `login`, open your [harness guide](#choose-your-harness) and run `fireconnect on`. You can also pass `--api-key` or set `FIREWORKS_API_KEY` instead of `login`.
### Upgrade FireConnect
```bash theme={null}
fireconnect upgrade
```
Or re-run the install curl above. On v0.9.0+, your harness stays connected; no need to run `off` first.
Check the installed version with `fireconnect --version`. For older releases and CLI renames, see [CLI reference: Migration](/docs/ecosystem/fireconnect/cli-reference#migration-from-earlier-syntax).
## Sign in
```bash theme={null}
fireconnect login # browser sign-in or paste a key
fireconnect logout # clear stored credentials
fireconnect status # sign-in state and key storage
```
Fire Pass keys (`fpk_...`) work during `login` or `on`. FireConnect detects the key type and applies the correct defaults.
See [CLI reference: Sign in options](/docs/ecosystem/fireconnect/cli-reference#sign-in-options) for `--with-token`, `--account`, `logout --revoke`, and `configure`.
## Choose your harness
After install and sign-in, open the guide for the tool you use. Each page covers `on` / `off`, models, and harness-specific notes.
Six model slots + interactive wizard
OpenAI-compatible adapter in `opencode.json`
OpenAI Codex CLI via the Responses API
Pi agent settings and auth
OpenAI BYOK settings for Cursor IDE
GitHub Copilot Chat custom endpoint
LangChain Deep Agents Code (`dcode`)
## Models
```bash theme={null}
fireconnect model list --search glm
fireconnect on --model glm-fast-latest
# Cursor / VS Code: quit before on; others: restart after
```
`` is one of: `claude`, `opencode`, `codex`, `pi`, `cursor`, `vscode`, `deepagents`. Full walkthrough: **[Models](/docs/ecosystem/fireconnect/models)**.
## Harness support
| Harness | Fireworks gateway | Fire Pass | Microsoft Foundry | [FireRouter](/docs/ecosystem/firerouter/overview) | Guide |
| ----------- | :---------------: | :-------: | :---------------: | :------------------------------------------: | ------------------------------------------------- |
| Claude Code | Yes | Yes | No | Yes | [Claude Code](/docs/ecosystem/fireconnect/claude-code) |
| OpenCode | Yes | Yes | Yes | Yes | [OpenCode](/docs/ecosystem/fireconnect/opencode) |
| Codex | Yes | No | Yes | Yes | [Codex](/docs/ecosystem/fireconnect/codex) |
| Pi | Yes | Yes | Yes | Yes | [Pi](/docs/ecosystem/fireconnect/pi) |
| Cursor | Yes | Yes | Yes | Workspace BYOK | [Cursor](/docs/ecosystem/fireconnect/cursor) |
| VS Code | Yes | Yes | Yes | Yes | [VS Code](/docs/ecosystem/fireconnect/vscode) |
| Deep Agents | Yes | Yes | Yes | Workspace BYOK | [Deep Agents](/docs/ecosystem/fireconnect/deepagents) |
**Notes**
* **Foundry**: not on Claude Code yet.
* **Fire Pass**: not on Codex or Foundry. FireConnect rejects `--model firerouter` with a Fire Pass (`fpk_...`) key on **every** harness; use an `fw_...` account key for FireRouter.
* **FireRouter**: Cursor and Deep Agents need workspace BYOK.
* **Web search MCP**: any harness via HTTP MCP; FireConnect auto-install is Claude Code only today. See [WebSearch MCP](/docs/ecosystem/fireconnect/websearch-mcp).
* **Cursor / VS Code**: quit the IDE before `on` or `off`. `status` is read-only.
## FireRouter
[FireRouter](/docs/ecosystem/firerouter/overview) automatically routes simple requests to cheaper open models and hard requests to Claude Opus 4.8. In FireConnect, select it like any other model:
```bash theme={null}
fireconnect on --model firerouter
```
Requires a standard Fireworks key (`fw_...`), not Fire Pass. Cursor and Deep Agents also need workspace BYOK. See the [FireRouter overview](/docs/ecosystem/firerouter/overview#fireconnect) and [Harness support](#harness-support).
## Source
FireConnect is open source: [github.com/fw-ai/fireconnect](https://github.com/fw-ai/fireconnect)
## See also
* [CLI reference](/docs/ecosystem/fireconnect/cli-reference)
* [Microsoft Foundry](/docs/ecosystem/fireconnect/microsoft-foundry)
* [WebSearch MCP](/docs/ecosystem/fireconnect/websearch-mcp)
* [Side-by-side demo](/docs/ecosystem/fireconnect/demo)