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"

命令行选项#

text

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的命令执行存在问题（例如权限问题或安装问题），请优先尝试修复问题而不是直接进行代码编写。