Comment utiliser GitHub gratuitement avec des agents IA (2026)

Oui, GitHub est gratuit : le forfait GitHub Free offre un nombre illimité de dépôts publics et privés, un nombre illimité de collaborateurs et 2 000 minutes d'exécution GitHub Actions par mois. Les agents d'IA peuvent également en profiter avec cette formule. La documentation officielle de GitHub indique que son serveur MCP officiel est « disponible pour tous les utilisateurs de GitHub, quel que soit leur type de forfait », ce qui permet à Claude Code, Codex ou OpenCode de lire les tickets (issues), d'ouvrir des pull requests et de suivre l'état des workflows sans abonnement payant. Ce qui peut vous être facturé, en revanche, c'est le modèle d'IA utilisé par l'agent — mais il existe également une solution pour que cela vous coûte 0 $.

En résumé

Connectez le serveur MCP officiel de GitHub à votre agent de développement à l'aide d'un jeton d'accès personnel (PAT) à granularité fine. Sur GitHub Free, les limites déterminantes sont le quota de minutes Actions sur les dépôts privés, le plafond de requêtes REST et une poignée de fonctionnalités collaboratives réservées aux dépôts publics. Le véritable coût provient de l'agent : Claude Code et Codex nécessitent un forfait payant ou des crédits d'API, tandis qu'OpenCode prend actuellement en charge plusieurs modèles gratuits. Dès que vos agents réalisent des tâches concrètes, l'intégration GitHub de Sharkly transforme les nouveaux tickets en tâches assignables à un agent.

Forfait GitHub Free : les limites qui comptent pour les agents

GitHub Free est particulièrement généreux en matière de stockage et de collaborateurs, mais s'avère plus restrictif sur les points que les agents ont tendance à solliciter intensément.

Minutes d'Actions. La page des tarifs affiche 2 000 minutes par mois, et Actions est « gratuit pour les dépôts publics ». Un agent qui crée des pull requests déclenche votre CI à chaque push. Dix PR ouvertes par jour avec une suite de tests durant six minutes, chacune poussée deux fois, consommeraient environ 3 600 minutes par mois : sur un dépôt privé, le quota de minutes peut vite devenir le premier obstacle. Optimisez la rapidité de vos tests ou annulez les builds obsolètes à l'aide d'un groupe concurrency dans votre workflow.

Limites de requêtes (rate limits). Chaque appel d'outil MCP se traduit par un appel API GitHub effectué avec votre jeton. La documentation sur les quotas de l'API REST accorde 5 000 requêtes par heure pour un jeton personnel, assorties de limites secondaires d'environ 80 requêtes de création de contenu par minute. Un agent isolé atteint rarement ces seuils. En revanche, plusieurs agents partageant un même jeton peuvent rapidement les saturer.

Fonctionnalités réservées aux dépôts publics. Avec le forfait Free, les code owners, les pull requests préliminaires (drafts) et les règles de protection des environnements ne s'appliquent qu'aux dépôts publics. Si vous souhaitez que vos agents créent des brouillons de PR sur un dépôt privé, cette option requiert un forfait payant.

Copilot Free. Il inclut jusqu'à 2 000 complétions de code par mois, le mode agent et la prise en charge de MCP dans l'éditeur, mais la page des forfaits indique que l'agent cloud de Copilot n'est pas inclus, et le volume exact de crédits IA n'est pas précisé. Considérez-le comme un assistant de code intégré à l'éditeur, et non comme un coéquipier à qui déléguer des tickets.

Le serveur MCP lui-même. La documentation de configuration MCP de GitHub précise une restriction : « Si une fonctionnalité nécessite une licence GitHub ou Copilot payante, l'outil MCP équivalent requiert le même abonnement ». La consultation des tickets, des pull requests, des dépôts et des journaux d'Actions fonctionne sur l'offre Free ; les outils pilotant l'agent cloud de Copilot ne fonctionnent pas.

Connecter GitHub à Claude Code, Codex ou OpenCode

Le dépôt github-mcp-server documente deux manières de l'exécuter : via le point de terminaison hébergé par GitHub à l'adresse https://api.githubcopilot.com/mcp/, ou via une image Docker locale. La solution hébergée ne requiert aucune installation locale : commencez donc par là.

1. Créez un jeton d'accès personnel à granularité fine. Accordez-lui uniquement l'accès aux dépôts sur lesquels l'agent doit intervenir, avec les droits de lecture et écriture sur Issues et Pull requests, et les droits de lecture sur Contents et Actions. Les guides de GitHub mentionnent la portée classique repo ; un jeton à granularité fine restreint à quelques dépôts est un choix nettement plus sûr pour un agent.

