fw-ai/fireconnect

fw-ai/fireconnect

Description: Fireconnect connects Claude Code to Fireworks models.

Language: JavaScript

License: Apache-2.0

Stars: 1

Forks: 1

Open issues: 1

Created: 2026-05-11T16:16:24Z

Pushed: 2026-06-10T01:17:52Z

Default branch: main

Fork: no

Archived: no

README:

FireConnect

> Route Claude Code model calls through Fireworks AI.

Install in one line:

sh -c "$(curl -fsSL https://raw.githubusercontent.com/fw-ai/fireconnect/main/install.sh)"

Or with bash directly:

curl -fsSL https://raw.githubusercontent.com/fw-ai/fireconnect/main/install.sh | bash

This repository contains a Claude Code plugin marketplace and setup CLIs for using Fireworks models through Claude Code's Anthropic-compatible settings.

Plugin vs Marketplace

A plugin is the installable unit. It is a directory that contains Claude Code components such as skills, agents, hooks, or scripts. In this repo, plugins/fireconnect is the plugin.

A marketplace is the catalog. It points Claude Code at one or more plugins and tells users where to install them from. In this repo, .claude-plugin/marketplace.json is the marketplace catalog.

In short: users add a marketplace, then install a plugin from it.

Marketplace = app store catalog
Plugin = app listed in that catalog

Quick Setup

Run this from a terminal:

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

If you prefer installing from an SSH checkout:

mkdir -p ~/.fireconnect && git clone git@github.com:fw-ai/fireconnect.git ~/.fireconnect && bash ~/.fireconnect/install.sh

The installer:

• Requires the Claude Code CLI on your PATH (install it yourself first; FireConnect does not install or change your Claude version).
• Uses Node.js to update Claude Code settings. If Node.js is missing, asks before installing it with Homebrew or apt. It does not install or update npm packages.
• Points you to the Fireworks API key page and prompts once for your Fireworks API key.
• Adds or updates the Claude Code plugin marketplace from the canonical FireConnect Git source, or from a stable local copy under ~/.fireconnect/ when installing via curl | bash.
• Installs or updates the FireConnect plugin.
• Applies the default model mapping.
• Writes Claude Code settings.

Install Claude Code before running the installer:

https://docs.anthropic.com/en/docs/claude-code

Then fully restart Claude Code and test with:

hi

Default models:

opus -> kimi-k2p6-turbo
sonnet -> glm-5p1
haiku -> minimax-m2p5
subagent -> minimax-m2p5

Manual Setup

From Claude Code:

/plugin marketplace add https://github.com/fw-ai/fireconnect.git
/plugin install fireconnect@fireconnect

If an older install registered a marketplace source under /tmp, rerun the installer to replace it with a durable source before using /fireconnect:on or /fireconnect:off after a reboot.

Create a Fireworks API key here:

https://app.fireworks.ai/settings/users/api-keys

Paste it into Claude Code when the plugin asks for it, accept the default base URL, then restart Claude Code.

What Gets Written

The setup writes these Claude Code settings:

{
"env": {
"ANTHROPIC_BASE_URL": "https://api.fireworks.ai/inference",
"ANTHROPIC_API_KEY": "fw_YOUR_FIREWORKS_API_KEY",
"ANTHROPIC_AUTH_TOKEN": "fw_YOUR_FIREWORKS_API_KEY",
"ANTHROPIC_MODEL": "accounts/fireworks/routers/kimi-k2p6-turbo",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "accounts/fireworks/routers/kimi-k2p6-turbo",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "accounts/fireworks/models/glm-5p1",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "accounts/fireworks/models/minimax-m2p5",
"CLAUDE_CODE_SUBAGENT_MODEL": "accounts/fireworks/models/minimax-m2p5"
}
}

The current Claude Code model config docs deprecate ANTHROPIC_SMALL_FAST_MODEL in favor of ANTHROPIC_DEFAULT_HAIKU_MODEL. The CLI still accepts --small-fast-model as a compatibility alias and writes the deprecated variable only when that flag is used. The setup writes both ANTHROPIC_API_KEY (preferred) and ANTHROPIC_AUTH_TOKEN (compatibility alias) with the same Fireworks key.

Additional model config flags:

node packages/setup-cli/bin/fireconnect-setup.mjs \
--api-key "$FIREWORKS_API_KEY" \
--model "kimi-k2p6-turbo" \
--opus-model "kimi-k2p6-turbo" \
--sonnet-model "glm-5p1" \
--haiku-model "minimax-m2p5" \
--subagent-model "minimax-m2p5" \
--custom-model-option "kimi-k2p6-turbo" \
--custom-model-option-name "Kimi K2.6 Turbo via Fireworks" \
--custom-model-option-capabilities "thinking,interleaved_thinking" \
--effort-level high \
--yes

It preserves unrelated settings and writes a timestamped backup when an existing settings file is present.

Short model IDs are accepted everywhere. For example, kimi-k2p6-turbo is written to Claude Code settings as accounts/fireworks/routers/kimi-k2p6-turbo.

FireConnect CLI for Repo + Terminal Recovery

Use this when Claude Code cannot run /fireconnect:* commands and you need to recover routing from a terminal.

node packages/setup-cli/bin/fireconnect.mjs help
node packages/setup-cli/bin/fireconnect-setup.mjs --help

Main commands:

fireconnect list
fireconnect status
fireconnect set --main kimi-k2p6-turbo --haiku minimax-m2p5
fireconnect on --api-key fw_...
fireconnect off
fireconnect uninstall
fireconnect reset

CLI options:

Global:
--json
--home
--settings-path
--plugin-data-dir

Model:
--main|--model
--opus
--sonnet
--haiku
--subagent

Provider:
--api-key
--base-url

The plugin provides:

• /fireconnect:on
• /fireconnect:off
• /fireconnect:setup
• /fireconnect:models
• /fireconnect:set-models

Use /fireconnect:on to route Claude Code model calls through Fireworks. Use /fireconnect:off to remove Fireworks routing and restore previous provider environment variables when a backup is available.