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"], // tool restriction
      },
    },
    // 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="分析任务，并移交给合适的专家 Agent。",
            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)