1개의 뇌, 많은 팔.

Claude Agent SDK를 감싸는 MCP 서버는 여러 전문 Claude Code Agent를 실행할 수 있게 합니다. 각 모델, 도구, 시스템 프롬프트, 그리고 개성을 모두 갖춘 MCP 클라이언트입니다.

왜

Claude Code는 강력합니다. 하지만 1개의 인스턴스는 모두 같은 방법이 있습니다. 때때로 당신은strict code reviewer 파일을 읽는 것. A ** 시험 작가 ** 기본적으로 TDD. Acheap Quick helper 에 Haiku. A ** 깊은 생각자 ** Opus에.

Claude Octopus는 당신이 필요로 한대로 많은 회전 할 수 있습니다. 같은 바이너리, 다른 구성. 각 하나는 MCP 클라이언트에서 별도의 도구로 보여줍니다.

필수품

• Node.js >= 18
• Claude Code - Claude Agent SDK는 의존성으로 번들하지만, 후드 아래에 스팸 클로드 코드가 필요합니다. claude CLI 설치
• **Anthropic API 키 ** (ANTHROPIC_API_KEY env var) 또는 활성 클로드 코드 OAuth 세션

설치

3개의 경로, MCP 클라이언트에 어떤 일치든지 선택합니다.

npm (최대 직접)

npx (설치 필요 없음)

완전히 설치를 건너 - 참조 claude-octopus@latest] 당신의 .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",