Apprenez à intégrer Claude Code dans votre flux de travail de développement avec Claude Code GitHub Actions
@claude
dans n’importe quelle PR ou issue, Claude peut analyser votre code, créer des pull requests, implémenter des fonctionnalités et corriger des bugs - tout en suivant les standards de votre projet.
CLAUDE.md
et les modèles de code existants/install-github-app
.
Cette commande vous guidera dans la configuration de l’application GitHub et des secrets requis.
/install-github-app
échoue ou si vous préférez la configuration manuelle, veuillez suivre ces instructions de configuration manuelle :
.github/workflows/
de votre dépôt@claude
dans un commentaire d’issue ou de PR !@beta
en @v1
mode: "tag"
ou mode: "agent"
(maintenant auto-détecté)direct_prompt
par prompt
max_turns
, model
, custom_instructions
, etc. en claude_args
Ancienne entrée Beta | Nouvelle entrée v1.0 |
---|---|
mode | (Supprimé - auto-détecté) |
direct_prompt | prompt |
override_prompt | prompt avec variables GitHub |
custom_instructions | claude_args: --system-prompt |
max_turns | claude_args: --max-turns |
model | claude_args: --model |
allowed_tools | claude_args: --allowedTools |
disallowed_tools | claude_args: --disallowedTools |
claude_env | settings format JSON |
@claude
) ou en mode automatisation (s’exécute immédiatement avec un prompt) basé sur votre configuration.CLAUDE.md
à la racine de votre dépôt pour définir les directives de style de code, les critères de révision, les règles spécifiques au projet et les modèles préférés. Ce fichier guide la compréhension de Claude des standards de votre projet.
ANTHROPIC_API_KEY
anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
${{ secrets.ANTHROPIC_API_KEY }}
) plutôt que de coder en dur les clés API directement dans vos fichiers de flux de travail.
CLAUDE.md
concis et focalisé, et configurez des timeouts appropriés pour vos flux de travail.
@claude
spécifiques pour réduire les appels API inutiles--max-turns
approprié dans claude_args
pour éviter les itérations excessivesprompt
pour toutes les instructions/review
ou /fix
claude_args
prompt
pour fournir des instructions.Créer une GitHub App personnalisée (Recommandé pour les fournisseurs 3P)
.pem
téléchargéAPP_PRIVATE_KEY
avec le contenu du fichier .pem
APP_ID
avec l’ID de votre GitHub AppConfigurer l'authentification du fournisseur cloud
AWS Bedrock
Note de sécurité : Utilisez des configurations spécifiques au dépôt et accordez seulement les permissions minimales requises.Configuration requise :
https://token.actions.githubusercontent.com
sts.amazonaws.com
token.actions.githubusercontent.com
AmazonBedrockFullAccess
Google Vertex AI
Note de sécurité : Utilisez des configurations spécifiques au dépôt et accordez seulement les permissions minimales requises.Configuration requise :
https://token.actions.githubusercontent.com
Vertex AI User
Ajouter les secrets requis
ANTHROPIC_API_KEY
: Votre clé API Anthropic depuis console.anthropic.comAPP_ID
: L’ID de votre GitHub AppAPP_PRIVATE_KEY
: Le contenu de la clé privée (.pem)GCP_WORKLOAD_IDENTITY_PROVIDER
GCP_SERVICE_ACCOUNT
APP_ID
: L’ID de votre GitHub AppAPP_PRIVATE_KEY
: Le contenu de la clé privée (.pem)AWS_ROLE_TO_ASSUME
APP_ID
: L’ID de votre GitHub AppAPP_PRIVATE_KEY
: Le contenu de la clé privée (.pem)Créer les fichiers de flux de travail
Flux de travail AWS Bedrock
Nom du secret | Description |
---|---|
AWS_ROLE_TO_ASSUME | ARN du rôle IAM pour l’accès Bedrock |
APP_ID | L’ID de votre GitHub App (depuis les paramètres de l’app) |
APP_PRIVATE_KEY | La clé privée que vous avez générée pour votre GitHub App |
us.anthropic.claude...
) et le suffixe de version.Flux de travail Google Vertex AI
Nom du secret | Description |
---|---|
GCP_WORKLOAD_IDENTITY_PROVIDER | Nom de ressource du fournisseur d’identité workload |
GCP_SERVICE_ACCOUNT | Email du compte de service avec accès Vertex AI |
APP_ID | L’ID de votre GitHub App (depuis les paramètres de l’app) |
APP_PRIVATE_KEY | La clé privée que vous avez générée pour votre GitHub App |
@claude
(pas /claude
).
Paramètre | Description | Requis |
---|---|---|
prompt | Instructions pour Claude (texte ou commande slash) | Non* |
claude_args | Arguments CLI passés à Claude Code | Non |
anthropic_api_key | Clé API Anthropic | Oui** |
github_token | Token GitHub pour l’accès API | Non |
trigger_phrase | Phrase de déclenchement personnalisée (défaut : “@claude”) | Non |
use_bedrock | Utiliser AWS Bedrock au lieu de l’API Anthropic | Non |
use_vertex | Utiliser Google Vertex AI au lieu de l’API Anthropic | Non |
claude_args
accepte n’importe quels arguments CLI Claude Code :
--max-turns
: Tours de conversation maximum (défaut : 10)--model
: Modèle à utiliser (par exemple, claude-sonnet-4-20250514
)--mcp-config
: Chemin vers la configuration MCP--allowed-tools
: Liste séparée par des virgules d’outils autorisés--debug
: Activer la sortie de débogage/install-github-app
soit l’approche recommandée, vous pouvez aussi :
CLAUDE.md
à la racine de votre dépôt. Claude suivra ces directives lors de la création de PRs et de la réponse aux demandes. Consultez notre documentation Mémoire pour plus de détails.prompt
dans le fichier de flux de travail pour fournir des instructions spécifiques au flux de travail. Cela vous permet de personnaliser le comportement de Claude pour différents flux de travail ou tâches.