AgentRouter : des crédits Claude et GPT gratuits, et l'erreur 401 d'OpenCode corrigée

En bref

• Ce que tu gagnes : un crédit de bienvenue, 50 $ de bonus via un lien de parrainage, puis 25 $ par jour en pointant. Le détail est plus bas.
• Condition : un compte GitHub assez ancien et actif (ou un compte LinuxDO), et une inscription via mon lien de parrainage pour le bonus de 50 $.
• Le piège : OpenCode renvoie 401 unauthorized client detected si tu le branches directement. Un proxy local de 300 lignes, sans dépendance, règle ça.
• Temps : environ cinq minutes.
• Infos vérifiées le 24 septembre 2026 sur la FAQ officielle d'AgentRouter. Le crédit de bienvenue change souvent.

Les crédits API, c'est ce qui coûte cher quand on code avec des agents. Un agent qui refactorise un projet sur Claude Opus enchaîne des dizaines d'allers-retours, et la facture suit.

AgentRouter donne des crédits gratuits sur les meilleurs modèles de code, sans carte bancaire. Ce guide te montre comment les récupérer, puis comment les utiliser dans OpenCode sans tomber sur l'erreur 401 qui bloque la plupart des gens au premier lancement.

Créer mon compte AgentRouterLien de parrainage : +50 $ de bonus. Inscris-toi depuis la page qui s'ouvre.

Tu as Claude Code, Codex ou Cursor sur ton PC ? Le bouton Envoyer à un agent en haut de page lui confie toute l'installation. Il ne te restera qu'à créer le compte avec ce lien.

AgentRouter, c'est quoi ?

Un routeur d'API compatible OpenAI. Tu as une seule clé et une seule URL, et derrière, des modèles de plusieurs fournisseurs. Tout outil qui sait parler à l'API OpenAI sait donc parler à AgentRouter.

Quatre modèles sont disponibles en ce moment (liste relevée le 24 septembre 2026) :

• claude-opus-5
• claude-opus-4-8
• gpt-6-astra
• deepseek-v4-flash

