Domů → Návody → Codex s vlastním API: nastavení config.toml pro Codex CLI a Codex desktop

Codex s vlastním API: nastavení config.toml pro Codex CLI a Codex desktop

Codex čte poskytovatele z jediného souboru. Pět řádků konfigurace a jedna proměnná prostředí přepnou zároveň nástroj příkazové řádky i desktopovou aplikaci — a většina selhání pochází z proměnné, ne z konfigurace.

Konfigurace

Přidejte poskytovatele do config.toml a nastavte ho jako výchozího:

model = "gpt-6.1-sol"
model_provider = "apiclan"
model_reasoning_effort = "medium"

[model_providers.apiclan]
name = "APICLAN"
base_url = "https://apiclan.us/v1"
env_key = "APICLAN_API_KEY"
wire_api = "responses"

Záleží na třech detailech. base_url končí na /v1, protože Codex si /responses přidává sám. wire_api = "responses" zajistí, že Codex používá Responses API, kterou tato brána podporuje. A env_key je název proměnné prostředí, ne samotný klíč.

Kde je soubor

• macOS / Linux: ~/.codex/config.toml
• Windows: %USERPROFILE%\.codex\config.toml

Pokud složka a soubor neexistují, vytvořte je. Desktopová aplikace Codex čte stejný soubor jako nástroj příkazové řádky, jedna úprava tedy platí pro oba. Pokud nechcete upravovat TOML ručně, CC Switch ho může zapsat za vás — viz průvodce desktopovými aplikacemi.

Nastavení klíče tak, aby ho Codex viděl

macOS / Linux — přidejte ho do profilu shellu:

echo 'export APICLAN_API_KEY=sk-your-key' >> ~/.zshrc
source ~/.zshrc

Windows — uložte ho pro svůj uživatelský účet:

setx APICLAN_API_KEY "sk-your-key"

Tady se většina nastavení rozbije. Proměnná nastavená přes export nebo $env: existuje jen v daném terminálu; desktopová aplikace spuštěná z Docku nebo nabídky Start ji nikdy neuvidí. setx ve Windows ji uloží trvale, ale načtou ji jen programy spuštěné potom — Codex úplně ukončete a znovu otevřete.

Volba modelu a úrovně uvažování

Změňte model v konfiguraci, nebo přepněte v relaci příkazem /model:

Model	Vhodný pro
gpt-6.1-sol, gpt-5.6-terra	Každodenní programování, úpravy, testy — nejlevnější na volání
gpt-5.6-sol	Když máte prompty vyladěné pro GPT-5.6
gpt-6-astra	Těžké problémy, kde lepší odpověď stojí za pětinásobnou cenu

model_reasoning_effort přijímá low, medium, high a xhigh. Vyšší úroveň píše víc: u gpt-5.6-sol zde mediánové volání při high vrátilo 373 výstupních tokenů oproti 139 při medium — 2,7krát víc, vše účtováno jako výstup. Začněte na medium. Ceny najdete v průvodci cenami API OpenAI.

Jak tu vypadá provoz z Codexu

Za posledních 30 dní pocházelo 87 % všech volání GPT na této bráně z Codexu, každé přes /v1/responses se streamováním. Mediánové volání:

• neslo asi 67 000 tokenů kontextu, z toho 86 % z cache
• trvalo celkem 14 sekund, první token po 10
• vrátilo 214 výstupních tokenů

Čtyři nejčastější chyby

• 401 Unauthorized → Codex nevidí APICLAN_API_KEY. Nastavte ji podle návodu výše a Codex úplně restartujte. echo $APICLAN_API_KEY ve stejném prostředí by měl klíč vypsat.
• 404 nebo stránka HTML → base_url chybí /v1, nebo ho obsahuje dvakrát.
• model not found → název modelu je špatně, nebo váš klíč patří do skupiny, která model nemá. Platí seznam z GET https://apiclan.us/v1/models.
• stream disconnected nebo vypršení času u dlouhých úloh → velmi dlouhé uvažování přesáhne trpělivost proxy. Změňte base_url na https://api.apiclan.us/v1, která obchází 100sekundový limit.

Claude Code se řídí opačnou konvencí — bez /v1 — popsanou v průvodci base URL pro Claude Code.

Začněte je používat

Žádné předplatné, žádné měsíční minimum, žádný hovor s obchodníkem. Dobijte v USDT a plaťte za to, co spotřebujete — 1 USDT jsou 2 kredity API zůstatku.

Přečíst 30sekundový rychlý start

Jazyk: English · 简体中文 · 繁體中文 · 日本語 · 한국어 · Deutsch · Français · Español · Türkçe · Português · Italiano · Bahasa Indonesia · Tiếng Việt · Bahasa Melayu · Polski · Čeština · فارسی · Русский

Ceny na této stránce se doplňují automaticky ze skutečných fakturačních dat. Podmínky třetích stran citujeme z jejich dokumentace.