cc-fleet

🚢 cc-fleet

🤖 Spawn any vendor LLM — DeepSeek · GLM · Qwen · Kimi · MiniMax … — as real Claude Code teammates or ⚡ one-shot subagents 🚀

---

Vendor workers are real Claude Code teammates — driven exactly like native ones — with the LLM backend swapped to any provider that exposes an Anthropic-compatible API. Your main session's own auth (OAuth subscription or API key) is untouched; vendor workers bill the vendor API key via apiKeyHelper, and the key never enters env, argv, or shell history.

cc-fleet is a small Go CLI plus one Claude Code skill. The CLI manages per-vendor profiles, dispatches API keys via apiKeyHelper, and spawns teammate sessions in tmux panes. The skill teaches Claude Code when to delegate work to those teammates.

Requirements

• Claude Code (the claude CLI) on your PATH.
• tmux — vendor teammates run in tmux panes.
• macOS or Linux, amd64 or arm64 — the tested platforms. Windows can in theory run the one-shot subagent mode, but it is untested.
• Teammate mode needs Claude Code's agent-teams enabled. Turn it on in your global ~/.claude/settings.json and restart Claude Code (cc-fleet also nudges you on first run):

  { "env": { "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1" } }
  

  The one-shot subagent mode and the interactive cc-fleet run work without it.

Quick Install

One-line (recommended)

curl -fsSL https://raw.githubusercontent.com/ethanhq/cc-fleet/main/install.sh | sh

Downloads the prebuilt binary, installs cc-fleet + the ccf alias, and adds the skill via the Claude Code plugin. Flags (after | sh -s --): --skill plugin|global|none, --scope user|project|local, --prefix DIR, --version vX.Y.Z.

npm

npm install -g @ethanhq/cc-fleet      # or run once: npx @ethanhq/cc-fleet

Binary only — also install the skill (see The skill) so Claude Code can use it.

go install

go install github.com/ethanhq/cc-fleet/cmd/cc-fleet@latest
ln -sf "$(go env GOPATH)/bin/cc-fleet" "$(go env GOPATH)/bin/ccf"   # optional ccf alias

Binary only — also install the skill (see The skill) so Claude Code can use it.

Prebuilt tarball — download from Releases:

tar -xzf cc-fleet-*.tar.gz && cd cc-fleet-*/ && ./install.sh

From source

git clone https://github.com/ethanhq/cc-fleet.git && cd cc-fleet && make install

[!NOTE] cc-fleet is a binary + a skill. The one-line installer and tarball set up both; npm, go install, and source install the binary only — add the skill via the plugin so Claude Code knows when to delegate to it.

Getting Started

Run cc-fleet (or the ccf alias) with no arguments to open the interactive TUI:

cc-fleet

In the TUI you register a vendor — give it a name, its Anthropic-compatible base URL, a models endpoint, a default model, and paste the API key. The key is written 0600 under ~/.config/cc-fleet/secrets/ and is never passed via argv or shell history.

The config tree is created automatically on first save, so there is no separate init step. The TUI also lists your vendors, lets you edit them, and manage multiple keys per vendor.

Press tab to switch to the Agent status board — it shows every live teammate grouped by session → team, with its vendor, model, pane, PID, health, and hidden state, plus a list of subagent jobs. From here you can hide (h) / show (s) a teammate pane or refresh (r).