Skip to content
VS Code

claude octopus for VS Code

io.github.xiaolai/claude-octopus

Spawn multiple specialized Claude Code agents as MCP servers, each independently configured.

client:VS Code transport:stdio runtime:npm

Install claude octopus in VS Code

.vscode/mcp.json

{
  "inputs": [
    {
      "type": "promptString",
      "id": "anthropic-api-key",
      "description": "ANTHROPIC_API_KEY",
      "password": true
    },
    {
      "type": "promptString",
      "id": "claude-tool-name",
      "description": "CLAUDE_TOOL_NAME",
      "password": true
    },
    {
      "type": "promptString",
      "id": "claude-model",
      "description": "CLAUDE_MODEL",
      "password": true
    },
    {
      "type": "promptString",
      "id": "claude-permission-mode",
      "description": "CLAUDE_PERMISSION_MODE",
      "password": true
    },
    {
      "type": "promptString",
      "id": "claude-allowed-tools",
      "description": "CLAUDE_ALLOWED_TOOLS",
      "password": true
    },
    {
      "type": "promptString",
      "id": "claude-append-prompt",
      "description": "CLAUDE_APPEND_PROMPT",
      "password": true
    },
    {
      "type": "promptString",
      "id": "claude-factory-only",
      "description": "CLAUDE_FACTORY_ONLY",
      "password": true
    }
  ],
  "servers": {
    "claude-octopus": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "claude-octopus"
      ],
      "env": {
        "ANTHROPIC_API_KEY": "${input:anthropic-api-key}",
        "CLAUDE_TOOL_NAME": "${input:claude-tool-name}",
        "CLAUDE_MODEL": "${input:claude-model}",
        "CLAUDE_PERMISSION_MODE": "${input:claude-permission-mode}",
        "CLAUDE_ALLOWED_TOOLS": "${input:claude-allowed-tools}",
        "CLAUDE_APPEND_PROMPT": "${input:claude-append-prompt}",
        "CLAUDE_FACTORY_ONLY": "${input:claude-factory-only}"
      }
    }
  }
}

VS Code prompts for each input the first time the server starts, so no secret is written to the file. VS Code docs

claude octopus in other clients