Retour au blog
Guide développeurNovember 12, 20268 min de lecture

Une clé. Tous les modèles. Codex et Claude Code compris.

Codex CLI et Claude Code se connectent désormais directement à unbottled.ai, aux côtés d'OpenCode, Continue, Aider et Cline. Une URL de base, une clé, une commande par outil.

Votre agent de code est verrouillé sur les modèles d'un seul fournisseur. Vous voulez un deuxième avis d'un autre labo, un modèle moins cher pour les tâches ingrates, ou un modèle qui ne refuse pas ? Il vous faut un autre compte, une autre clé, une autre facture.

unbottled.ai parle les trois formats qu'utilisent les agents de code : les chat completions OpenAI, la Responses API d'OpenAI et l'Anthropic Messages API. Rien à installer entre les deux. Pointez un outil vers nous une fois, puis passez de Claude à GPT, DeepSeek, GLM, Kimi, Qwen ou aux modèles non censurés en changeant un seul id de modèle.

Avant de commencer : l'API demande un compte payant. N'importe quelle formule la débloque, dès €8 par mois. Les crédits gratuits et les crédits bonus, non. Débloquer l'API

Pourquoi s'embêter

  • Une clé, un solde. Pas de comptes séparés chez Anthropic, OpenAI, DeepSeek, Moonshot et Z.ai.
  • Des modèles non censurés dans votre éditeur. Recherche en sécurité, prompts de red team, outils pour la fiction, données qui déclenchent les filtres grand public. C'est vous qui choisissez le niveau de filtrage, pas le fournisseur.
  • Le bon modèle pour chaque tâche. Un modèle de pointe pour le refactoring difficile, un modèle flash pour les renommages et l'échafaudage de tests. Même config, id différent.
  • Les mêmes crédits que l'application de chat, aux mêmes prix. Chaque réponse indique ce qu'elle a coûté.

Obtenir une clé et une URL de base

Deux valeurs. Chaque outil ci-dessous a besoin exactement de celles-ci.

Créez une clé dans Paramètres > Clés d'API. Elle commence par sk-unb- et ne s'affiche qu'une fois.

URL de base: https://unbottled.ai/api/fr-FR/v1

Pour les outils de type OpenAI : Codex, OpenCode, Continue, Aider, Cline. La locale dans le chemin ne change que la langue des messages d'erreur.

URL de base Anthropic: https://unbottled.ai/api/fr-FR

Pour Claude Code et les SDK Anthropic. Même URL sans /v1 : ils ajoutent eux-mêmes /v1/messages.

Vérifier votre clé
terminal
export UNBOTTLED_API_KEY="sk-unb-YOUR_KEY"

curl https://unbottled.ai/api/fr-FR/v1/models \
  -H "Authorization: Bearer $UNBOTTLED_API_KEY"
Première requête
terminal
curl https://unbottled.ai/api/fr-FR/v1/chat/completions \
  -H "Authorization: Bearer $UNBOTTLED_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"glm-5.3","messages":[{"role":"user","content":"Hello"}]}'

Gardez la clé dans une variable d'environnement, jamais dans un fichier que vous commitez. L'appel curl prouve que la clé fonctionne et liste tous les ids de modèles que votre compte peut appeler, avec taille de contexte, support des outils et prix en crédits.

Le plus rapide : juste après la création d'une clé, la page des clés d'API affiche chacun des blocs ci-dessous avec votre clé déjà remplie. Choisissez votre outil, copiez, lancez.

Chaque outil se connecte directement

Les agents de code parlent trois formats différents. Nous servons les trois, sur la même clé et les mêmes modèles.

  • Codex CLI : Responses API d'OpenAI.
  • Claude Code : Anthropic Messages API.
  • OpenCode, Continue, Aider, Cline : chat completions OpenAI.

Tout autre outil doté d'un champ d'URL de base fonctionne pareil : URL de base, clé, id de modèle.

