Zum Hauptinhalt springen
OpenAI Codex kommuniziert mit Tokios über die Responses-API. Füge Tokios als Modellanbieter in ~/.codex/config.toml hinzu, richte es auf https://api.tokios.com/v1, und Codex läuft gegen dein eigenes lokales Modell — auf Ollama, LM Studio oder einem beliebigen OpenAI-kompatiblen Backend — von überall, durch deinen privaten Tunnel.

Prerequisites

  • Ein laufender Tokios Connector, der mit deinem lokalen Modell gekoppelt ist — siehe Connector install
  • Ein registrierter Modell-Deployment-Name — siehe Register a model
  • Ein Tokios API-Schlüssel — siehe API Keys
  • OpenAI Codex installiert

Codex konfigurieren

Setze deinen Tokios-Schlüssel in der Umgebung und füge dann einen Tokios-Anbieter und ein Profil zu ~/.codex/config.toml hinzu:
~/.codex/config.toml
wire_api = "responses" und disable_response_storage = true sind beide erforderlich. Tokios stellt die Responses-Oberfläche zustandslos bereit, daher darf sich Codex nicht auf serverseitige Antwortspeicherung verlassen.
Führe dann Codex mit dem Tokios-Profil aus:
Ersetze gemma-tunnel durch den öffentlichen Modellnamen, den du in der Konsole registriert hast.

Das OpenAI Python SDK verwenden

Um dein lokales Modell programmatisch mit dem OpenAI SDK aufzurufen, richte den Client auf die Tokios-Basis-URL:
openai_tokios.py
Die Basis-URL des OpenAI SDK muss mit /v1 enden. Der Tokios-Endpunkt ist https://api.tokios.com/v1.

Fehlerbehebung

Dein sk-tok-…-Schlüssel fehlt oder ist falsch. Bestätige, dass OPENAI_API_KEY in der Umgebung gesetzt ist und dass env_key = "OPENAI_API_KEY" in config.toml übereinstimmt. Überprüfe den Schlüssel auf dem Keys-Tab — er wurde bei der Erstellung nur einmal angezeigt.
Das model in deinem config.toml-Profil stimmt mit keinem Deployment-Namen überein. Überprüfe den Models-Tab auf den genauen Namen, den du registriert hast — er beachtet Groß-/Kleinschreibung.
Der Connector für dieses Deployment ist offline oder hat sein Concurrency-Limit erreicht. Überprüfe den Connectors-Tab — der Connector muss als Online angezeigt werden, und der Rechner, auf dem er läuft, muss noch hochgefahren sein.
Bestätige, dass du --profile tokios auf der Befehlszeile übergibst. Ohne das Flag verwendet Codex sein Standardprofil, das auf OpenAIs gehostete API zeigt. Du kannst auch default_profile = "tokios" unter [general] in config.toml setzen, um es zum Standard zu machen.

Nächste Schritte

Compatible clients

Siehe Basis-URL und Schlüssel-Einrichtung für andere OpenAI- und Anthropic-kompatible Clients.

API keys

Erstelle, beschränke und rotiere sk-tok-…-Schlüssel für Teammitglieder und Agenten.