claude-code-sdk

# Claude Code ## 概述 Claude Code作为一款具备超强能力的Coding Agent，既可以完成小单元的代码编写，也可以进行大模块的整体开发、测试和验证。在有Coding Agents助力的情况下，你不必亲自完成代码的撰写、问题修复和测试验证，你只需将任务需求转换为明确、完整的指令，并交由Claude Code完全自主地完成代码的撰写、问题修复和测试验证。Claude Code不仅是执行者，你在遇到需求分解、设计相关的问题时，甚至可以向Claude Code需求建议或进行讨论，在它的帮助下完成整个开发工作。 本技能用于以node脚本的方式调用Claude Code。 ## 快速开始 ### 安装依赖 ```bash npm install -g @anthropic-ai/claude-agent-sdk ``` ### 基本用法 调用位于本技能目录下的`scripts/run_claude.mjs`脚本来调用Claude Code。 ```bash node /path/to/skills/claude-code-sdk/scripts/run_claude.mjs --query "Find and fix the bug in auth.py" ``` ## 命令行选项 ``` node /path/to/skills/claude-code-sdk/scripts/run_claude.mjs --query QUERY [--append-system-prompt APPEND_SYSTEM_PROMPT] [--resume RESUME] [--log-file LOG_FILE] ``` | 选项 | 描述 | | :----------------------- | :--------------------------- | | `--query` | 要发送给Claude Code的查询 | | `--append-system-prompt` | 可选，要添加到系统提示的指令 | | `--resume` | 可选，要继续的会话ID | | `--log-file` | 可选，要记录中间输出的文件 | ### 1. 自定义系统提示 使用 `--append-system-prompt` 添加指令，同时保留 Claude Code 默认行为： ```bash node /path/to/skills/claude-code-sdk/scripts/run_claude.mjs --query "Find and fix the bug in auth.py" --append-system-prompt "You are a security engineer. Review for vulnerabilities." ``` ### 2. 继续会话 在使用Claude Code完成连续任务时，需要使用 `--resume` 参数指定会话ID来继续会话，使得Claude Code能够保留之前的上下文信息。在`run_claude.mjs`脚本的输出中，会记录当前会话ID，并将其作为结果的一部分返回。当你需要继续会话时，只需将该会话ID作为`--resume`参数的值即可。 **注意**：除非你必须要开始一个全新的开发项目，否则都要使用--resume参数，让Claude Code在连续的上下文中进行工作，以更好地处理你的任务。 ### 3. 记录中间输出 当使用Claude Code执行复杂任务时，`run_claude.mjs`脚本会运行较长时间，为了方便观察中间执行过程，可以使用`--log-file`参数来将记录中间输出结果写入到文件中，在等待脚本执行完成期间，你可以通过读取文件内容来实时查看中间输出结果。 ## 注意事项 **长时运行** 由于Claude Code执行时间可能较长，当命令被转到后台运行时，你需要使用process工具的poll方法来轮询命令的执行结果，但是每次轮询不超过180s，并且在轮询间隙要向用户（`__user__`）发送消息，告知用户当前执行状态。 **自主修复** 在任何与软件开发相关的任务场景中，你都必须完全依赖Claude Code来完成任务，而不是直接进行代码编写。如果遇到Claude Code的命令执行存在问题（例如权限问题或安装问题），请优先尝试修复问题而不是直接进行代码编写。