Paramètres
settings
# OpenAI-compatible tools (chat completions or Responses API)
Base URL:  https://unbottled.ai/api/fr-FR/v1
API key:   sk-unb-YOUR_KEY
Model:     glm-5.3

# Anthropic-compatible tools (Messages API)
Base URL:  https://unbottled.ai/api/fr-FR
API key:   sk-unb-YOUR_KEY
Model:     glm-5.3
Responses API

Codex CLI

L'agent en terminal d'OpenAI. Il lit votre dépôt, lance des commandes, modifie des fichiers. Testé avec Codex CLI 0.118.0.

Codex parle la Responses API, et nous aussi. La commande unique définit le fournisseur en ligne : rien à éditer, rien à installer. Pour un usage quotidien, ajoutez la config une fois et lancez Codex avec le profil.

Une seule commande
terminal
UNBOTTLED_API_KEY="sk-unb-YOUR_KEY" codex \
  -c 'model_providers.unbottled={name="unbottled.ai",base_url="https://unbottled.ai/api/fr-FR/v1",env_key="UNBOTTLED_API_KEY",wire_api="responses"}' \
  -c model_provider=unbottled \
  -m glm-5.3
Configuration permanente
~/.codex/config.toml
[model_providers.unbottled]
name = "unbottled.ai"
base_url = "https://unbottled.ai/api/fr-FR/v1"
env_key = "UNBOTTLED_API_KEY"
wire_api = "responses"

[profiles.unbottled]
model_provider = "unbottled"
model = "glm-5.3"
Puis lancez-le
terminal
export UNBOTTLED_API_KEY="sk-unb-YOUR_KEY"
codex --profile unbottled

Changez de modèle avec -m ou avec la ligne model du profil. Gardez wire_api = "responses" : la version actuelle de Codex n'accepte rien d'autre.

Messages API

Claude Code

L'agent en terminal d'Anthropic. Il planifie, modifie, lance les tests, crée des sous-agents. Testé avec Claude Code 2.1.323.

Claude Code lit sa passerelle dans les variables d'environnement. ANTHROPIC_BASE_URL est l'URL de base sans /v1. ANTHROPIC_MODEL définit le modèle principal. Les valeurs par défaut OPUS et SONNET couvrent le sélecteur de modèle et le mode plan, la valeur par défaut HAIKU envoie les tâches de fond comme les titres de session vers un modèle bon marché, et CLAUDE_CODE_SUBAGENT_MODEL couvre les sous-agents. CLAUDE_CODE_MAX_CONTEXT_TOKENS indique à Claude Code la vraie taille de contexte d'un modèle autre que Claude, pour qu'il compacte au bon moment.

Une seule commande
terminal
ANTHROPIC_BASE_URL="https://unbottled.ai/api/fr-FR" \
ANTHROPIC_AUTH_TOKEN="sk-unb-YOUR_KEY" \
ANTHROPIC_MODEL="glm-5.3" \
ANTHROPIC_DEFAULT_OPUS_MODEL="glm-5.3" \
ANTHROPIC_DEFAULT_SONNET_MODEL="glm-5.3" \
ANTHROPIC_DEFAULT_HAIKU_MODEL="glm-5.3-flash" \
CLAUDE_CODE_SUBAGENT_MODEL="glm-5.3" \
CLAUDE_CODE_MAX_CONTEXT_TOKENS="1048576" \
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="1" \
claude
Configuration permanente
~/.claude/settings.json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://unbottled.ai/api/fr-FR",
    "ANTHROPIC_AUTH_TOKEN": "sk-unb-YOUR_KEY",
    "ANTHROPIC_MODEL": "glm-5.3",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-5.3",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-5.3",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "glm-5.3-flash",
    "CLAUDE_CODE_SUBAGENT_MODEL": "glm-5.3",
    "CLAUDE_CODE_MAX_CONTEXT_TOKENS": "1048576",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}
