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.
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.
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.
export UNBOTTLED_API_KEY="sk-unb-YOUR_KEY"
curl https://unbottled.ai/api/fr-FR/v1/models \
-H "Authorization: Bearer $UNBOTTLED_API_KEY"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.
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.
# 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.3Codex 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.
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[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"export UNBOTTLED_API_KEY="sk-unb-YOUR_KEY"
codex --profile unbottledChangez 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.
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.
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{
"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"
}
}claudeVous 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.
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.
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{
"$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"
}export UNBOTTLED_API_KEY="sk-unb-YOUR_KEY"
opencodeContinue
Assistant de code pour VS Code et JetBrains, plus la CLI cn. Testé avec Continue 1.5.47.
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]export UNBOTTLED_API_KEY="sk-unb-YOUR_KEY"
cn --config ./config.yamlsecrets.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.
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.
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-warningsCline
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.
cline auth -p openai -k "sk-unb-YOUR_KEY" -b "https://unbottled.ai/api/fr-FR/v1" -m glm-5.3clineQuel 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 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.