Les trois premiers sont les plus forts pour le code agentique, mais ils sont distribués en quantité limitée chaque jour. DeepSeek V4 Flash sert de secours quand ils sont épuisés (voir l'erreur 402). La liste change de temps en temps : une fois inscrit, la page Tarifs d'AgentRouter fait foi.

Combien de crédits on peut obtenir ?

Le total varie d'une personne à l'autre, parce qu'il additionne plusieurs sources. La FAQ officielle chiffre toutes les sources, sauf le crédit de bienvenue :

• Crédit de bienvenue, versé une fois à l'inscription. C'est le seul montant qui n'est pas publié, et il change souvent : il a été de 150 $, puis de 175 $, et des inscrits de septembre 2026 rapportent 200 $.
• Bonus de parrainage : 50 $, une fois, si tu t'inscris via un lien d'invitation.
• Pointage quotidien : 25 $ par jour. Pointer (« check-in »), c'est cliquer une fois par jour sur le bouton prévu dans le tableau de bord. Le solde ne se met à jour qu'après une déconnexion puis une reconnexion.
• Codes cadeaux, de temps en temps : tirages au sort pour les comptes qui ont lié un e-mail, et distributions ponctuelles d'AgentRouter.

Il n'y a pas de recharge payante : on ne peut pas acheter de crédits.

Un détail qui compte plus que le solde : Claude et GPT sont distribués en quantité limitée chaque jour, en deux vagues, à 02:00 et 11:00 UTC (4 h et 13 h à Paris en heure d'été). Avoir des crédits ne garantit donc pas un accès à toute heure.

Étape 1 : Créer le compte

L'inscription se fait uniquement avec GitHub ou LinuxDO : pas d'e-mail. AgentRouter vérifie le compte GitHub pour bloquer les inscriptions en masse. Un compte trop récent est refusé avec le message « github账号不符合注册要求 » (« le compte GitHub ne remplit pas les conditions »).

Le critère exact n'est pas publié. Des comptes de 4 à 5 mois ont été refusés en septembre 2026, et plusieurs sources parlent d'au moins un an d'ancienneté. Un compte plus ancien, avec un peu d'activité (dépôts, e-mail vérifié), passe en général. Si ton compte GitHub est récent, LinuxDO est l'autre option, mais il faut une invitation pour y entrer.

Ouvre AgentRouter avec ce lien, et inscris-toi directement sur la page qui s'ouvre. Si tu arrives sur AgentRouter par un autre chemin (page d'accueil, Google, un autre article), le bonus de parrainage n'est pas appliqué.

Ouvrir AgentRouter avec mon lienagentrouter.org/register?aff=FOY1

1. Le site s'affiche souvent en chinois. Clique sur l'icône de traduction « 文A », en haut à droite, pour le passer en anglais
2. Sur la même page, clique sur « Continue with GitHub » (« 使用 GitHub 继续 » en chinois), ou sur « Continue with LinuxDO »
3. Autorise l'accès à ton compte
4. Le crédit de bienvenue et le bonus de parrainage arrivent automatiquement
5. Crée une clé API depuis le tableau de bord
6. Pense à pointer chaque jour pour les 25 $

Garde la clé sous la main pour l'étape suivante, et ne la mets jamais dans un dépôt Git.

Une règle à connaître : utilise un client de code supporté : OpenCode, Claude Code, Codex, Cursor, Cline, Roo Code… Un usage hors code ou via un client non supporté te place dans un groupe où tout coûte deux fois plus cher.

Transparence : c'est mon lien de parrainage. Il te donne le bonus de 50 $, et m'en donne autant. Ça ne te coûte rien et ça soutient ce guide.

Étape 2 : Lancer le proxy

Brancher OpenCode directement sur AgentRouter ne marche pas (on verra pourquoi plus bas). Un petit script Python se place entre les deux et corrige le problème.

Il te faut Python 3.10 ou plus récent :

python3 --version

Télécharge le script et range-le où tu veux :

↓agentrouter-proxy.pyScript Python · 306 lignes · aucune dépendance

Ouvre un terminal dans ce dossier, donne ta clé au proxy, puis lance-le.

macOS / Linux

export AGENTROUTER_API_KEY="ta_cle_agentrouter"
python3 agentrouter-proxy.py

Windows (PowerShell)

$env:AGENTROUTER_API_KEY="ta_cle_agentrouter"
python agentrouter-proxy.py

Le terminal doit afficher :

agentrouter-proxy :4182 -> https://agentrouter.org

Laisse ce terminal ouvert. Le proxy doit tourner tant que tu utilises OpenCode. Presque tous les « ça marchait hier » viennent d'un terminal fermé.

Deux détails pratiques :

• La clé ne vaut que pour ce terminal. Pour ne plus la retaper, ajoute la ligne export à ton ~/.zshrc ou ~/.bashrc (sous Windows : setx AGENTROUTER_API_KEY "ta_cle").
• Le port 4182 est déjà pris ? Passe-en un autre : python3 agentrouter-proxy.py 4300, et reporte-le à l'étape 3.

Étape 3 : Brancher OpenCode

Ouvre la configuration globale d'OpenCode, ~/.config/opencode/opencode.json (ou un opencode.json à la racine de ton projet), et ajoute le fournisseur AgentRouter :

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "agentrouter": {
      "name": "AgentRouter",
      "npm": "@ai-sdk/openai-compatible",
      "options": {
        "baseURL": "http://127.0.0.1:4182/v1",
        "apiKey": "{env:AGENTROUTER_API_KEY}"
      },
      "models": {
        "claude-opus-5": { "name": "Claude Opus 5" },
        "claude-opus-4-8": { "name": "Claude Opus 4.8" },
        "gpt-6-astra": { "name": "GPT 6 Astra" },
        "deepseek-v4-flash": { "name": "DeepSeek V4 Flash" }
      }
    }
  }
}

La ligne qui compte : baseURL pointe vers ton proxy local, http://127.0.0.1:4182/v1, et surtout pas vers https://agentrouter.org/v1. C'est le proxy qui ajoute ta vraie clé aux requêtes, donc aucun secret n'a besoin d'être écrit dans ce fichier.

Relance OpenCode, choisis un modèle AgentRouter, c'est prêt.

Si ça ne marche pas

Commence toujours par regarder le terminal du proxy. Chaque requête d'OpenCode y apparaît, avec l'erreur réelle renvoyée par AgentRouter, bien plus parlante que le message d'OpenCode :

[ar] POST /v1/chat/completions HTTP/1.1
[ar] ERROR 401: unauthorized client detected

Pour tout voir, relance le proxy en mode debug :

AGENTROUTER_DEBUG=1 python3 agentrouter-proxy.py

Erreur 401 « unauthorized client detected »

OpenCode ne passe pas par le proxy. Vérifie que le proxy tourne et que baseURL vaut bien http://127.0.0.1:4182/v1.

Si l'erreur persiste alors que tout passe par le proxy, AgentRouter a peut-être relevé la version d'OpenCode qu'il accepte. Dans le script, remplace la valeur de USER_AGENT par opencode/ suivi de ta version (opencode --version).

« JSON parsing failed » ou « Unexpected non-whitespace character after JSON »

Même cause : la réponse d'AgentRouter arrive sans passer par le proxy, qui est celui qui la nettoie. Corrige baseURL.

« Connection refused » sur 127.0.0.1:4182

Le proxy n'est pas lancé, ou il a été fermé. Relance-le. Si le port est occupé par un autre programme, change de port des deux côtés.

« ERROR: set AGENTROUTER_API_KEY first »