Puis lancez-le
terminal
claude

Vous voulez Claude lui-même ? Supprimez les lignes de modèle. Claude Code demande ses ids Claude habituels et nous les routons vers notre modèle Claude correspondant, facturé en crédits.

Claude Code envoie un énorme prompt système, plus de 30k tokens d'entrée même pour une tâche triviale. Un modèle par défaut bon marché garde la facture raisonnable.

Chat completions

OpenCode

Agent en terminal open source, avec une TUI et un mode d'exécution headless. Testé avec OpenCode 1.19.5.

Enregistrez la config sous opencode.json dans votre projet, ou sous ~/.config/opencode/opencode.json pour tous vos projets. La clé reste dans votre environnement. Ajoutez n'importe quel id de GET /v1/models à la map models, puis choisissez-en un avec /models dans la TUI.

Une seule commande
terminal
UNBOTTLED_API_KEY="sk-unb-YOUR_KEY" \
OPENCODE_CONFIG_CONTENT='{"provider":{"unbottled":{"npm":"@ai-sdk/openai-compatible","options":{"baseURL":"https://unbottled.ai/api/fr-FR/v1","apiKey":"{env:UNBOTTLED_API_KEY}"},"models":{"glm-5.3":{}}}},"model":"unbottled/glm-5.3"}' \
opencode
Configuration permanente
opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "unbottled": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "unbottled.ai",
      "options": {
        "baseURL": "https://unbottled.ai/api/fr-FR/v1",
        "apiKey": "{env:UNBOTTLED_API_KEY}"
      },
      "models": {
        "glm-5.3": { "name": "GLM-5.3" },
        "claude-sonnet-5.5": { "name": "Claude Sonnet 5.5" },
        "glm-5.3-uncensored": { "name": "GLM 5.3 Uncensored" }
      }
    }
  },
  "model": "unbottled/glm-5.3"
}
Puis lancez-le
terminal
export UNBOTTLED_API_KEY="sk-unb-YOUR_KEY"
opencode
Mettez d'abord OpenCode à jour. Les anciennes versions 1.0.x récupèrent le dernier paquet @ai-sdk/openai-compatible et plantent après le premier appel d'outil avec DecimalError: Invalid argument. La 1.19.5 fait tourner la même config sans problème.
Chat completions

Continue

Assistant de code pour VS Code et JetBrains, plus la CLI cn. Testé avec Continue 1.5.47.

Configuration permanente
config.yaml
name: unbottled
version: 1.0.0
schema: v1
models:
  - name: GLM-5.3
    provider: openai
    model: glm-5.3
    apiBase: https://unbottled.ai/api/fr-FR/v1
    apiKey: ${{ secrets.UNBOTTLED_API_KEY }}
    roles: [chat, edit, apply]
Puis lancez-le
terminal
export UNBOTTLED_API_KEY="sk-unb-YOUR_KEY"
cn --config ./config.yaml

secrets.UNBOTTLED_API_KEY est résolu depuis votre environnement. Ajoutez -p avec un prompt pour une exécution headless. L'extension IDE lit ~/.continue/config.yaml : mettez-y la même entrée de modèle.

Chat completions

Aider

Du pair programming dans votre terminal, commits compris. Testé avec Aider 0.86.2.

Une commande, aucun fichier de config. Aider veut openai/ devant l'id du modèle et le retire avant de nous appeler. --edit-format diff garde les modifications petites ; sans lui, Aider renvoie des fichiers entiers pour les ids de modèles qu'il ne connaît pas. Indiquez les fichiers à modifier sur la ligne de commande, comme d'habitude avec Aider.

Une seule commande
terminal
OPENAI_API_BASE="https://unbottled.ai/api/fr-FR/v1" \
OPENAI_API_KEY="sk-unb-YOUR_KEY" \
aider --model openai/glm-5.3 --edit-format diff --no-show-model-warnings
Chat completions