2a. Claude Code. Depuis un terminal classique, conformément au guide GitHub pour Claude :

claude mcp add --transport http github https://api.githubcopilot.com/mcp \
  -H "Authorization: Bearer YOUR_GITHUB_PAT"

Exécutez ensuite claude mcp list pour confirmer que github est bien connecté.

2b. Codex. Le guide GitHub pour Codex lit le jeton depuis une variable d'environnement, ce qui évite de l'inscrire en clair dans le fichier de configuration :

export GITHUB_PAT_TOKEN=your_token
codex mcp add github --url https://api.githubcopilot.com/mcp/ \
  --bearer-token-env-var GITHUB_PAT_TOKEN

Lancez /mcp dans Codex pour vérifier les outils disponibles.

2c. OpenCode. Ajoutez ceci dans le fichier opencode.json à la racine du projet, selon le guide GitHub pour OpenCode :

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "github": {
      "type": "remote",
      "url": "https://api.githubcopilot.com/mcp/",
      "enabled": true,
      "oauth": false,
      "headers": {
        "Authorization": "Bearer {env:GITHUB_PERSONAL_ACCESS_TOKEN}"
      }
    }
  }
}

La notation {env:...} conserve le jeton dans votre environnement shell au lieu de le stocker dans un fichier risquant d'être commité.

3. Limitez les ensembles d'outils (toolsets). Par défaut, les ensembles activés sont context, repos, issues, pull_requests et users. Moins vous exposez d'outils, moins vous consommez de tokens de contexte dans leurs descriptions. Le serveur local accepte également le flag --read-only, un point de départ judicieux pour un agent dédié uniquement au tri.

4. Testez une requête simple. « Liste les tickets ouverts avec le label bug dans ce dépôt et résume les trois plus anciens » permet de valider le jeton, le serveur et l'agent en une seule commande.

L'option à 0 $

Voici la combinaison qui ne coûte rien aujourd'hui : GitHub Free, le serveur MCP hébergé avec un jeton à granularité fine, et OpenCode configuré sur l'un de ses modèles gratuits.

Le niveau gratuit d'OpenCode ne requiert ni inscription ni clé API. Lors de nos tests réalisés le 16 octobre 2026 (OpenCode 1.19.2 via npx opencode-ai@latest), une tâche d'écriture et d'exécution a été bouclée en 32 secondes avec opencode/deepseek-v4.1-flash-free. La documentation d'OpenCode Zen liste ce modèle parmi les options gratuites du moment, aux côtés de glm-5.3-flash-free et d'autres, en soulignant que son fournisseur garantit une rétention zéro et n'entraîne pas ses modèles sur vos données. Attention : d'autres modèles gratuits de cette liste peuvent exploiter vos données, lisez donc attentivement les mentions légales avant de pointer l'un d'eux vers un dépôt privé.

Les contraintes réelles à anticiper :

• Les modèles gratuits sont promotionnels. Zen précise que la plupart sont offerts « pour une durée limitée ». Anticipez le moment où votre modèle habituel ne sera plus disponible.
• L'accès gratuit est réservé à OpenCode. Appeler ce même point de terminaison depuis un script personnalisé renvoie une erreur HTTP 403 FreeTierError.
• Les minutes d'Actions sont toujours décomptées. L'agent est gratuit, mais le pipeline de CI qu'il déclenche sur un dépôt privé reste soumis aux quotas.
• Claude Code et Codex ne font pas partie de cette formule. Claude Code nécessite un forfait Claude payant ou des crédits d'API ; Codex exige un abonnement ChatGPT ou une clé API OpenAI.

Du simple chat à l'assignation de tâches

Taper « répare l'issue #142 » dans un terminal fonctionne pour un développeur isolé. En équipe, la véritable étape franchie consiste à assigner le ticket à un agent et à rendre le résultat visible par l'ensemble des collaborateurs.

Sharkly propose une véritable intégration GitHub pensée pour cet usage, documentée dans le guide d'intégration GitHub :

