claude-code-action 的安装和配置教程

1. 项目的基础介绍和主要的编程语言

claude-code-action 是一个开源项目，旨在为 GitHub PRs 和 issues 提供一个通用的代码助手。它可以回答关于代码、架构和编程的问题，分析 PR 变更并提出改进建议，实现简单的修复、重构甚至新特性，并与 GitHub 评论和 PR 审查无缝协作。该项目主要使用 TypeScript 编程语言，并且依赖于 GitHub Actions 进行自动化操作。

2. 项目使用的关键技术和框架

该项目使用了以下关键技术：

• GitHub Actions：用于自动化 GitHub 仓库中的工作流程。
• Anthropic API：提供人工智能功能，如代码分析和自动修复。
• Amazon Bedrock 或 Google Vertex AI：可选的替代 Anthropic API 的机器学习平台。
• OIDC：开放身份认证，用于 Amazon Bedrock 和 Google Vertex AI 的身份验证。

3. 项目安装和配置的准备工作和详细的安装步骤

准备工作

在开始安装前，请确保您已经满足以下条件：

• 您拥有一个 GitHub 账户。
• 您有一个 GitHub 仓库，用于安装 claude-code-action。
• 您是仓库的管理员，因为安装 GitHub 应用和添加密钥需要管理员权限。

安装步骤

1. 安装 Claude GitHub 应用

   • 访问 Claude GitHub 应用页面。
   • 点击 “Install it for free”。
   • 选择您的仓库，然后点击 “Install” 完成安装。

2. 添加仓库密钥

   • 在您的 GitHub 仓库中，转到 “Settings” > “Secrets and variables”。
   • 点击 “Actions” 选项卡。
   • 添加以下密钥：
     • ANTHROPIC_API_KEY：如果您直接使用 Anthropic API，请在这里添加您的 API 密钥。
     • GITHUB_TOKEN：GitHub 提供的默认 token，用于 Claude 操作仓库。

3. 创建工作流文件

   • 在您的仓库中创建一个名为 .github/workflows/claude.yml 的工作流文件。
   • 使用以下基本的工作流配置作为起点：

name: Claude Assistant

on:
  issue_comment:
    types:
      - created
  pull_request_review_comment:
    types:
      - created
  issues:
    types:
      - opened
      - assigned
  pull_request_review:
    types:
      - submitted

jobs:
  claude-response:
    runs-on: ubuntu-latest
    steps:
      - uses: anthropics/claude-code-action@beta
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
          github_token: ${{ secrets.GITHUB_TOKEN }}
          # 可选配置项
          # trigger_phrase: "/claude"
          # assignee_trigger: "claude"

4. 触发 Claude
   • 在您的 PR 或 issue 中评论 @claude 加上您的请求，例如：@claude 请审查这个 PR 并提出建议。
   • Claude 将根据您的配置和工作流中的指令进行响应。

按照上述步骤操作，您应该能够成功安装和配置 claude-code-action，并开始使用它来辅助您的代码开发和审查过程。