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.0.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.0-py3-none-any.whl (91.0 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: claude_anyteam-0.3.0.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.0.tar.gz
Algorithm Hash digest
SHA256 9e60b75cb49a5699a1c1000a39162ad8797b74858b37cb4e17e8f3faf2ebe48c
MD5 a23a09370042236c95b8bd8bd46b9edd
BLAKE2b-256 0807dfa1f460ce99f049b31b34ece98356f21b3f3c1d8663144220ef613fe844

See more details on using hashes here.

File details

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

File metadata

  • Download URL: claude_anyteam-0.3.0-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.0-py3-none-any.whl
Algorithm Hash digest
SHA256 51459656b6d1b5cf2d6aa2e5c069f43316619e9ac2a869d44f4efae71592af46
MD5 05d1c574168bc491a8189c27193a21c7
BLAKE2b-256 d9c1a4a2ea830c95a90c01131b3e616b0dac5da79cca20c3ca4a275db7dd99c0

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