标签: #ClaudeCode

本文详细介绍了Claude Agent SDK的核心功能，主要分为三部分：1) Skill管理机制：Skills以SKILL.md文件形式存储，通过Options.skills过滤，支持本地插件、动态目录扫描等多种注册方式，并有描述字符预算限制；2) 人机交互控制：interrupt()实现优雅中断并返回队列状态，close()强制终止进程，中断后可通过SDKUserMessage继续对话；3) 其他重要特性：startup()预热子进程消除冷启动，fallbackModel实现主模型过载降级，strictMcpConfig确保MCP服务器隔离，以及文件回滚、进度摘要、动态MCP管理等高级功能。

本文详解SDK安全架构的核心设计：权限层采用`permissionMode`→`canUseTool`→permission rules三层叠加，确保精细化控制；沙箱通过OS级隔离（macOS用`sandbox-exec`，Linux用`bubblewrap`）提供机制级防线；Hook系统支持31种事件拦截，可在执行前后改写决策与输出；MCP支持多协议服务器接入；Agents实现多租户隔离，通过env变量最小化、沙箱严格配置及canUseTool白名单构建安全边界。关键边界包括：canUseTool永不返回null避免无限阻塞，sandbox.failIfUnavailable确保fail-closed，Bash工具dangerouslyDisableSandbox需双保险拦截。案例展示通过env替换、沙箱启用及工具白名单构建每用户隔离环境。

Claude Agent SDK通过`query`函数返回异步生成器实现Agent Session抽象。消息类型包括`system`（初始化）、`assistant`（模型回复）、`user`（用户/工具结果）、`stream_event`（流式增量）和`result`（终结）。`result`分为成功（含结果、成本、用量）和失败（含错误类型），需通过`subtype`判别。流式输入支持动态调整权限、模型等。Options配置涵盖环境变量、工具权限、模型参数、预算控制、会话恢复等，需注意`maxTurns`和`maxBudgetUsd`的终止机制，以及`permissionMode`六种权限模式。关键边界是流结束≠成功，需检查`is_error`。

Boris Cherny的Claude Code使用技巧聚焦高效协作与AI杠杆最大化：并行运行本地及云端Agent实例提升产出，需技术基础支撑；团队共用并每周更新CLAUDE.md记录错误，通过代码审查让Agent迭代文件；采用计划模式优先架构设计，再落地代码；封装工作流为命令如commit-push-pr提效；设置质量验证环节确保代码质量。对比Cursor，Claude支持多工具调用、subagents及执行Hook（如代码检查、长时任务处理）。建议不跳过权限，用/permissions预批安全命令，并通过“AI意识”优先用AI解决理解偏差问题，避免低效卡顿。