Aiberm logo
Connexion

Configuration de Codex CLI

Découvrez comment configurer Codex CLI pour utiliser l’API Aiberm. Ce guide couvre l’installation et la configuration sous Windows, macOS et Linux.

Qu’est-ce que Codex CLI ?

Codex CLI est l’interface en ligne de commande d’OpenAI conçue pour les tâches de terminal liées au code. Elle privilégie une sortie prête pour l’ingénierie, avec des modifications de code plus claires et actionnables que les outils de chat généraux. En la configurant pour utiliser Aiberm, vous pouvez accéder à plusieurs modèles d’IA via un point de terminaison économique.

Prérequis

Avant de commencer, assurez-vous de disposer :

Installation

Installez Codex CLI globalement avec npm :

npm install -g @openai/codex

Vérifier l’installation :

codex --version

Cela devrait afficher le numéro de version.

Configuration

Codex CLI utilise un fichier config.toml pour la configuration. L’emplacement du répertoire de configuration varie selon le système d’exploitation :

  • Windows : %userprofile%\.codex
  • macOS/Linux : ~/.codex

Méthode 1 : Configuration manuelle

Accédez au répertoire de configuration et créez ou modifiez config.toml :

macOS/Linux :

mkdir -p ~/.codex
nano ~/.codex/config.toml

Windows :

mkdir $env:USERPROFILE\.codex -Force
notepad $env:USERPROFILE\.codex\config.toml

Ajoutez la configuration suivante :

model = "gpt-5.6-sol"
model_provider = "aiberm"
model_reasoning_effort = "xhigh"

[model_providers.aiberm]
name = "Aiberm API"
base_url = "https://aiberm.com/v1"
experimental_bearer_token = "sk-your-aiberm-api-key"
wire_api = "responses"
supports_websockets = false

Important : Remplacez sk-your-aiberm-api-key par votre véritable clé API Aiberm. La clé est enregistrée en clair dans config.toml. Ne validez pas ce fichier dans Git et ne le partagez avec personne.

Méthode 2 : Configuration en une commande

macOS/Linux :

mkdir -p ~/.codex && cat > ~/.codex/config.toml << 'EOF'
model = "gpt-5.6-sol"
model_provider = "aiberm"
model_reasoning_effort = "xhigh"

[model_providers.aiberm]
name = "Aiberm API"
base_url = "https://aiberm.com/v1"
experimental_bearer_token = "sk-your-aiberm-api-key"
wire_api = "responses"
supports_websockets = false
EOF

Windows PowerShell :

$configPath = "$env:USERPROFILE\.codex"
New-Item -ItemType Directory -Force -Path $configPath | Out-Null
@"
model = "gpt-5.6-sol"
model_provider = "aiberm"
model_reasoning_effort = "xhigh"

[model_providers.aiberm]
name = "Aiberm API"
base_url = "https://aiberm.com/v1"
experimental_bearer_token = "sk-your-aiberm-api-key"
wire_api = "responses"
supports_websockets = false
"@ | Out-File -FilePath "$configPath\config.toml" -Encoding utf8

Important : Remplacez sk-your-aiberm-api-key dans la configuration par votre véritable clé API Aiberm. La clé est enregistrée en clair dans config.toml. Ne validez pas ce fichier dans Git et ne le partagez avec personne.

Vérifier la configuration

Vérifier l’installation de Node.js :

node -v
npm -v

Vérifier l’installation de Codex CLI :

codex --version

Tester la connexion API :

codex "Hi"

Si la configuration est correcte, Codex CLI devrait répondre via l’API Aiberm.

Dépannage

Erreur 401 Unauthorized

  • Vérifiez que votre clé API est correcte : Console → API Keys
  • Assurez-vous que experimental_bearer_token contient votre véritable clé API Aiberm et que l’espace réservé n’a pas été enregistré tel quel

Erreur 403 Forbidden

  • Vérifiez la validité de votre clé API
  • Vérifiez le solde de votre compte sur https://aiberm.com/console
  • Assurez-vous que votre clé API a accès au modèle demandé

Erreurs réseau

  • Vérifiez votre connexion Internet
  • Vérifiez si vous pouvez accéder à https://aiberm.com dans votre navigateur
  • Assurez-vous que votre pare-feu autorise les connexions HTTPS sortantes
  • Confirmez que le base_url dans config.toml est correct : https://aiberm.com/v1

La configuration ne prend pas effet

  • Redémarrez votre terminal après avoir modifié config.toml
  • Validez le formatage de la syntaxe TOML (pas d’espaces superflus, guillemets corrects)
  • Vérifiez que l’emplacement du fichier de configuration est correct pour votre système d’exploitation
  • Assurez-vous que le fichier est enregistré sous config.toml (et non config.toml.txt)

Commande Codex introuvable

macOS/Linux :

# Check if npm global bin is in PATH
npm config get prefix

# If needed, add to PATH in ~/.zshrc or ~/.bashrc:
export PATH="$(npm config get prefix)/bin:$PATH"

Windows :

  • Vérifiez que le chemin global npm est dans le PATH système
  • Redémarrez le terminal après l’installation npm
Modifier cette page sur GitHub