ClaudeCode101ClaudeCode101
Faqs

Claude Code API 文档在哪里？

找到正确的 Claude Code API 文档入口：Anthropic API、Claude Code CLI、claude -p、Agent SDK、MCP、Managed Agents、认证和自动化。

如果你在找 “Claude Code API 文档”，先要确认你说的是哪一层。Claude Code 是 CLI 和 agentic coding 工作流；Claude API 才是在你自己的应用里调用模型的平台 API。 你需要的文档取决于你要找模型 endpoint、终端自动化、可编程 agent，还是外部工具集成。

最后核查：2026 年 5 月 24 日。Claude Code 和 Claude Platform 文档变化很快。这个 FAQ 是文档分流入口；生产上线前，请到官方文档重新核对 endpoint、CLI flags、SDK 语法、认证规则、价格和限制。

短答案

不存在一页覆盖所有场景的“Claude Code API”。

你的意思是应该打开原因
“我要在应用里调用 Claude。”Anthropic API docs 和 API referenceMessages API、模型、streaming、tool use、rate limits 和 SDK 都在这里。
“我要从脚本里运行 Claude Code。”Claude Code CLI reference覆盖 claude、claude -p、output formats、auth、update 和 CLI flags。
“我要用 Python 或 TypeScript 写 coding agent。”Claude Agent SDK提供 Claude Code-style tools、sessions、MCP、hooks、permissions 和 agent loop。
“我要让 Claude Code 接 GitHub、文档、浏览器、数据库或内部系统。”MCP docsMCP 是工具和数据源集成层。
“我要托管 agent 服务。”Claude Platform docsManaged Agents 是托管平台能力，不是本地 CLI。

最稳的理解方式是：Claude API 管模型调用，Claude Code CLI 管终端工作流，Agent SDK 管可编程 agent，MCP 管外部工具。

CLI、Agent SDK、Claude API 区别

Surface适合什么你需要管理
Claude Code CLI本地交互开发、仓库任务、代码编辑、终端工作流。仓库状态、审批、本地凭据、工具权限。
claude -p一次性脚本、CI 摘要、非交互式检查。prompt 范围、输出解析、认证、allowed tools、失败行为。
Claude Agent SDK产品化 agent、自定义自动化、长 session、程序化审批。托管、sandbox、key、可观测性、工具策略、session 生命周期。
Anthropic API / client SDKs自己产品里的直接模型调用。prompt、会话状态、tool loop、重试、rate limits、计费、UI。
Managed AgentsAnthropic 托管基础设施上的 autonomous agents。agent 定义、事件、产品集成、治理。

不要把这些文档混在一起用。Claude Code CLI 的 flag 不是 HTTP endpoint；Messages API 的请求体不是 Agent SDK 的 session config；MCP server 也不是 Claude 模型 API。

常见搜索意图

“Claude Code API reference”

你大概率需要二选一：

如果需要完整分流入口，看 Claude Code API 文档。

“Claude Code API docs”

如果问题和安装、登录、运行 claude、claude -p、MCP、权限有关，看 Claude Code docs。如果问题和 messages.create、model ID、streaming、prompt caching、tool use、API error 有关，看 Claude Platform docs。

“Claude Code SDK”

旧页面可能写 “Claude Code SDK”，但当前官方文档把它整理为 Claude Agent SDK。当你要用 Python 或 TypeScript 写一个能读文件、执行命令、编辑代码、使用 MCP、hooks 和权限的 agent 时，看 Agent SDK。

“Claude Code headless API”

一次性非交互任务可以从这里开始：

claude -p "Summarize this pull request and list release risks"

结构化自动化可以这样写：

claude -p "Review this diff and return the top risks" \
  --output-format json \
  --permission-mode plan

如果要做生产级 agent，不要让 shell 脚本无限膨胀，应该转向 Agent SDK。

文档地图

任务最适合入口
安装 Claude Code如何安装 Claude Code
查看 CLI flagsClaude Code CLI reference
运行非交互式 promptHeadless Mode 教程
用 SDK 构建 agentClaude Agent SDK
在应用里调用 Claude 模型Anthropic API docs
查精确 HTTP endpointAnthropic API reference
添加工具集成Claude Code MCP docs
配置权限Tools allowlist
控制项目行为CLAUDE.md 配置
估算成本和限制Claude Code 价格和限制

认证规则

不同 surface 的认证不一样：

Surface常见认证方式注意点
Anthropic APIConsole 里的 ANTHROPIC_API_KEY适合生产应用和后端服务。
Claude Code CLI官方支持的 Claude Code 登录或 Console/API billing flow适合本地开发和终端工作流。
claude -p默认沿用 CLI 认证上下文，除非另行配置CI 里要显式处理凭据和权限边界。
Agent SDKAPI key 或受支持 provider 凭据不要围绕个人交互式登录构建客户产品。
MCP取决于每个外部 server连接前检查 scope、secret 和 prompt injection 风险。

生产自动化优先使用明确的 API key 或 provider 凭据，设置 spend limit，并确保 secret 不进入 prompt、日志、CLAUDE.md 和仓库文件。

常见错误

错误更好的做法
把 ClaudeCode101 当 endpoint reference。本站只做分流和教程，字段以官方文档为准。
找一个单独的 “Claude Code API endpoint”。先判断你需要 API、CLI、SDK 还是 MCP。
用 claude -p 承担复杂产品工作流。CLI 先原型验证，稳定后迁移到 Agent SDK。
一行 PR 摘要也上 Agent SDK。先用 claude -p。
简单 API 调用也强行加 MCP。只有外部上下文反复成为瓶颈时再加 MCP。
headless 自动化没有预算和权限限制。设置窄权限、turn limit、日志和成本控制。

迷你决策树

  1. 是在自己的应用里调用 Claude 吗？ 用 Anthropic API docs 和 client SDKs。

  2. 是让 Claude Code 在本地仓库里工作吗？ 用 Claude Code CLI docs。

  3. 是一个运行一次就退出的脚本吗？ 用 claude -p 和 Headless Mode 教程。

  4. 需要带 session、tools、hooks、审批的程序化 agent 吗？ 用 Agent SDK。

  5. 需要 Claude Code 反复访问外部系统吗？ 用 MCP，但先只读、先做安全检查。

相关页面

官方来源

On this page

短答案
CLI、Agent SDK、Claude API 区别
常见搜索意图
“Claude Code API reference”
“Claude Code API docs”
“Claude Code SDK”
“Claude Code headless API”
文档地图
认证规则
常见错误
迷你决策树
相关页面
官方来源