Cline

Agent de code autonome, dans VS Code et en CLI. Testé avec Cline 3.0.74.

Deux commandes avec la CLI Cline : enregistrez le fournisseur une fois, puis lancez cline. URL de base, clé et id de modèle : les trois mêmes valeurs que partout ailleurs.

Une seule commande
terminal
cline auth -p openai -k "sk-unb-YOUR_KEY" -b "https://unbottled.ai/api/fr-FR/v1" -m glm-5.3
Puis lancez-le
terminal
cline

Quel modèle pour quelle tâche

Tous ces modèles appellent des outils, ce dont les agents ont besoin. Les ids sont ce qui va dans votre config.

Problèmes difficiles

Gros refactorings, codebases inconnues, débogage en plusieurs étapes. Prix en crédits plus élevés, moins de fausses pistes.

  • claude-sonnet-5.5Claude Sonnet 5.5
  • claude-opus-5.5Claude Opus 5.5
  • gpt-6.1-solGPT-6.1 Sol
  • kimi-k3.1-proKimi K3.1 Pro
  • deepseek-v4-proDeepSeek V4 Pro

Bon marché et rapides

Renommages, tests, code passe-partout, tâches de fond. Une fraction du prix d'un modèle de pointe. Un bon choix par défaut pour les agents qui envoient de gros prompts.

  • glm-5.3GLM-5.3
  • glm-5.3-flashGLM-5.3 Flash
  • qwen-3.8-flashQwen 3.8 Flash
  • claude-haiku-5.5Claude Haiku 5.5

Non censurés

Le même workflow d'agent, sans refus réflexe. Analyse d'exploits, outils de red team, pipelines de fiction pour adultes, scrapers sur lesquels les autres modèles vous font la morale. Vous restez responsable de ce que vous construisez.

  • glm-5.3-uncensoredGLM 5.3 Uncensored
  • venice-deepseek-v4.1-flash-uncensoredDeepSeek V4.1 Flash Uncensored
  • qwen-3.6-plus-uncensoredQwen 3.6 Plus Uncensored
  • venice-uncensoredVenice Uncensored 1.2
Les ids changent à mesure que les modèles sont remplacés. GET /v1/models fait foi : si un id n'est pas listé pour votre clé, l'API renvoie 404 model_not_found. La seule correspondance automatique concerne Claude Code : ses ids Claude intégrés pointent vers notre Claude le plus récent de la même famille.

Les pièges que nous avons rencontrés

Pour que vous n'ayez pas à le faire.

  • Copiez l'URL de base à l'identique, /api/<locale>/v1 compris. Sans la locale, vous obtenez une redirection que certains clients ignorent. Sans /api, vous obtenez une page HTML au lieu de JSON.
  • Claude Code reçoit l'URL de base sans /v1. Avec /v1, il appelle /v1/v1/messages et prend un 404.
  • Utilisez l'id exact de GET /v1/models, comme glm-5.3. Aider veut openai/ devant. Les ids Claude intégrés de Claude Code sont redirigés pour vous vers notre Claude le plus récent de la même famille. Tout autre id inconnu renvoie 404 model_not_found.
  • Un HTTP 402 avec paid_plan_required signifie que le compte n'a encore ni formule ni achat de crédits. N'importe quelle formule règle le problème.
  • Un modèle sans support des outils renvoie 400 tools_not_supported dès que l'agent envoie des outils. Vérifiez supports_tools dans GET /v1/models.
  • Chaque clé autorise 60 requêtes par minute. Les agents enchaînent beaucoup de petits appels. Si vous prenez un 429, donnez à l'agent sa propre clé.

Branché en une commande.

Créez une clé, copiez le bloc de votre outil, choisissez un modèle. La documentation de l'API couvre chaque endpoint, chaque champ, chaque code d'erreur et chaque détail du streaming.

Retour au blog