Le proxy ne trouve pas ta clé. Refais le export dans le même terminal que celui qui lance le proxy.

Erreur 402 « Budget pool quota has been exhausted »

La vague du jour pour Claude et GPT est épuisée. Ton compte n'y est pour rien. Attends la prochaine vague (02:00 ou 11:00 UTC), ou passe sur deepseek-v4-flash, qui n'est pas limité.

« 400 content blocked »

AgentRouter n'accepte que les requêtes en chinois, anglais, français, allemand ou russe. Reformule ta demande dans l'une de ces langues.

« sensitive words detected »

C'est le filtre anti-abus d'AgentRouter. Ouvre une nouvelle session dans OpenCode, ça suffit.

L'IA ne répond pas

Si les requêtes s'affichent dans le terminal du proxy mais que rien ne revient, le problème vient d'AgentRouter ou du modèle. Essaie un autre modèle.

Si agentrouter.org est injoignable, AgentRouter a un domaine de secours avec la même API : lance le proxy avec AGENTROUTER_UPSTREAM=https://ps.air-outer.com.

Les crédits n'apparaissent pas ou le solde affiche 0 $

Déconnecte-toi puis reconnecte-toi : le solde ne se met à jour qu'à la connexion. Un solde à 0 $ est aussi un bug d'affichage connu, qui se corrige tout seul.

Si le bonus de parrainage manque, l'inscription s'est faite sans lien d'invitation.

« github账号不符合注册要求 » à l'inscription

Ton compte GitHub ne passe pas la vérification d'AgentRouter, le plus souvent parce qu'il est trop récent. Il n'existe pas de recours automatique : essaie avec un compte GitHub plus ancien, ou avec LinuxDO. Tu peux aussi demander un déblocage manuel sur le dépôt officiel, sans garantie de réponse.

« 返回值非法，用户字段为空 » après l'autorisation GitHub

Le retour de GitHub vers AgentRouter a échoué. Des utilisateurs le signalent avec un VPN actif : désactive-le et réessaie.

Pourquoi OpenCode a besoin d'un proxy

AgentRouter et le SDK utilisé par OpenCode ont trois incompatibilités. Aucune ne vient de ta configuration.

1. L'en-tête User-Agent. AgentRouter n'accepte que les requêtes qui s'annoncent comme opencode/<version>. Le SDK envoie autre chose et se fait refuser avec un 401, même avec une clé valide. C'est la cause numéro un des messages « clé invalide » alors que la clé est bonne.

2. Les champs null. Le SDK envoie des champs vides comme response_format: null. AgentRouter les rejette avec expected object, received null.

3. Les objets de facturation dans la réponse. AgentRouter glisse des événements billing.summary et data: null au milieu du flux de réponse. Le SDK ne sait pas les lire et le parsing casse.

Le proxy fait donc trois choses, et rien d'autre : il réécrit l'en-tête, retire les champs null des requêtes et filtre ces événements parasites. Le code est court et commenté, lis-le avant de le lancer si tu veux savoir exactement ce qui tourne sur ta machine.

Utiliser AgentRouter sans OpenCode

Le proxy ne sert qu'à OpenCode. Dans ton propre code, tu peux appeler AgentRouter directement avec n'importe quel client OpenAI. Garde simplement le même User-Agent que le proxy, pour éviter le 401.

En curl

curl https://agentrouter.org/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $AGENTROUTER_API_KEY" \
  -H "User-Agent: opencode/1.17.12" \
  -d '{
    "model": "claude-opus-5",
    "messages": [
      {"role": "user", "content": "Explique-moi les closures en JavaScript"}
    ]
  }'

En Python

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["AGENTROUTER_API_KEY"],
    base_url="https://agentrouter.org/v1",
    default_headers={"User-Agent": "opencode/1.17.12"},
)

response = client.chat.completions.create(
    model="claude-opus-5",
    messages=[
        {"role": "user", "content": "Explique-moi les closures en JavaScript"}
    ],
)

print(response.choices[0].message.content)

En JavaScript / TypeScript

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.AGENTROUTER_API_KEY,
  baseURL: "https://agentrouter.org/v1",
  defaultHeaders: { "User-Agent": "opencode/1.17.12" },
});

const response = await client.chat.completions.create({
  model: "gpt-6-astra",
  messages: [
    { role: "user", content: "Explique-moi les closures en JavaScript" },
  ],
});

console.log(response.choices[0].message.content);

Pour changer de modèle, change la chaîne model. Rien d'autre ne bouge.

En résumé

Cinq minutes pour des crédits gratuits sur Claude Opus 5, GPT-6 Astra et DeepSeek V4, plus 25 $ chaque jour en pointant. Tu crées le compte, tu lances le proxy, tu pointes OpenCode dessus. Et tu laisses le terminal du proxy ouvert.