• Les tickets deviennent des tâches. Un propriétaire (Owner) ou un administrateur d'organisation installe l'application GitHub et sélectionne les dépôts. Liez un dépôt à un Space, et les nouveaux tickets créés seront automatiquement synchronisés sous forme de tâches. Les tickets existants ne sont pas importés rétroactivement. La synchronisation unidirectionnelle s'effectue de GitHub vers Sharkly ; un Space peut également accueillir un dépôt synchronisé de manière bidirectionnelle.
• Les pull requests sont associées automatiquement. Intégrez l'identifiant de la tâche (Task ID) dans le nom de la branche, le titre ou la description de la PR pour que Sharkly la relie automatiquement à la tâche correspondante. Fusionner une PR ne modifie pas le statut de la tâche ; en revanche, fermer ou rouvrir un ticket synchronisé peut l'actualiser.
• Assignez la tâche à un agent. L'agent exécute Claude Code, Codex ou OpenCode directement sur votre propre machine (Computer), chaque tâche tournant dans un worktree git isolé, tandis que l'avancement et les résultats remontent directement dans la tâche.

Une distinction technique est essentielle : l'application GitHub ne confère pas à l'agent les droits de clonage. Le clone s'appuie toujours sur la clé SSH ou les identifiants HTTPS de la machine (Computer), configurés comme dépôts au niveau de l'agent ou du Space.

Qu'en est-il du serveur MCP lors d'une exécution Sharkly ? La documentation de Sharkly ne traite pas directement de MCP. D'après nos observations, l'agent démarre directement la CLI correspondante dans le worktree du dépôt : un fichier .mcp.json configuré pour le projet et commité dans le dépôt (ou la configuration globale sur cette machine) devrait donc être pris en compte lors de l'exécution. Validez toujours la configuration avec un smoke test sur une petite tâche avant de vous reposer dessus. Le guide Assigner un ticket GitHub à un agent d'IA présente l'ensemble du flux, et l'article Comprendre GitHub Agent HQ analyse l'approche propre à GitHub en matière de délégation aux agents.

Le tableau Sharkly est actuellement gratuit pour les organisations jusqu'à 5 personnes, les agents et les machines ne consomment aucun siège payant, et l'usage des modèles s'effectue via vos propres clés ou abonnements. Vous centralisez ainsi le contexte, l'avancement, les points de blocage, les résultats et la revue humaine du premier ticket jusqu'au merge final.

Pièges à éviter

• Un jeton partagé, un quota partagé. Attribuez à chaque agent son propre jeton à granularité fine afin qu'un agent très sollicité ne vienne pas bloquer les autres par dépassement de quota.
• Ne mettez jamais le jeton en clair dans .mcp.json. Claude Code résout la variable ${VAR} dans les en-têtes de .mcp.json : commitez le nom de la variable dans le dépôt et définissez la valeur directement sur la machine hôte.
• Les brouillons de PR sur les dépôts privés nécessitent un forfait payant. Sur GitHub Free, configurez plutôt l'agent pour ouvrir des PR standards accompagnées de la mention « WIP » dans le titre.
• Les pushs réguliers des agents consomment des minutes Actions. Définissez un groupe concurrency avec cancel-in-progress: true pour stopper immédiatement les exécutions devenues inutiles.
• Les outils de l'agent cloud Copilot échouent sur l'offre Free. Cela découle des restrictions de licence payante, et non d'une mauvaise configuration de votre jeton.

FAQ

GitHub est-il gratuit ? Oui. GitHub Free comprend un nombre illimité de dépôts publics et privés, des collaborateurs illimités, 2 000 minutes d'exécution Actions par mois sur les dépôts privés et 500 Mo de stockage pour Packages.

Le serveur MCP GitHub est-il gratuit ? Oui. GitHub précise qu'il est accessible à tous les utilisateurs, quel que soit leur forfait. Les outils associés à des fonctionnalités payantes, comme l'agent cloud de Copilot, exigent en revanche l'abonnement correspondant.

Que ne contient pas le forfait GitHub Free pour les agents ? Les minutes Actions illimitées sur les dépôts privés, les pull requests préliminaires (drafts) et les code owners sur les dépôts privés, ainsi que l'agent cloud de Copilot.

Peut-on exécuter un agent de code sur GitHub pour 0 $ ? Oui, en associant OpenCode sur un modèle gratuit à GitHub Free et au serveur MCP hébergé. Les modèles gratuits étant des offres promotionnelles temporaires, préparez-vous à devoir en changer à terme. Pour explorer les coûts selon les modèles, consultez notre guide sur le coût d'une équipe d'agents d'IA avec les formules gratuites et économiques, et pour coordonner le travail de plusieurs agents, découvrez notre dossier sur la gestion de projet avec Claude Code.