Installation

Apprenez à installer et configurer Claude Code Action dans votre dépôt.

Prérequis

Avant d'installer Claude Code Action, assurez-vous d'avoir :

  • Un dépôt GitHub
  • Permissions d'administrateur du dépôt
  • Accès à Claude Code CLI
  • Une clé API Anthropic ou un token OAuth Claude Code

Installation rapide (Recommandé)

La méthode la plus rapide pour installer Claude Code Action est d'utiliser le CLI Claude Code :

1. Ouvrir Claude Code

claude

2. Exécuter la commande d'installation

/install-github-app

Cette commande vous guidera à travers :

  • L'installation de l'application GitHub Claude
  • La configuration des secrets requis
  • La configuration de votre fichier de workflow

Installation manuelle

Si vous préférez configurer manuellement ou avez besoin de plus de contrôle :

1. Installer l'application GitHub Claude

Visitez https://github.com/apps/claude et installez l'application sur votre dépôt.

2. Configurer l'authentification

Ajoutez l'un des secrets suivants à votre dépôt :

Option A : Clé API Anthropic (Recommandé)

  1. Allez dans les paramètres de votre dépôt
  2. Naviguez vers Secrets and variables → Actions
  3. Cliquez sur New repository secret
  4. Nom : ANTHROPIC_API_KEY
  5. Valeur : Votre clé API Anthropic

Option B : Token OAuth Claude Code

  1. Allez dans les paramètres de votre dépôt
  2. Naviguez vers Secrets and variables → Actions
  3. Cliquez sur New repository secret
  4. Nom : CLAUDE_CODE_OAUTH_TOKEN
  5. Valeur : Votre token OAuth

3. Créer le fichier de workflow

Créez .github/workflows/claude.yml dans votre dépôt :

name: Claude Code Action

on:
  issues:
    types: [opened, labeled]
  pull_request:
    types: [opened, labeled, synchronize]
  issue_comment:
    types: [created]

permissions:
  contents: write
  issues: write
  pull-requests: write

jobs:
  claude:
    runs-on: ubuntu-latest
    steps:
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
          # Ou utilisez le token OAuth :
          # claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}

4. Commit et Push

git add .github/workflows/claude.yml
git commit -m "Add Claude Code Action workflow"
git push

Méthodes d'authentification alternatives

Amazon Bedrock

- uses: anthropics/claude-code-action@v1
  with:
    aws_access_key_id: ${{ secrets.AWS_ACCESS_KEY_ID }}
    aws_secret_access_key: ${{ secrets.AWS_SECRET_ACCESS_KEY }}
    aws_region: us-east-1

Google Vertex AI

- uses: anthropics/claude-code-action@v1
  with:
    gcp_project_id: ${{ secrets.GCP_PROJECT_ID }}
    gcp_service_account_key: ${{ secrets.GCP_SERVICE_ACCOUNT_KEY }}
    gcp_region: us-central1

Configuration d'application GitHub personnalisée (Avancé)

Pour les organisations nécessitant une application GitHub personnalisée :

1. Créer l'application GitHub

  1. Allez dans GitHub Settings → Developer settings → GitHub Apps
  2. Cliquez sur New GitHub App
  3. Configurez les permissions minimales :
    • Contents : Read & Write
    • Issues : Read & Write
    • Pull requests : Read & Write

2. Générer une clé privée

  1. Dans les paramètres de votre application GitHub
  2. Faites défiler jusqu'à Private keys
  3. Cliquez sur Generate a private key
  4. Téléchargez et sécurisez le fichier .pem

3. Installer l'application sur le dépôt

  1. Allez dans les paramètres de votre application GitHub
  2. Cliquez sur Install App
  3. Sélectionnez les dépôts cibles

4. Ajouter les secrets

Ajoutez ces secrets à votre dépôt :

  • APP_ID : Votre ID d'application GitHub
  • APP_PRIVATE_KEY : Contenu du fichier .pem

5. Mettre à jour le workflow

- uses: anthropics/claude-code-action@v1
  with:
    github_app_id: ${{ secrets.APP_ID }}
    github_app_private_key: ${{ secrets.APP_PRIVATE_KEY }}
    anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}

Vérification

Après l'installation, testez l'action en :

  1. Créant une nouvelle issue ou pull request
  2. Ajoutant le label claude (si vous utilisez des déclencheurs basés sur les labels)
  3. Vérifiant l'onglet Actions pour les exécutions de workflow

Bonnes pratiques de sécurité

  • Ne commitez jamais les clés API directement dans votre dépôt
  • Utilisez les secrets GitHub Actions pour toutes les valeurs sensibles
  • Renouvelez régulièrement les clés API et les tokens
  • Évitez de logger les variables sensibles dans les sorties de workflow
  • Examinez régulièrement les permissions de l'application GitHub

Dépannage

L'action ne se déclenche pas

  • Vérifiez que le fichier de workflow est dans .github/workflows/
  • Vérifiez que les secrets requis sont définis
  • Assurez-vous que l'application GitHub est installée sur le dépôt
  • Examinez les conditions de déclenchement du workflow

Erreurs d'authentification

  • Confirmez que la clé API est valide et active
  • Vérifiez que les noms de secrets correspondent à la configuration du workflow
  • Vérifiez que l'application GitHub a les permissions nécessaires

Erreurs de permissions

  • Assurez-vous que le workflow a la permission contents: write
  • Vérifiez que l'application GitHub a l'accès requis au dépôt
  • Vérifiez les restrictions au niveau de l'organisation

Étapes suivantes