> ## Documentation Index
> Fetch the complete documentation index at: https://docs.acedata.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# Tutoriel d'utilisation de Claude Code GitHub Actions

> Claude Code 集成指南 - Ace Data Cloud

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](https://platform.acedata.cloud/documents/claude-messages) et cliquer sur le bouton « Acquire » pour obtenir les informations d'identification nécessaires à la demande :

![](https://cdn.acedata.cloud/nyq0xz.png)

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](https://github.com/apps/claude) pour installer l'application Claude GitHub dans votre dépôt.

![Page d'installation de l'application GitHub Claude](https://cdn.acedata.cloud/ba4b8df66d.png)

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 :

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

> **Conseil** : Le jeton API peut être consulté dans le [tableau de bord d'AceData Cloud](https://platform.acedata.cloud/console).

### Étape 3 : Créer le fichier Workflow

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

```yaml theme={null}
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 :

```yaml theme={null}
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 :

```yaml theme={null}
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 :

```yaml theme={null}
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

```yaml theme={null}
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 ?

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

### Erreur d'authentification ?

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

### Comment consulter le quota restant ?

Connectez-vous à la [console AceData Cloud](https://platform.acedata.cloud/console) pour voir le quota restant et l'utilisation actuelle de votre compte.

## En savoir plus

* 📖 [Documentation officielle de Claude Code GitHub Actions](https://code.claude.com/docs/en/github-actions)
* 📂 [Dépôt claude-code-action](https://github.com/anthropics/claude-code-action)
* 📋 [Exemples de Workflow](https://github.com/anthropics/claude-code-action/tree/main/examples)
* 🔧 [Service Claude Code d'AceData Cloud](https://platform.acedata.cloud/documents/claude-messages)
* 💬 Pour toute question, n'hésitez pas à nous contacter via le service client de la plateforme