Codex CLI einrichten

Erfahren Sie, wie Sie die Codex CLI für die Aiberm-API konfigurieren. Diese Anleitung behandelt Installation und Konfiguration für Windows, macOS und Linux.

Was ist die Codex CLI?

Die Codex CLI ist die Kommandozeilenschnittstelle von OpenAI für codebezogene Terminalaufgaben. Sie legt den Schwerpunkt auf praxisnahe Ausgaben mit klareren, umsetzbaren Codeänderungen als allgemeine Chat-Tools. Durch die Konfiguration für Aiberm können Sie über einen kosteneffizienten Endpunkt auf mehrere KI-Modelle zugreifen.

Voraussetzungen

Bevor Sie beginnen, stellen Sie sicher, dass Sie Folgendes haben:

• Ein Aiberm-Konto (Hier registrieren)
• Einen Aiberm-API-Schlüssel (Schlüssel holen)
• Node.js v20 oder höher mit npm

Installation

Installieren Sie die Codex CLI global mit npm:

npm install -g @openai/codex

Installation prüfen:

codex --version

Damit sollte die Versionsnummer angezeigt werden.

Konfiguration

Die Codex CLI verwendet eine Datei config.toml für die Konfiguration. Der Speicherort des Konfigurationsverzeichnisses hängt vom Betriebssystem ab:

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

Methode 1: Manuelle Konfiguration

Wechseln Sie ins Konfigurationsverzeichnis und erstellen oder bearbeiten Sie config.toml:

macOS/Linux:

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

Windows:

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

Fügen Sie die folgende Konfiguration hinzu:

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

Wichtig: Ersetzen Sie sk-your-aiberm-api-key durch Ihren echten Aiberm-API-Schlüssel. Der Schlüssel wird im Klartext in config.toml gespeichert. Committen Sie diese Datei nicht in Git und teilen Sie sie nicht mit anderen.

Methode 2: Konfiguration mit einem Befehl

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

Wichtig: Ersetzen Sie sk-your-aiberm-api-key in der Konfiguration durch Ihren echten Aiberm-API-Schlüssel. Der Schlüssel wird im Klartext in config.toml gespeichert. Committen Sie diese Datei nicht in Git und teilen Sie sie nicht mit anderen.

Konfiguration prüfen

Node.js-Installation prüfen:

node -v
npm -v

Codex-CLI-Installation prüfen:

codex --version

API-Verbindung testen:

codex "Hi"

Wenn die Konfiguration korrekt ist, sollte die Codex CLI über die Aiberm-API antworten.

Fehlerbehebung

401 Unauthorized Error

• Prüfen Sie, ob Ihr API-Schlüssel korrekt ist: Konsole → API Keys
• Stellen Sie sicher, dass experimental_bearer_token Ihren echten Aiberm-API-Schlüssel enthält und der Platzhalter nicht unverändert gespeichert wurde

403 Forbidden Error

• Prüfen Sie die Gültigkeit Ihres API-Schlüssels
• Prüfen Sie Ihr Kontoguthaben unter https://aiberm.com/console
• Stellen Sie sicher, dass Ihr API-Schlüssel Zugriff auf das angeforderte Modell hat

Netzwerkfehler

• Prüfen Sie Ihre Internetverbindung
• Prüfen Sie, ob Sie https://aiberm.com im Browser öffnen können
• Stellen Sie sicher, dass Ihre Firewall ausgehende HTTPS-Verbindungen zulässt
• Bestätigen Sie, dass die base_url in config.toml korrekt ist: https://aiberm.com/v1

Konfiguration wird nicht wirksam

• Starten Sie Ihr Terminal nach dem Bearbeiten von config.toml neu
• Prüfen Sie die TOML-Syntax (keine zusätzlichen Leerzeichen, korrekte Anführungszeichen)
• Prüfen Sie, ob der Speicherort der Konfigurationsdatei für Ihr Betriebssystem korrekt ist
• Stellen Sie sicher, dass die Datei als config.toml gespeichert ist (nicht als config.toml.txt)

Codex-Befehl nicht gefunden

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:

• Prüfen Sie, ob der globale npm-Pfad im System-PATH liegt
• Starten Sie das Terminal nach der npm-Installation neu