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 spawning a mixed Codex + Claude team

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.

claude-anyteam architecture

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, probes for the OpenAI Codex CLI and warns if it's missing or below 0.120, 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.2.tar.gz (12.1 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.2-py3-none-any.whl (93.0 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: claude_anyteam-0.3.2.tar.gz
  • Upload date:
  • Size: 12.1 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.2.tar.gz
Algorithm Hash digest
SHA256 d760ff0ad114f9ef684714cdfdaaea0de3922b277c1a867100af5091fbafc17e
MD5 ba9d4386909042500cd6487f6c7746e1
BLAKE2b-256 5604730917783679d99028c29cb22ea643580f02e61716702a07280fc85a1918

See more details on using hashes here.

File details

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

File metadata

  • Download URL: claude_anyteam-0.3.2-py3-none-any.whl
  • Upload date:
  • Size: 93.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.2-py3-none-any.whl
Algorithm Hash digest
SHA256 7ff501d0da90a2857f8e37a0e3b92db5a4adcd22df9b2c8d9ba0fed085f4ccdc
MD5 6d97325472f87dc9da0421a416de670d
BLAKE2b-256 9c58397e9e2681ada177907faab22952c66bb61bf2d03564b1b9f4896b8568b5

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