Native Claude Code teammates, any LLM.
Codex today. Gemini, Kimi, GLM, DeepSeek next — on the same team-native architecture.
Quickstart · Architecture · Roadmap
What it is
Claude Code's Agent Teams feature is built for multi-agent collaboration — but every teammate is a Claude instance. claude-anyteam makes it possible for any external model to join the same team, with the same native UX, without wrapping it inside a Claude LLM.
Your Claude Code session orchestrates. External models execute. No chat-wrapper overhead. No "Claude pretending to be Codex." Real models, real teammates.
Quickstart
npx --yes claude-anyteam
That's the entire install. The installer:
- Detects
python3and installsuvif missing (non-interactive, no shell profile edits) - Installs the
claude-anyteamPython tool viauv tool install - Runs
claude-anyteam install(verifies tmux/psmux, writes~/.claude/settings.json+~/.claude.json, records install-state for symmetric uninstall)
Restart Claude Code, enable Agent Teams mode, and create a teammate named codex-<anything>:
codex-alice → routed to claude-anyteam + Codex
codex-reviewer → routed to claude-anyteam + Codex
alice → native Claude (unchanged)
Codex-prefixed names appear in your TUI presence line exactly like native teammates. Single-terminal mode or tmux — both work.
Why it feels native
|
Real teammate protocol Not a chat wrapper. The adapter speaks Claude Code's agent-team protocol directly: mailbox I/O, atomic task claims, idle notifications, shutdown lifecycle. A Codex teammate is functionally indistinguishable from a native Claude teammate. |
Mid-task reactivity When a peer messages a working teammate, the adapter injects the message mid-turn via Codex's |
|
Cross-task memory Each new task forks from the previous task's Codex thread via |
Battle-tested parity 202 passing tests. Ten parity bugs caught by a live 4-teammate hunt (mixed Claude + Codex) and fixed. Zero accepted limitations on the protocol layer. |
Supported today / Coming next
| Supported today | Coming next |
|---|---|
✅ Codex via codex-cli (0.120+) |
⏳ Gemini CLI adapter |
| ✅ gpt-5.5 / gpt-5.4 / gpt-5.3-codex, configurable effort | ⏳ Kimi adapter |
| ✅ App Server mode (mid-task steer) | ⏳ GLM adapter |
✅ Fresh-exec mode (codex exec resume) |
⏳ DeepSeek adapter |
| ✅ Claude Code hook + TUI presence | ⏳ Pluggable backend routing |
| ✅ Opt-in structured plan mode | ⏳ Generic CLI adapter template |
Codex is shipping. Everything in "coming next" is on the same architectural surface — each new model is a new adapter binary + one line in the spawn shim's routing table. See docs/roadmap.md.
Requirements
- Python 3.12+
- Node 18+ (for the npm installer; not required at runtime)
- OpenAI Codex CLI 0.120+ on PATH
- Claude Code 2.1+ with Agent Teams mode
- Terminal multiplexer on PATH (tmux or psmux) — see configuration.md
Docs
- Install — how the installer wires Claude Code, alternative install methods, headless launches
- Architecture — how the adapter integrates with Claude Code's team protocol
- Roadmap — supported today vs coming next, contribution pointers
- Configuration — CLI flags, env vars, advanced modes
- Releasing — maintainer-facing tag-triggered publish flow
License
MIT