自动化与 CI/CD

Claude Code 不仅限于交互式会话，它可以融入你的自动化管道。

无头模式

将 Claude Code 作为 CLI 工具，非交互方式运行：

# 单次任务
claude -p "修复 lint 错误"

# 管道输入输出
claude -p "列出所有函数" | grep "async"
git diff | claude -p "解释这些更改"

# JSON 输出
echo "审查这个 PR" | claude -p --json

-p 标志以非交互方式运行 Claude 并直接输出到 stdout。

输出格式控制

claude -p "任务描述" --json           # JSON 格式
claude -p "任务描述" --output-format text  # 纯文本

自定义命令

将提示保存为 Markdown 文件即变成斜杠命令，支持参数：

/daily-standup        # 运行晨间例行提示
/explain $ARGUMENTS   # /explain src/auth.ts

不再重复自己，最好的提示值得被复用。

GitHub Actions

Claude Code 提供官方 GitHub Action，在 CI 工作流中自动运行。

快速设置

在终端中运行：

/install-github-app

手动设置

1. 安装 GitHub App
2. 添加 Anthropic API Key 到仓库 Secrets
3. 创建工作流文件：

name: Claude Code Review
on:
  pull_request:
    types: [opened, synchronize]

jobs:
  review:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Claude Review
        uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
          prompt: |
            审查这个 PR 的代码质量、安全性和性能。
            用中文回复。

常见 @claude 命令

在 PR 评论中使用 @claude 触发：

命令	说明
@claude review	代码审查
@claude fix the tests	修复测试
@claude implement feature X	实现功能

高级用法

• 定时报告：cron 触发 Claude 生成报告
• Issue 分流：新 Issue 自动分类和分配
• 自动修复：CI 失败时自动尝试修复

支持 AWS Bedrock 和 Google Vertex AI 作为企业云基础设施。

定时运行

多种方式实现定时执行：

方式	说明
/loop 命令	会话内定时循环
Desktop 定时任务	桌面应用内置调度
GitHub Actions	cron 触发 CI
claude -p + cron	本地系统级定时

实践建议

自动化从小处开始：先用 claude -p 在本地脚本中验证效果，确认可靠后再迁移到 GitHub Actions。/install-github-app 一键安装是最快的 CI 集成方式。