Claude Agent SDK vs OpenAI Agents SDK：两大AI智能体框架深度对比

# Python 版本
from agents import Agent, Runner

agent = Agent(
    name="Assistant",
    instructions="你是一名助人为乐的助手。",
    model="gpt-4o",
    tools=[get_weather],
)

result = await Runner.run(agent, "今天北京天气如何？")
print(result.final_output)

// TypeScript 版本（@openai/agents）
import { Agent, run } from '@openai/agents';

const agent = new Agent({
  name: 'Assistant',
  instructions: '你是一名助人为乐的助手。',
  tools: [getWeatherTool],
});

const result = await run(agent, '今天北京天气如何？');
console.log(result.finalOutput);

# 模式一：简单查询（高级接口）
import asyncio
from claude_agent_sdk import query

async def main():
    async for message in query("分析这段代码的性能瓶颈"):
        print(message)

asyncio.run(main())

# 模式二：完整客户端（低级接口）
from claude_agent_sdk import ClaudeSDKClient, ClaudeAgentOptions

options = ClaudeAgentOptions(
    system_prompt="你是一个资深Python开发者。",
    permission_mode="accept_edits",
    read_write_tools=True,
    bash_tools=True,
    cwd="/path/to/project",
    max_cost=1.0,
)

client = ClaudeSDKClient(options=options)
# 支持双向交互式对话...

# 创建专业Agent
chinese_agent = Agent(
    name="中文客服",
    instructions="你只能用中文回复。",
    handoff_description="当用户使用中文时，交给该Agent。",
)

english_agent = Agent(
    name="English Support",
    instructions="You can only respond in English.",
    handoff_description="When user speaks English, hand off to this agent.",
)

# 分诊Agent负责路由
triage_agent = Agent(
    name="分诊Agent",
    instructions="根据用户语言将请求路由到合适的Agent。",
    handoffs=[chinese_agent, english_agent],
)

result = await Runner.run(triage_agent, "Hello, how are you?")

# 定义专家代理配置文件
name: Security Reviewer
description: Reviews code for security vulnerabilities
tools: [semgrep, codeql]
model: claude-sonnet-4-5

# Python — 装饰器 + 类型注解自动生成Schema
from agents import function_tool

@function_tool
def get_weather(city: str):
    """查询指定城市的天气信息"""
    return {"temp": 22, "condition": "晴"}

// TypeScript — tool() + Zod Schema 定义参数
import { z } from 'zod';
import { tool } from '@openai/agents';

const getWeatherTool = tool({
  name: 'get_weather',
  description: '查询指定城市的天气信息',
  parameters: z.object({ city: z.string() }),
  execute: async (input) => {
    return `The weather in ${input.city} is sunny`;
  },
});

from claude_agent_sdk import Tool, create_sdk_mcp_server

# @tool装饰器定义工具
greet_tool = Tool(
    name="greet",
    description="Greet a user by name.",
    inputSchema={
        "type": "object",
        "properties": {
            "name": {"type": "string", "description": "User's name"}
        },
        "required": ["name"]
    }
)

async def greet(name: str) -> str:
    return f"Hello, {name}!"

# 打包为In-Process MCP服务器
mcp_server = create_sdk_mcp_server(
    name="my_tools",
    version="1.0.0",
    tools=[greet_tool],
    tool_handlers={"greet": greet}
)

from agents import guardrail

@guardrail
def check_topic(input_text: str) -> bool:
    """检查输入是否偏离主题"""
    # 如果偏离主题返回False，触发拦截
    ...

@agent.hook("PreToolUse")
async def validate_tool(tool_name, params):
    """工具执行前拦截危险操作"""
    if tool_name == "delete_file" and "/system" in params["path"]:
        return {"action": "reject", "reason": "Protected path"}
    return {"action": "approve"}

@agent.hook("PostToolUse")
async def log_result(tool_name, result):
    """工具执行后审计记录"""
    await log_to_datadog(tool_name, result)

@agent.hook("Stop")
async def cleanup():
    """会话结束时资源释放"""
    await close_database_connections()

# 流式数据以JSONL格式存储，记录AI思考的每一个瞬间
options = ClaudeAgentOptions(
    log_level="INFO",
    audit_log_path="/var/log/claude_agent.log"
)

# OpenAI Agents SDK (Python) — Hello World（4行代码）
from agents import Agent, Runner

agent = Agent(name="Greeter", instructions="Say hello!")
result = Runner.run_sync(agent, "Hi!")
print(result.final_output)

// OpenAI Agents SDK (TypeScript) — Hello World（同样简洁）
import { Agent, run } from '@openai/agents';

const agent = new Agent({ name: 'Greeter', instructions: 'Say hello!' });
const result = await run(agent, 'Hi!');
console.log(result.finalOutput);

# Claude Agent SDK — Hello World（5行代码）
import asyncio
from claude_agent_sdk import query

async def main():
    async for message in query("Hello!"):
        print(message)

asyncio.run(main())