Tutoriel d'utilisation de Claude Code GitHub Actions

Claude Code est un outil de codage agentique lancé par Anthropic, également considéré comme l’un des agents de programmation les plus puissants au monde. Claude Code GitHub Actions peut intégrer la capacité de programmation AI dans votre flux de travail GitHub, il vous suffit de @claude dans une PR ou un problème pour que Claude analyse automatiquement le code, crée une PR, implémente des fonctionnalités et corrige des bugs. Ce document présente principalement comment configurer et utiliser Claude Code GitHub Actions via le service proxy d’AceData Cloud.

Processus de demande

Pour utiliser Claude Code, vous pouvez d’abord vous rendre sur la page de service Claude Messages et cliquer sur le bouton « Acquire » pour obtenir les informations d’identification nécessaires à la demande :

Si vous n’êtes pas encore connecté ou inscrit, vous serez automatiquement redirigé vers la page de connexion pour vous inviter à vous inscrire et à vous connecter. Après vous être connecté ou inscrit, vous serez automatiquement renvoyé à la page actuelle. Lors de la première demande, un quota gratuit sera offert, vous permettant d’expérimenter gratuitement le service Claude Code.

Caractéristiques

Création instantanée de PR : décrivez vos besoins, Claude crée automatiquement une Pull Request complète
Implémentation automatique de code : dans un problème, @claude, transforme le problème en code exécutable
Respect des normes du projet : lit automatiquement CLAUDE.md, respecte votre style de code et les normes du projet
Sûr et fiable : le code s’exécute sur le Runner de GitHub, la sécurité des données est garantie

Étapes de configuration

Étape 1 : Installer l’application Claude GitHub

Rendez-vous sur https://github.com/apps/claude pour installer l’application Claude GitHub dans votre dépôt. Page d'installation de l'application GitHub Claude

Page d'installation de l'application GitHub Claude

Cette application nécessite les autorisations de dépôt suivantes :

Autorisation	Niveau	Description
Contents	Read & Write	Modifier les fichiers du dépôt
Issues	Read & Write	Répondre aux problèmes
Pull requests	Read & Write	Créer des PR et pousser des modifications

Étape 2 : Ajouter la clé API

Ajoutez la clé API d’AceData Cloud en tant que Secret du dépôt :

Accédez à Settings → Secrets and variables → Actions
Cliquez sur New repository secret
Remplissez le nom avec ANTHROPIC_API_KEY, et la valeur avec le jeton API que vous avez obtenu sur AceData Cloud
Cliquez sur Add secret pour enregistrer

Conseil : Le jeton API peut être consulté dans le tableau de bord d’AceData Cloud.

Étape 3 : Créer le fichier Workflow

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

name: Claude Code
on:
  issue_comment:
    types: [created]
  pull_request_review_comment:
    types: [created]
  issues:
    types: [opened, assigned]
  pull_request:
    types: [opened, synchronize]

jobs:
  claude:
    runs-on: ubuntu-latest
    steps:
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}

Si vous devez utiliser le point de terminaison API proxy d’AceData Cloud, vous devez également définir une variable d’environnement dans le Workflow :

name: Claude Code
on:
  issue_comment:
    types: [created]
  pull_request_review_comment:
    types: [created]

jobs:
  claude:
    runs-on: ubuntu-latest
    steps:
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
        env:
          ANTHROPIC_BASE_URL: "https://api.acedata.cloud"

Mode d’utilisation

Utilisation dans les commentaires de problème ou de PR

Une fois la configuration terminée, dans n’importe quel commentaire de problème ou de PR, @claude, Claude répondra automatiquement :

@claude Implémentez la fonctionnalité selon la description de ce problème
@claude Vérifiez la sécurité du code de cette PR
@claude Corrigez l'erreur TypeError dans le composant user dashboard
@claude Comment devrions-nous implémenter l'authentification des utilisateurs pour ce point de terminaison ?

Révision automatique du code

Créez un Workflow qui exécute automatiquement une révision de code lors de l’ouverture d’une PR :

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

