====== CLIProxyAPI ======

//Vytvořeno: **21.8.2026** | Aktualizováno: **~~LASTMOD~~**//

[[https://github.com/router-for-me/CLIProxyAPI|CLIProxyAPI]] je lokální proxy služba v Go, která převádí rozhraní OpenAI, Gemini, Anthropic/Claude, Codex a Grok. Umožňuje použít jeden AI klient nebo coding agent s modelem přihlášeným u jiného podporovaného poskytovatele.

===== Princip =====

CLIProxyAPI stojí mezi klientem a modelem. Přijme požadavek v protokolu klienta, přeloží jej pro zvolený upstream a odpověď vrátí zpět v očekávaném formátu.

<code>
Claude Code → CLIProxyAPI → Codex/GPT, Claude, Gemini, Grok nebo jiný kompatibilní upstream
</code>

Projekt podporuje OAuth přihlášení pro Codex, Claude Code, Gemini/Antigravity a Grok Build, API klíče i vlastní OpenAI-compatible upstreamy. Podle podpory upstreamu zprostředkuje streaming, tool/function calling, multimodální vstupy a některé WebSocket scénáře.

===== Claude Code s jiným modelem =====

Pro Claude Code je podstatné, že proxy vystaví Claude-compatible endpoint a katalog modelů. Po přihlášení potřebného účtu nebo nastavení API klíče může Claude Code požadovat dostupný model podle jeho ID.

<code bash>
claude --model gpt-5.6-sol
</code>

Název modelu může být skutečné upstream ID nebo alias definovaný v konfiguraci. Alias slouží jen pro routing; není důkazem, který model požadavek skutečně obsloužil. Pro přehledný provoz je vhodné zachovat názvy podle skutečného backendu, například ''gpt-…'', ''gemini-…'' a ''claude-…''.

To znamená, že Claude Code zůstává uživatelským a agentním rozhraním, ale model, který generuje odpovědi, lze vybrat na straně proxy. Jde o překladovou vrstvu, nikoli o nativní podporu těchto modelů v Claude Code.

[[https://x.com/thsottiaux/status/2076119366647894371?s=20|Příspěvek Tibo na X]] ukazuje tento princip přes alias ''claudex'', který spouští Claude Code s modelem ''gpt-5.6-sol''.

===== Routing více účtů a modelů =====

Při více přihlašovacích údajích umí CLIProxyAPI používat round-robin, weighted round-robin nebo fill-first routing. Konfigurace obsahuje také retry, cooldown po chybách, volitelnou afinitu relace ke konkrétnímu účtu a modelové prefixy pro jednoznačné směrování.

Tato vrstva je užitečná hlavně tehdy, když je potřeba:

  * přepínat backendové modely bez změny hlavního klienta,
  * používat více účtů stejného poskytovatele,
  * směrovat různé modelové názvy na různé upstreamy,
  * provozovat klienta nad vlastním OpenAI-compatible API.

===== Bezpečnost a provoz =====

Proxy pracuje s OAuth tokeny a API klíči. Výchozí konfigurační soubor nastavuje ''host: ""'', což znamená naslouchání na všech IPv4 a IPv6 rozhraních. Pro lokální použití je bezpečnější nastavit ''127.0.0.1'' nebo ''localhost'', používat vlastní silný API klíč a nevystavovat službu ani její management rozhraní přímo do internetu.

Přihlašovací údaje se standardně ukládají do ''~/.cli-proxy-api''. Management API vyžaduje samostatný tajný klíč; pokud zůstane prázdný, management endpointy se nezpřístupní. Pluginy jsou ve výchozí konfiguraci vypnuté, protože se načítají jako důvěryhodný kód přímo do procesu.

===== Omezení =====

Překlad protokolu nemůže zaručit plnou shodu funkcí. Záleží na konkrétním modelu a upstreamu, zda správně fungují tool calls, streaming, reasoning bloky, prompt cache, dlouhé relace nebo poskytovatelem specifické funkce.

Použití OAuth předplatného přes jiný klient také automaticky neznamená oprávnění k API použití. Před nasazením je potřeba ověřit aktuální podmínky každého použitého poskytovatele.

Pokud má Codex fungovat jako samostatný specialista vedle Claude Code, místo náhrady hlavního backendu, je vhodnější [[ai:mcp:cc-codex-bridge|cc-codex-bridge]].

===== Zdroje =====

  * [[https://github.com/router-for-me/CLIProxyAPI|CLIProxyAPI – zdrojový kód a dokumentace]]
  * [[https://x.com/thsottiaux/status/2076119366647894371?s=20|Tibo na X – ukázka aliasu claudex]]