Claude Code API 文档在哪里？
解释 Claude Code CLI、Agent SDK、Claude API 文档的区别，以及自动化场景该看哪套官方文档。
“Claude Code API”这个说法容易混淆。你真正需要看的文档，取决于你是在用 CLI、Agent SDK，还是直接调用 Claude API。
最后核查：2026 年 5 月 24 日。Claude Code SDK 已经重组为 Claude Agent SDK，旧包名和旧链接可能过时。
短答案
- CLI、安装、认证、权限、MCP、memory、编辑器集成，看 Claude Code docs。
- 程序化 agent、session、tools、skills、hooks、MCP，看 Agent SDK docs。
- 直接模型调用、Messages API、价格、rate limits、prompt caching、batch，看 Claude API docs。
应该打开哪套文档
| 你想做什么 | 看哪套文档 | 原因 |
|---|---|---|
安装或运行 claude | Claude Code setup 和 CLI reference | 这是终端产品。 |
| 做一次性 CLI 自动化 | Claude Code CLI reference | claude -p、output format、permission flags 都在这里。 |
| 构建带 Claude Code 能力的程序化 agent | Agent SDK docs | SDK 处理 tools、sessions、MCP、skills 和 agent 工作流。 |
| 直接调用模型 | Claude API docs | 你要自己处理 tool loop、上下文和计费。 |
| 查价格和 rate limits | Claude pricing 和 API docs | 价格、token 计费、供应商限制属于平台层。 |
| 配置项目行为 | Memory、skills、hooks、settings docs | 这些决定 Claude Code 如何读项目上下文。 |
CLI、Agent SDK、Claude API 区别
| Surface | 适合 | 你需要管理 |
|---|---|---|
| Claude Code CLI | 本地交互开发、终端工作流、快速自动化。 | 仓库状态、权限、凭据、本地工具。 |
claude -p | 简单脚本和 CI 检查。 | 输出解析、凭据、allowed tools、失败处理。 |
| Agent SDK | 产品化 agent、长 session、结构化工作流。 | 托管、sandbox、审批、工具策略、session 生命周期。 |
| Claude API | 自己应用里的直接模型调用。 | tool loop、prompt、上下文、rate limits、重试和计费。 |
文档地图
- CLI 相关问题先看 Claude Code docs。
- 参数问题看 CLI reference，包括
--print、--output-format、--permission-mode、--allowedTools。 - 程序化 agent 看 Agent SDK overview。
- 想在 SDK 里复用
CLAUDE.md、skills、hooks 或 settings，看 Use Claude Code features in the SDK。 - 生产自动化前看 Claude API pricing 和 rate limits。
常见误区
| 误区 | 正确理解 |
|---|---|
| “Claude Code API” | 可能指 claude -p、Agent SDK 或 Claude API，先明确 surface。 |
| “Pro 账号能不能跑脚本” | 有些 Claude Code 订阅流程可用，但 API key 自动化会走不同计费路径。 |
| “接 API 是否必须 MCP” | 不一定。MCP 是工具连接协议，直接 API 可能更简单。 |
| “SDK 能不能程序化注册 skills” | Skills 是文件系统 artifact，通过 SDK setting sources 加载。 |