jobs:
  review:
    runs-on: ubuntu-latest
    steps:
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
          prompt: "/review"
          claude_args: "--max-turns 5"
        env:
          ANTHROPIC_BASE_URL: "https://api.acedata.cloud"

Automatisation des tâches planifiées

Créez une tâche automatisée exécutée à intervalles réguliers :

name: Daily Report
on:
  schedule:
    - cron: "0 9 * * *"

jobs:
  report:
    runs-on: ubuntu-latest
    steps:
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
          prompt: "Générer un résumé des soumissions d'hier et un rapport des problèmes non fermés"
        env:
          ANTHROPIC_BASE_URL: "https://api.acedata.cloud"

Description des paramètres de l’Action

Paramètre	Description	Obligatoire
`anthropic_api_key`	Clé API	Oui
`prompt`	Instructions pour Claude (texte ou Skill comme `/review`)	Non
`claude_args`	Paramètres à passer à Claude Code CLI	Non
`github_token`	Jeton GitHub	Non
`trigger_phrase`	Phrase de déclenchement personnalisée (par défaut `@claude`)	Non

Paramètres courants de claude_args

claude_args: "--max-turns 5 --model claude-sonnet-4-5-20250929"

Paramètre	Description
`--max-turns`	Nombre maximum de tours de dialogue (par défaut 10)
`--model`	Modèle utilisé
`--mcp-config`	Chemin du fichier de configuration MCP
`--allowed-tools`	Outils autorisés (séparés par des virgules)
`--debug`	Activer la sortie de débogage

Meilleures pratiques

Configurer CLAUDE.md

Créez un fichier CLAUDE.md à la racine du dépôt, définissant les directives de style de code, les normes de révision et les normes du projet, Claude suivra automatiquement ces règles.

Considérations de sécurité

Ne jamais écrire la clé API directement dans le fichier Workflow
Utilisez toujours les Secrets GitHub (comme ${{ secrets.ANTHROPIC_API_KEY }})
Limitez les autorisations de l’Action au minimum nécessaire
Révisez manuellement les suggestions de Claude avant de fusionner

Contrôle des coûts

Utilisez des instructions @claude explicites pour réduire les appels API inutiles
Configurez une limite raisonnable pour --max-turns pour restreindre le nombre de tours de dialogue
Définissez un temps d’attente au niveau du Workflow
Utilisez le contrôle de concurrence de GitHub pour limiter le nombre d’exécutions parallèles

Questions fréquentes

Claude ne répond pas à la commande @claude ?

Vérifiez que l’application Claude GitHub est correctement installée
Vérifiez si le Workflow est activé
Assurez-vous que la clé API est définie comme Secret du dépôt
Assurez-vous que vous utilisez @claude dans le commentaire (et non /claude)

Erreur d’authentification ?

Vérifiez que la clé API est valide et dispose des autorisations suffisantes
Vérifiez que le nom du Secret est correct (ANTHROPIC_API_KEY)
Si vous utilisez ANTHROPIC_BASE_URL, vérifiez que l’URL est correcte

Comment consulter le quota restant ?

Connectez-vous à la console AceData Cloud pour voir le quota restant et l’utilisation actuelle de votre compte.

En savoir plus

📖 Documentation officielle de Claude Code GitHub Actions
📂 Dépôt claude-code-action
📋 Exemples de Workflow
🔧 Service Claude Code d’AceData Cloud
💬 Pour toute question, n’hésitez pas à nous contacter via le service client de la plateforme

​Processus de demande

​Caractéristiques

​Étapes de configuration

​Étape 1 : Installer l’application Claude GitHub

​Étape 2 : Ajouter la clé API

​Étape 3 : Créer le fichier Workflow

​Mode d’utilisation

​Utilisation dans les commentaires de problème ou de PR

​Révision automatique du code

​Automatisation des tâches planifiées

​Description des paramètres de l’Action

​Paramètres courants de claude_args

​Meilleures pratiques

​Configurer CLAUDE.md

​Considérations de sécurité

​Contrôle des coûts

​Questions fréquentes

​Claude ne répond pas à la commande @claude ?

​Erreur d’authentification ?

​Comment consulter le quota restant ?

​En savoir plus