Claude Agent SDK vs OpenAI Agents SDK 比較

// Claude Agent SDK (TypeScript) - ファイルベースのsubagent + MCPツール制限
// 出典: docs.claude.com/en/api/agent-sdk/subagents + /mcp
import { query } from "@anthropic-ai/claude-agent-sdk";

const result = query({
  prompt: "リポジトリ内の失敗しているテストを見つけて修正して",
  options: {
    // プログラムによるsubagent定義 — ファイルベースの代替: .claude/agents/*.md
    agents: {
      "test-fixer": {
        description: "失敗したテストを分析して修正します",
        prompt: "あなたはテストエンジニアです。まずテストを実行し、次に根本原因を特定してください。",
        tools: ["Read", "Edit", "Bash"], // ツール制限
      },
    },
    // MCPサーバー: ローカルプロセスとして接続
    mcpServers: {
      github: {
        command: "npx",
        args: ["-y", "@modelcontextprotocol/server-github"],
      },
    },
    permissionMode: "default", // hooks + deny/ask/allowの順序が適用される
  },
});

for await (const message of result) {
  if (message.type === "result") {
    console.log("合計コスト:", message.total_cost_usd);
    console.log("モデル使用状況:", message.modelUsage);
  }
}

# OpenAI Agents SDK (Python) - Handoff + guardrail + MCP (stdio)
# 出典: openai.github.io/openai-agents-python/multi_agent/ + /mcp/ + /guardrails/
from agents import Agent, Runner, handoff, input_guardrail, GuardrailFunctionOutput
from agents.mcp import MCPServerStdio

async def main():
    async with MCPServerStdio(
        params={"command": "npx", "args": ["-y", "@modelcontextprotocol/server-github"]},
    ) as github_mcp:

        @input_guardrail
        async def block_secrets(ctx, agent, input_text: str) -> GuardrailFunctionOutput:
            contains_secret = "sk-" in input_text
            return GuardrailFunctionOutput(
                output_info={"blocked": contains_secret},
                tripwire_triggered=contains_secret,
            )

        triage_agent = Agent(
            name="Triage",
            instructions="タスクを分析し、適切な専門エージェントに引き継いでください。",
            input_guardrails=[block_secrets],
        )

        fixer_agent = Agent(
            name="TestFixer",
            instructions="失敗したテストを修正してください。",
            mcp_servers=[github_mcp],
        )

        triage_agent.handoffs = [handoff(fixer_agent)]

        result = await Runner.run(triage_agent, "リポジトリ内の失敗しているテストを修正して")
        print(result.final_output)