Dépannage

Les douze pannes concrètes que nous voyons revenir chaque semaine. Symptôme → cause → correctif en une ligne.

Questions fréquentes

Dois-je me connecter à Claude Code ?

Non. La clé API fonctionne sans compte Claude Code. Si Claude Code affiche un écran de connexion, vous pouvez le passer ou vous connecter avec n’importe quel compte : cela n’affecte pas votre clé API-AI. Les requêtes passent par ANTHROPIC_BASE_URL + ANTHROPIC_API_KEY, pas par le jeton OAuth.

Pour supprimer complètement l’invite de connexion, effacez le jeton OAuth dans votre shell actuel :

# macOS / Linux
unset ANTHROPIC_AUTH_TOKEN

# Windows PowerShell
Remove-Item Env:\ANTHROPIC_AUTH_TOKEN

# Windows cmd
set ANTHROPIC_AUTH_TOKEN=

Puis redémarrez Claude Code. Si l’écran de connexion apparaît encore, la variable est aussi définie dans le fichier rc de votre shell — vérifiez et nettoyez :

grep -nE 'ANTHROPIC_AUTH_TOKEN' ~/.zshrc ~/.bashrc 2>/dev/null

Dois-je me connecter à ChatGPT pour la CLI Codex ?

Non. La CLI Codex lit OPENAI_BASE_URL et OPENAI_API_KEY dans l’environnement. Quand les deux pointent vers API-AI, Codex contourne complètement la connexion ChatGPT et parle à notre point d’accès. Vous pouvez donc passer l’écran d’authentification.

Si un ancien jeton ou un export dans le fichier rc vous gêne :

unset OPENAI_API_KEY
rm -f ~/.codex/auth.lock
# then re-export the values from your redeem page and restart codex
export OPENAI_BASE_URL="https://api-ai.fr/v1"
export OPENAI_API_KEY="mdf-..."
codex

Procédure complète sur la page Codex (OpenAI).

Faut-il un VPN ? Des restrictions géographiques ?

Aucun VPN nécessaire — API-AI n’applique aucune restriction géographique. Le point d’accès api-ai.fr ne bloque aucun pays.

Pire, les VPN et proxys VLESS cassent souvent la connexion à l’API, de deux façons :

• Le streaming SSE est mis en tampon dans le proxy — le flux est coupé en plein milieu.
• La négociation HTTP/2 + ALPN échoue aux points de relais — le client voit connection reset.

Si vous voyez des flux coupés, des connection reset ou des délais d’attente aléatoires, désactivez le VPN ou le proxy VLESS et réessayez. Notre passerelle ne met rien en tampon.

Erreur d’analyse JSON dans la configuration (ou une 429)

La cause la plus fréquente : des guillemets « typographiques » (“ ”) dans votre configuration JSON. Ils apparaissent quand on copie depuis une messagerie, Notion, Google Docs ou un navigateur qui remplace automatiquement les guillemets ASCII. Les analyseurs JSON n’acceptent que le " ASCII simple.

Parfois, une configuration cassée n’apparaît pas comme une « erreur d’analyse JSON » mais comme une 429 — le client interprète le silence de l’amont comme une limite de débit. Même correctif :

• Remplacez à la main chaque “ ” par ".
• Copiez les configurations directement depuis cette documentation — les guillemets y sont déjà corrects.
• Vérifiez avec cat -v config.json ou jq . config.json — les deux signalent l’octet fautif.

# Quick check: jq fails on the first smart quote
jq . ~/.claude/settings.json

# Auto-replace smart quotes with straight quotes
sed -i.bak 
  

s/[\u201c\u201d]/"/g' ~/.claude/settings.json

Tableau des symptômes

Diagnostics en une ligne

Si le tableau des symptômes ne couvre pas votre cas, récupérez ces trois éléments :

# 1. Confirm reach + auth
curl -sS -o /dev/null -w "HTTP %{http_code}  total %{time_total}s\n" \
  https://api-ai.fr/v1/models -H "x-api-key: $ANTHROPIC_API_KEY"

# 2. Reproduce the failing call with -v (verbose headers)
curl -sv https://api-ai.fr/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-5-5","max_tokens":32,"messages":[{"role":"user","content":"hi"}]}'

# 3. Check your current balance — via support@minedom-france.fr or the dashboard
#    (an HTTP balance endpoint is coming later)

Quand contacter le support

Envoyez les trois sorties ci-dessus, les 8 premiers caractères de votre clé et un horodatage UTC à support@minedom-france.fr. Cela suffit pour retrouver votre requête dans les journaux en quelques minutes. Voir Obtenir de l’aide pour ce dont nous n’avons pas besoin (et que nous ne demanderons jamais).