https://jiajia.fun/qa/1b4897ce-claude-agent-sdk-codex-sdk%E7%9A%84%E4%B8%BB%E8%A6%81%E7%89%B9%E7%82%B9%E9%83%BD%E6%98%AF%E4%BB%80%E4%B9%88-%E8%BF%98%E6%9C%89%E5%88%AB%E7%9A%84%E5%87%BA%E8%89%B2harness%E4%B9%9F%E5%8F%AF%E4%BB%A5%E4%BB%8B%E7%BB%8D%E4%B8%80%E4%B8%8B

# Claude Agent SDK Codex SDK的主要特点都是什么 还有别的出色harness也可以介绍一下

两边我按官方文档核对过，先说最有用的差别：这两个 SDK 解决的根本不是同一类问题，不能只当成两个功能相近的选项来比较。Claude Agent SDK 就是把 Claude Code 本身打包成一个库，供你在 Python 或 TypeScript 里调用，运行在你自己的进程里，底层启动的是 Claude Code 二进制。所以你拿到的是完整的一套 agent loop：内置工具，包括读写文件、运行命令、搜索网页；hooks 可以在生命周期关键点上拦截，包括 PermissionRequest 和 PermissionDenied 这两个节点，自定义审批和审计都可以做在这里；subagents，v2.1.302 之后直接用 subagent\_type: fork 就能开；MCP 连接外部工具；权限分级，包括 disallowed\_tools 里写 Bash(rm \*) 这种粒度；session 的续接和分叉。它会自动从.claude/ 加载 skills、commands、memory 和 plugins，和你平时用 Claude Code 时的项目习惯保持一致。代价也写在文档里：只支持 Python 和 TypeScript，其他语言要用 CLI 子进程加 --output-format json。另外，第三方产品不能复用 claude.ai 的登录和额度，只能使用 API key；要做对外出售的产品，这条会直接影响你的计费和用户体系。Codex SDK 的做法正好相反，它不提供一个可编程的 agent 框架，只提供一个控制本地 Codex 的接口。TypeScript 版是 @openai/codex-sdk，要求 Node 18+；Python 版的 pip 包名为 openai-codex，需要 3.10+，底层通过 JSON-RPC 控制 codex app-server，还自带固定版本的 CLI 运行时。核心抽象是 thread：startThread、resumeThread、thread\_fork，可以接着历史跑，也可以分叉。沙箱有三档：read-only、workspace-write、full-access，可以按轮切换，比如整个线程用 workspace-write，最后单独跑一轮 review 用 read-only。它的官方定位写得很直白：接 CI/CD、内嵌到自家工具里，或者让你的 agent 驱动 Codex 干活。两个我比较在意、也容易踩的点。一是 Codex SDK 的 ExternalMessage，把外部系统拿来的内容显式标成「工具输出」，权限低于用户和开发者指令。看起来像细节，但这正是防 prompt 注入的正解：来源分层，而不是靠提示词喊「别听注入的话」。二是 Claude 这边的 hooks 把 PermissionRequest 和 PermissionDenied 做成了可编程节点，你可以在拒绝之后接着做审计记录、通知或者降级，这种确定性拦截比让模型自己判断要不要停靠得住。还要注意一个变化：codex mcp-server 这个命令和独立二进制已经移除，旧的集成都得改走 app server，网上的老教程还在教 mcp-server，照抄就会踩坑。至于拿这些 SDK 做产品，两条路分的很清楚。Claude 这边如果是托管，就让 Managed Agents 跑，会话在 Anthropic 云沙箱或者你自建沙箱里，它帮你跑 agent loop。OpenAI 对应的是 Agents API，跑的是开源的 Codex harness，帮你管编排、长任务会话和上下文压缩，还支持 openai\_hosted 沙箱或者远程 exec-server。其他出色的 harness，明确说的我只给你两个方向，不随意扩展。一个是 Codex harness 的源码本身：Agents API 的卖点就是它是开源的那套 Codex harness，想学「模型调用、工具、上下文怎么被协调」这条主逻辑，直接读代码比读任何介绍都强；OpenAI 还发过一篇《Unrolling the Codex agent loop》专门讲这个循环，另外那篇 Harness engineering 讲他们团队连跑五个月、手工一行代码没写的内部实验，包括把 app 做成每个 git worktree 都能起一份、把 Chrome DevTools Protocol 接进运行时这些做法，这篇我这轮没抓到正文，只能给你标题，内容别信我转述。另一个是 Claude Code 团队自己写的 harness 设计文档，讲他们怎么用动态 workflow 同时编排一堆 subagent，在 Agent SDK 文档的 Agent harness design 那页。还有一类你可以顺手看：MCP 两边的接入方式其实一样，都是把外部工具当协议端点接进来，不构成选型差异。真正要选的是你要「自己有 agent、让 Codex 当工具」，还是要「直接拿一整套 Claude Code 的行为」，前者选 Codex SDK，后者选 Claude Agent SDK。你是在做 CI 里的自动化，还是想在自家产品里嵌一个 coding agent？这两个场景给出的建议会不太一样。
