用途：claude-code-sdk 是 Anthropic 官方 Python 套件，用于在应用中集成 Claude AI Agent 能力，适合代码生成、文件操作、研究任务与多轮对话场景，并要求以后端服务形式运行，不能在浏览器前端直接调用。
认证：支持两种方式。OAuth 通过 claude login 后把凭据存放在 ~/.claude/，适合个人开发及有 Max/Pro 订阅的用户；API Key 通过 ANTHROPIC_API_KEY 环境变量设置，适合生产环境和计量计费服务。可实现双重认证检查，优先 OAuth，API Key 作为后备。
主要能力：核心 API 是非同步的 query() 函数，以异步迭代器返回消息，支持 streaming 与完整回应，并可配置工具权限与执行限制。内置工具类型包括 Read、Write、Edit（文件操作），Bash（终端命令），Glob、Grep（文件搜索）与 WebFetch（网页抓取）。可按场景配置权限，例如开发模式开放完整权限、研究模式允许上网、只读模式仅允许读取。
使用方式：安装命令为 pip install claude-code-sdk；命令行工具为 npm install -g @anthropic-ai/claude-code。调用需使用 async/await 与异步迭代，例如 async for msg in query(prompt=prompt)。常见做法是建立 FastAPI 后端封装服务，提供普通端点与 StreamingResponse 串流端点，前端通过 fetch 调用；部署时可用 Docker 并挂载 OAuth 凭据。实践中建议增大 buffer size（如 50MB）、使用单例模式避免重复初始化、按场景限制工具权限。
适用场景：需要 Agent 功能（文件操作、终端命令）、希望使用 Max/Pro 订阅而非 API 计费、需要多轮互动或串流即时回应的应用。
限制：SDK 是 Python 套件，无法在浏览器中运行，必须建立后端 API 服务；必须处理非同步，遗漏 await / async 会报错；不要每次请求都新建服务，也不要忽略错误处理或给予过多权限。若仅需简单对话，可考虑标准 Claude API（anthropic 套件）。收费、价格与具体配额资料暂未提供。