用途：用 TypeScript 构建可调用工具、自主执行任务的 Claude 智能体，核心接口为 query(prompt, options)，返回异步消息流。
主要能力：v0.1.45（2025-11-14）起支持结构化输出，通过 outputFormat 传入 JSON schema 或 Zod，并用 message.structured_output 获取校验结果，需 beta 头 structured-outputs-2025-11-13；内置 Read、Write、Edit、Bash、Grep、Glob、WebSearch、WebFetch、Task 等工具；支持插件（v0.1.27 plugins 数组）、钩子（PreToolUse、PostToolUse、Notification、UserPromptSubmit）；可接 MCP 服务器（进程内、stdio、HTTP/SSE），工具名格式为 mcp__<server>__<tool>；agents 可定义子智能体（description、prompt、tools、model）；会话支持 resume、forkSession、continue；权限模式有 default、acceptEdits、bypassPermissions、plan，并可用 canUseTool 回调自定义允许/拒绝/询问。
使用方式：需先安装 CLI：npm install -g @anthropic-ai/claude-code；设置 ANTHROPIC_API_KEY；由 settingSources（'user'|'project'|'local'）加载文件系统设置，默认不加载，优先级为程序化选项最高。
限制与常见错误：CLI_NOT_FOUND 需装 CLI；AUTHENTICATION_FAILED 检查密钥；PERMISSION_DENIED 检查权限配置；CONTEXT_LENGTH_EXCEEDED 需缩短上下文；SESSION_NOT_FOUND 需从 system init 消息保存 session_id；MCP_SERVER_FAILED 需核对命令或 URL。资料另列 12 个已知问题及对应解决方案。