Claude Code et Codex

Les développeurs de votre organisation peuvent faire passer Claude Code et Codex par la Gateway. Chaque appel est rattaché à l'organisation, compté et visible, et le contenu de vos échanges n'est pas conservé.

Avant de commencer

Être autoriséUn administrateur de votre organisation vous donne le droit de créer des clés développeur. Voir Autoriser un développeur.
Créer une clé « Développeur »Page « Gateway IA » → « Nouvelle clé », type Développeur. Copiez-la : elle n'est affichée qu'une fois.
Noter l'adresse de la GatewayAffichée en haut de la page « Gateway IA ». Elle se termine par /v1.

Mettez la configuration dans vos fichiers personnels (~/.claude/settings.json, ~/.codex/config.toml), jamais dans les fichiers d'un projet qui sont partagés avec tout le monde. Ne commitez jamais votre clé.

Configurer l'outil

Via la Gateway, Claude Code n'utilise que les modèles Claude. Dans ~/.claude/settings.json :

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.wesupervise.ai",
    "ANTHROPIC_AUTH_TOKEN": "sv_gw_VOTRE_CLE",
    "CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY": "1",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "anthropic/claude-sonnet-4-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "anthropic/claude-haiku-4-5-20251001"
  }
}

ANTHROPIC_BASE_URL : l'adresse de la Gateway sans le /v1 final.
CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY : au démarrage, Claude Code récupère les modèles ouverts pour votre organisation et les affiche dans le menu /model.
ANTHROPIC_DEFAULT_*_MODEL : le modèle derrière les alias sonnet et haiku. Vous pouvez aussi changer à tout moment avec /model anthropic/claude-sonnet-4-5.

Vos skills Claude Code fonctionnent normalement : elles s'exécutent sur votre poste.

Codex utilise tous les modèles ouverts pour votre organisation, mais certaines de ses fonctions marchent moins bien hors des modèles OpenAI. Dans ~/.codex/config.toml :

model_provider = "supervise"
model = "anthropic/claude-sonnet-4-5"

[model_providers.supervise]
name = "Supervise Gateway"
base_url = "https://api.wesupervise.ai/v1"
env_key = "GATEWAY_API_KEY"
wire_api = "responses"

Puis, dans votre terminal ou votre profil de shell :

$ export GATEWAY_API_KEY=sv_gw_VOTRE_CLE

Le menu /model de Codex n'affiche pas les modèles de la Gateway. Pour en changer, modifiez model dans config.toml, ou lancez codex -m anthropic/claude-haiku-4-5-20251001.

Dans ces exemples, remplacez l'adresse par celle affichée dans votre page « Gateway IA ».

Étiqueter vos appels

Facultatif : un flag pour retrouver vos appels dans Supervise, par projet ou par tâche.

"ANTHROPIC_CUSTOM_HEADERS": "X-Supervise-Flag: mon-projet\nX-Supervise-Sub-Flag: refacto"

http_headers = { "X-Supervise-Flag" = "mon-projet" }

Bon à savoir

Vos appels comptent dans votre limite de dépense du mois, si votre organisation en a fixé une. Une fois la limite atteinte, Claude Code et Codex reçoivent un refus jusqu'au 1er du mois suivant.
Une clé développeur accepte 600 appels par minute par défaut. Au-delà, l'outil attend quelques secondes et réessaie.
Si un administrateur retire votre droit développeur, vos clés développeur actives sont révoquées.

En cas d'erreur

Erreur	Cause probable
`401`, clé invalide	Clé mal copiée, ou révoquée.
`403`, clé non autorisée sur cette route	Vous utilisez une clé « Script » : créez une clé « Développeur ».
`404`, modèle introuvable	Modèle fermé pour votre organisation : consultez la liste des modèles.
`400` dans Claude Code avec un modèle non Claude	Via la Gateway, Claude Code n'utilise que les modèles Claude.
« Monthly gateway spend limit reached »	Votre limite de dépense du mois est atteinte. Demandez à un administrateur de la relever.

Toutes les erreurs : Erreurs et limites.