集成 Claude Code
Traduction en coursCe guide est actuellement disponible en chinois simplifié. Une version traduite sera ajoutée ultérieurement.
Spark CLI 可以为 Claude Code 生成一组本地 slash commands。Claude Code 根据命令模板理解参数和安全要求，再调用本机 spark 命令。
1. 安装
先完成 Spark CLI 安装与认证，然后执行：
spark integrations install claude
默认写入：
~/.claude/commands
也可以指定目录：
spark integrations install claude --dir ~/.claude/commands
检查安装位置：
spark integrations doctor
安装后重新启动 Claude Code 会话。
:::info 当前集成边界
Claude 安装器当前生成 slash command 文件，不会自动修改 Claude 的 MCP 配置。所有命令通过本机 Spark CLI 执行，并复用 ~/.spark 中的认证 profile。
:::
2. 常用 Slash Commands
| Command | 用途 |
|---|---|
/spark-guide | 查看 Spark CLI 帮助并选择模块 |
/spark-set-access-key | 保存用户提供的 Access Key |
/spark-task-designer | 选择任务设计器 App、版本和操作入口 |
/spark-task-types | 管理任务类型和分类 |
/spark-task-fields | 管理任务字段 |
/spark-task-forms | 管理任务表单 |
/spark-task-workflows | 管理步骤、工作流节点、连线和规则 |
/spark-task-permissions | 管理权限方案和授权项 |
/spark-task-i18n | 管理任务设计器翻译 |
/spark-task-check | 运行任务设计器检查 |
/spark-worklist | 查询任务运行期 Worklist |
/spark-sla | 查看 SLA 设计和运行数据 |
3. 任务设计器示例
/spark-task-designer app list
/spark-task-designer app use spark-sample
/spark-task-workflows workflow list
/spark-task-workflows workflow use "Purchase Approval"
/spark-task-workflows workflow describe --lang zh-CN
/spark-task-workflows 后的参数会追加到 spark-designer task。因此 workflow list 最终执行的是：
spark-designer task workflow list
4. 工作流修改示例
/spark-task-workflows workflow add-node --type status --name "Manager Review" --step "Manager Review" --yes
/spark-task-workflows workflow connect Start "Manager Review" --name Submit --yes
/spark-task-workflows workflow rules 2
写操作前，应让 Claude 明确复述目标 App、版本、工作流、节点或连线。不要把 --yes 用在尚未确认目标的命令上。
5. 运行期示例
/spark-worklist my-pending --app spark-sample --env dev
/spark-worklist my-created --app spark-sample --env test --keyword Purchase
/spark-worklist search 'assignee = currentUser() AND status = OPEN' --app spark-sample --env dev
查看某个任务详情时，可以让 Claude 直接执行 CLI：
请运行 spark task detail DEV-PURCHASE-18 --app spark-sample --env dev，汇总当前步骤、处理人、字段和可用操作。
6. 更新与排查
CLI 更新后重新生成 commands：
spark integrations install claude
排查步骤：
spark integrations doctor
ls ~/.claude/commands/spark-*.md
spark auth status
- slash command 不出现：重新安装并重启 Claude Code。
- 命令存在但执行失败：先在终端直接执行对应
spark ...命令。 - 连接失败：检查当前 Spark profile 和网络。
- 参数含空格：用引号包住 App、工作流、节点或 Filter 名称。