1つの脳、多くの腕。

Claude Agent SDK をラップする MCP サーバーで、複数の特殊な Claude コード エージェントを実行できます。それぞれ独自のモデル、ツール、システム プロンプト、およびパーソナリティで MCP クライアントから実行できます。

なぜ

クロードコードは強力です。 しかし、一つのインスタンスは、同じようにすべてを行います。 場合によっては、ファイルのみを読み込み、strict code reviewer が必要です。 A テストライター デフォルトは TDD です。 Haikuのcheapクイックヘルパー。 A オパス上のディープワーナー.

Claude Octopusを使用すると、必要な限り多くのものをスピンすることができます。 同じバイナリ、異なる構成。 MCP クライアントの別のツールとして、それぞれが表示されます。

前提条件

• Node.js >= 18 -Claude Code — Claude Agent SDK は依存性としてバンドルされていますが、フードの下に Claude コードをスモールドするので、作業が必要です claude] CLI インストール -Anthropic API キー (ANTHROPIC_API_KEY) env var) またはアクティブなClaudeコード OAuthセッション

インストール

MCP クライアントにマッチする 3 つのパスを選択します。

##npm (最も直接)

##npx (インストール不要)

インストールを完全にスキップ — [.mcp.json] を参照し、クライアントは要求に応じて取得します(クイックスタート)。

##MCP レジストリ

Claude Octopus

One brain, many arms.

An MCP server that wraps the Claude Agent SDK, letting you run multiple specialized Claude Code agents — each with its own model, tools, system prompt, and personality — from any MCP client.

Why

Claude Code is powerful. But one instance does everything the same way. Sometimes you want a strict code reviewer that only reads files. A test writer that defaults to TDD. A cheap quick helper on Haiku. A deep thinker on Opus.

Claude Octopus lets you spin up as many of these as you need. Same binary, different configurations. Each one shows up as a separate tool in your MCP client.

Prerequisites

• Node.js >= 18
• Claude Code — the Claude Agent SDK is bundled as a dependency, but it spawns Claude Code under the hood, so you need a working claude CLI installation
• Anthropic API key (ANTHROPIC_API_KEY env var) or an active Claude Code OAuth session

Install

Three paths, pick whichever matches your MCP client.

npm (most direct)

npm install claude-octopus

npx (no install needed)

Skip the install entirely — reference claude-octopus@latest in your .mcp.json and the client will fetch on demand (see Quick Start below).

MCP Registry

The server is published to the MCP Registry under the name io.github.xiaolai/claude-octopus. Registry-aware MCP clients can resolve and install it by that name without touching npm directly.

Quick Start

The fastest way to get started:

npx claude-octopus init

This interactive wizard lets you pick a template, detects your MCP client, and writes the config for you.

Or add to your .mcp.json manually:

{
  "mcpServers": {
    "claude": {
      "command": "npx",
      "args": ["claude-octopus@latest"],
      "env": {
        "CLAUDE_PERMISSION_MODE": "bypassPermissions"
      }
    }
  }
}

This gives you six tools:

That’s it — you have Claude Code as a tool, with full workflow observability built in.

Multiple Agents

The real power is running several instances with different configurations:

{
  "mcpServers": {
    "code-reviewer": {
      "command": "npx",
      "args": ["claude-octopus@latest"],
      "env": {
        "CLAUDE_TOOL_NAME": "code_reviewer",