Skip to main content

Bring Codex-powered teammates into Claude Code today, with the claude-anyteam adapter built for multi-model expansion.

Project description

claude-anyteam

Native Claude Code teammates, any LLM.

Codex today. Gemini, Kimi, GLM, DeepSeek next — on the same team-native architecture.

License Python Node Codex Tests

Quickstart · Architecture · Roadmap

claude-anyteam architecture

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 python3 and installs uv if missing (non-interactive, no shell profile edits)
  • Installs the claude-anyteam Python tool via uv 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 turn/steer App Server call. Codex reshapes the in-flight turn instead of discarding it. v7.1.

Cross-task memory

Each new task forks from the previous task's Codex thread via thread/fork. The teammate carries its own conversational context forward across the team's task list. v7.3.

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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

claude_anyteam-0.3.1.tar.gz (2.4 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

claude_anyteam-0.3.1-py3-none-any.whl (91.0 kB view details)

Uploaded Python 3

File details

Details for the file claude_anyteam-0.3.1.tar.gz.

File metadata

  • Download URL: claude_anyteam-0.3.1.tar.gz
  • Upload date:
  • Size: 2.4 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.11.7 {"installer":{"name":"uv","version":"0.11.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for claude_anyteam-0.3.1.tar.gz
Algorithm Hash digest
SHA256 b0595c68299ae2e93c4cc7414a84c0cc7d5c555c0b23b1ee2a5c355fea7454e5
MD5 9ce7f601d6a7ebf0a9a9890ba8e4b299
BLAKE2b-256 feca2696cb3e0ed7c56de4eae0ab0946da4cddcb3c94c11730a1d7a2cf38a145

See more details on using hashes here.

File details

Details for the file claude_anyteam-0.3.1-py3-none-any.whl.

File metadata

  • Download URL: claude_anyteam-0.3.1-py3-none-any.whl
  • Upload date:
  • Size: 91.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.11.7 {"installer":{"name":"uv","version":"0.11.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for claude_anyteam-0.3.1-py3-none-any.whl
Algorithm Hash digest
SHA256 f4df9fc2d572dbd03827a619f0e9d169640947827d1abc823a71de7e4be36d04
MD5 54f936eb04cc4177c38c2b698f1c2e28
BLAKE2b-256 12701a1b9ec47ecd8a11201aa8edc3c24a87fcd64c3de25ec6543959747728b4

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page