OmniRoute/docs/i18n/cs/docs/guides/CLI-INTEGRATIONS.md

CLI-INTEGRATIONS (Čeština)

🌐 Languages: 🇺🇸 English · 🇸🇦 ar · 🇦🇿 az · 🇧🇬 bg · 🇧🇩 bn · 🇩🇰 da · 🇩🇪 de · 🇪🇸 es · 🇮🇷 fa · 🇫🇮 fi · 🇫🇷 fr · 🇮🇳 gu · 🇮🇱 he · 🇮🇳 hi · 🇭🇺 hu · 🇮🇩 id · 🇮🇩 in · 🇮🇹 it · 🇯🇵 ja · 🇰🇷 ko · 🇮🇳 mr · 🇲🇾 ms · 🇳🇱 nl · 🇳🇴 no · 🇵🇭 phi · 🇵🇱 pl · 🇵🇹 pt · 🇧🇷 pt-BR · 🇷🇴 ro · 🇷🇺 ru · 🇸🇰 sk · 🇸🇪 sv · 🇰🇪 sw · 🇮🇳 ta · 🇮🇳 te · 🇹🇭 th · 🇹🇷 tr · 🇺🇦 uk-UA · 🇵🇰 ur · 🇻🇳 vi · 🇨🇳 zh-CN · 🇹🇼 zh-TW

---

---

title: "CLI Integrace — nasměrujte jakýkoli kódovací CLI na OmniRoute" version: 3.8.50 lastUpdated: 2026-08-18

CLI Integrace

OmniRoute dodává rodinu příkazů setup-*, které konfiguruje kódovací CLI (Codex, Claude Code, OpenCode, Cline, …) pro použití OmniRoute jako svého backendu — takže nástroj komunikuje s jedním koncovým bodem a OmniRoute směruje k správnému poskytovateli s automatickým zálohováním. Každý příkaz čte živý katalog modelů z běžícího OmniRoute (místního nebo vzdáleného) a zapisuje vlastní konfigurační soubor nástroje na vašem počítači. API klíč je odkazován proměnnou prostředí, kdekoliv to nástroj podporuje. Příkazy, které uchovávají místní soubor prostředí nástroje, jsou uvedeny níže.

K dispozici je také generický spouštěč — omniroute run <target> — který spouští claude, codex, aider, goose, opencode, qwen nebo gemini s odpovídajícím prostředím, aniž by zapisoval jakoukoli konfiguraci. Cíle a jejich aliasy pocházejí z kanonického manifestu bin/cli/cli-manifest.mjs (claude-code|cc|anthropic, codex-cli|openai-codex|openai, goose-cli, open-code, qwen-code, gemini-cli), a omniroute completion nabízí stejné cílové výrazy odvozené z manifestu. Dědictví per-tool spouštěče — omniroute launch (Claude Code) a omniroute launch-codex (Codex) — zůstávají k dispozici.

Onboarding poskytovatele je k dispozici ze stejného místního/vzdáleného kontextu. Příkazy API-first níže udržují autentizaci správy oddělenou od pověření poskytovatele a nikdy nevytištějí pověření ve strukturovaném výstupu:

omniroute providers add glm --credential-env GLM_API_KEY --name work
omniroute providers import ./providers.json --dry-run --json
omniroute providers auth openai
omniroute providers edit <connection-id> --default-model glm/glm-5.2
omniroute providers remove <connection-id> --yes

Pro skripty preferujte --credential-stdin nebo --credential-env; --credential je zachováno pro kontrolované místní použití. providers remove vyžaduje --yes na neinteraktivním terminálu a všech pět příkazů ctí aktivní kontext nebo globální možnosti --base-url/--api-key.

Pro jednorázové, ručně psané základní nastavení dvou nejbohatších integrací viz hloubkové analýzy per-tool:

• Konfigurace Claude Code
• Konfigurace Codex CLI
• Vzdálený režim — ovládejte vzdálený OmniRoute (VPS / Tailnet) ze svého laptopu
• VS Code Copilot Chat — rozšíření OmniCopilot; může také spouštět tyto setup-* příkazy za vás zevnitř editoru

---

Hlavní tabulka

Každý příkaz ctí aktivní kontext (nastavený pomocí omniroute connect, viz Remote Mode) nebo explicitní příznaky --remote <url> --api-key <key>. "Lokální vs vzdálený" níže znamená: bez příznaků cílí na http://localhost:20128; s --remote (nebo aktivním vzdáleným kontextem) získává katalog z tohoto serveru a zapisuje konfiguraci lokálně.

Příkaz	Nástroj	Co zapisuje	Klíčové příznaky	Lokální vs vzdálený
omniroute setup-codex	OpenAI Codex CLI	~/.codex/<name>.config.toml — jeden profil pro každý kompatibilní textový model (codex --profile <name>)	--remote --api-key --only --dry-run --port --codex-home	Oba
omniroute setup-claude	Claude Code	~/.claude/profiles/<name>/settings.json — jeden profil pro každý odpovídající model (CLAUDE_CONFIG_DIR)	--remote --api-key --only --dry-run --port --claude-home	Oba
omniroute setup-opencode	OpenCode (openai-kompatibilní)	~/.config/opencode/opencode.json — omniroute poskytovatel se všemi modely katalogu (opencode -m omniroute/<model>)	--remote --api-key --only --model --dry-run --port	Oba
omniroute setup-cline	Cline	~/.cline/data/{globalState,secrets}.json (CLI režim) + tiskne nastavení rozšíření VS Code	--remote --api-key --model --yes --dry-run --port --cline-dir	Oba
omniroute setup-kilo	Kilo Code	~/.local/share/kilo/auth.json (CLI) + slučuje kilocode.* do settings.json VS Code, pokud je přítomno	--remote --api-key --model --yes --dry-run --port --auth-path --vscode-settings	Oba
omniroute setup-continue	Continue / cn CLI	~/.continue/config.yaml — provider: openai modely, klíč přes ${{ secrets.OMNIROUTE_API_KEY }}	--remote --api-key --only --dry-run --port --config-path	Oba
omniroute setup-cursor	Cursor	Nic — tiskne kroky v aplikaci (konfigurace Cursor je neprůhledná SQLite)	--remote --api-key --only --port	Oba
omniroute setup-roo	Roo Code	~/.omniroute/roo-settings.json (import doc) + nastaví roo-cline.autoImportSettingsPath, pokud existuje settings.json VS Code	--remote --api-key --model --yes --dry-run --port --import-path --vscode-settings	Oba
omniroute setup-crush	Crush	~/.config/crush/crush.json — openai-compat poskytovatel, klíč přes $OMNIROUTE_API_KEY	--remote --api-key --only --dry-run --port --config-path	Oba
omniroute setup-goose	Goose	~/.config/goose/config.yaml (GOOSE_PROVIDER/OPENAI_HOST/GOOSE_MODEL) + tiskne recept pro prostředí	--remote --api-key --model --yes --dry-run --port --config-path	Oba
omniroute setup-aider	Aider	~/.aider.conf.yml (openai-api-base + model: openai/<id>) + tiskne recept pro prostředí	--remote --api-key --model --yes --dry-run --port --config-path	Oba
omniroute setup-qwen	Qwen Code	~/.qwen/settings.json — V4 modelProviders.openai pole + OMNIROUTE_API_KEY v ~/.qwen/.env	--remote --api-key --model --yes --dry-run --port --config-path --env-path	Oba
omniroute run <target>	Runtime launch (generic)	Nic — spouští claude/codex/aider/goose/opencode/qwen/gemini s odpovídajícím prostředím a argumenty; Qwen a Gemini používají dočasný izolovaný domov	--remote --base-url --context --provider --model --api-key --api-key-env --dry-run --json --port --profile --token	Oba
omniroute launch	Claude Code	Nic — spouští claude s ANTHROPIC_BASE_URL/ANTHROPIC_AUTH_TOKEN injektovaným	--remote --api-key --token --profile --port	Oba
omniroute launch-codex	OpenAI Codex CLI	Nic — spouští codex s poskytovatelem omniroute injektovaným pomocí -c příznaků	--remote --api-key --profile (-p) --port	Oba

Poznámky k příznakům (ověřeno ve zdroji příkazů):

• --remote <url> — získává katalog z vzdáleného OmniRoute (přepisuje --port a aktivní kontext). --api-key <key> dodává pověření pro tento server (výchozí hodnota je proměnná prostředí OMNIROUTE_API_KEY, nebo token aktivního kontextu).
• --only <patterns> — čárkami oddělené podřetězce; uchová pouze ID modelů, které odpovídají (např. --only glm,kimi). K dispozici na setup-codex, setup-claude, setup-opencode, setup-continue, setup-cursor, setup-crush.
• --dry-run — tiskne přesně to, co by bylo zapsáno, aniž by se dotýkalo souborového systému. K dispozici na každém příkazu setup-* kromě setup-cursor (který nikdy nezapisuje soubor).
• --model <id> — vyžaduje se (nebo se vybírá interaktivně) pro nástroje, které nemají automatické objevování modelů: Cline, Kilo, Roo, Goose, Qwen, Aider. Tyto nástroje také přijímají --yes pro neinteraktivní běhy (což pak vyžaduje --model). setup-opencode bere --model pro nastavení výchozího nejvyššího modelu.
• --model <id> na omniroute run následuje propojení per-target manifestu (bin/cli/cli-manifest.mjs): aider přijímá --model openai/<id> a opencode --model omniroute/<id> (prefix je přidán pouze tehdy, když id jej již nenese); qwen a gemini přijímají id doslovně; claude jej získává přes ANTHROPIC_MODEL, goose přes GOOSE_MODEL, a codex přes -c model_providers.omniroute.* argumenty. Qwen je jediným cílem běhu, který tvrdě vyžaduje --model — omniroute run qwen bez něj končí 2 s explicitní chybou.
• --port <port> — místní port OmniRoute (výchozí 20128, ignorováno, když je nastaveno --remote). Přítomno na všech setup-* a obou spouštěčích.
• Kódy ukončení omniroute run: vlastní kód ukončení podřízeného CLI je propagován doslovně; 2 = neplatné argumenty (nepodporovaný cíl, chybějící požadovaný --model, ochrana kontejneru); 127 = cílový binární soubor není v PATH; 130/143/129, když je spuštění ukončeno SIGINT/SIGTERM/SIGHUP; 1 = jiná chyba při spuštění.
• Dva spouštěče (launch, launch-codex) přijímají --profile <name> pro výběr profilu napsaného pomocí setup-claude / setup-codex, plus předávací argumenty pro podkladový claude / codex binární soubor.

Interaktivní výběr je také sdílen recepty nastavení:

# Vyberte z aktivního místního nebo vzdáleného katalogu modelů a nakonfigurujte cíl.
omniroute configure claude
omniroute configure opencode --provider glm
omniroute configure qwen --model qwen/qwen3.8-max-preview --yes

configure v současnosti deleguje na testované recepty pro codex, claude, opencode, qwen, aider, goose, cline, continue a kilo. Pouze pro IDE, MITM a pouze pro průvodce záznamy zůstávají explicitní setup-*/manuální toky a nejsou prezentovány jako spouštěcí cíle.

setup-opencode je lehká openai-kompatibilní integrace OpenCode. K dispozici je také bohatší pluginová integrace — omniroute setup opencode — která instaluje @omniroute/opencode-plugin. Jsou to různé příkazy; tabulka výše dokumentuje setup-opencode.

---

Místní použití

S OmniRoute běžícím na localhost:20128, stačí spustit příkaz pro nastavení vašeho nástroje. Katalog je načten z místního serveru.

# Codex: zapisuje profil pro každý shodný model do ~/.codex/
omniroute setup-codex
codex --profile glm52            # použijte vygenerovaný profil

# Claude Code: zapisuje profily pro každý model, poté spustí jeden
omniroute setup-claude
omniroute launch --profile glm52

# OpenCode: zapisuje poskytovatele kompatibilního s openai se všemi modely katalogu
omniroute setup-opencode
export OMNIROUTE_API_KEY=sk-...  # odkazováno přes {env:OMNIROUTE_API_KEY}, nikdy na disku
opencode -m omniroute/glm/glm-5.2 "..."

# Nástroje bez automatického objevování potřebují explicitní model:
omniroute setup-aider --model glm/glm-5.2
omniroute setup-qwen --model qwen/qwen3.8-max-preview

# Náhled bez zápisu čehokoliv:
omniroute setup-continue --dry-run

Spusťte bez zápisu jakékoli konfigurace (pouze injekce prostředí):

omniroute launch                 # Claude Code → místní OmniRoute
omniroute launch-codex           # Codex CLI → místní OmniRoute
omniroute launch-codex --profile glm52
omniroute run claude --model openai/gpt-5.4
omniroute run codex --model openai/gpt-5.4 --dry-run --json
omniroute run aider --model glm/glm-5.2 -- --message "odpověď OK"
omniroute run goose --model glm/glm-5.2
omniroute run opencode --model glm/glm-5.2 -- run "odpověď OK"
omniroute run qwen --model glm/glm-5.2 -- -p "odpověď OK"
omniroute run gemini --model glm/glm-5.2 -- --skip-trust -p "odpověď OK"

# Explicitní cesta příkazu: předat cokoliv, co přijde po --
omniroute run claude -- --print-system-prompt "zkontrolujte tento rozdíl"

---

Vzdálené použití

Nasměrujte jakýkoli příkaz pro nastavení na vzdálený OmniRoute s --remote + --api-key. Katalog je načten ze vzdáleného serveru; konfigurace je zapsána na vašem místním počítači.

# OpenCode proti vzdálenému VPS, ponechte pouze glm/kimi modely
omniroute setup-opencode --remote http://192.168.0.15:20128 --api-key oma_live_xxx \
  --only glm,kimi
opencode -m omniroute/glm/glm-5.2 "..."   # nejprve exportujte OMNIROUTE_API_KEY

# Profily Codex z vzdáleného katalogu
omniroute setup-codex --remote http://192.168.0.15:20128 --api-key oma_live_xxx

# Spusťte CLI přímo proti vzdálenému
omniroute launch       --remote http://192.168.0.15:20128 --api-key oma_live_xxx
omniroute launch-codex --remote http://192.168.0.15:20128 --api-key oma_live_xxx

Místo předávání --remote/--api-key pokaždé, přihlaste se jednou a nechte aktivní kontext je dodávat automaticky:

omniroute connect 192.168.0.15        # vytvoří token s omezeným rozsahem, uloží kontext
omniroute setup-codex                 # ← nyní používá vzdálený katalog
omniroute setup-opencode              # ← stejné
omniroute launch                      # ← Claude Code proti vzdálenému

Viz Vzdálený režim pro kontexty, rozsahy a správu tokenů.

---

Konvence základní URL (které nástroje chtějí /v1)

OmniRoute vystavuje OpenAI rozhraní na /v1, Anthropic rozhraní na kořenové úrovni, a nativní Gemini rozhraní na /v1beta. Každá integrace je připojena k formátu, který je pro její nástroj očekáván (ověřeno ve zdroji příkazu):

Integrace	Základní URL zapsáno	/v1?
setup-cline (openAiBaseUrl)	kořen	Ne — Cline přidává /v1/chat/completions
setup-goose (OPENAI_HOST)	kořen	Ne — Goose přidává cestu
setup-aider (OPENAI_API_BASE)	kořen	Ne — LiteLLM přidává /v1/chat/completions
setup-kilo, setup-roo, setup-continue, setup-crush, setup-cursor	s /v1	Ano
setup-claude (ANTHROPIC_BASE_URL), launch	kořen	Ne — Claude Code přidává /v1/messages
setup-codex, launch-codex (model_providers.omniroute.base_url)	s /v1	Ano
setup-qwen (modelProviders.openai[].baseUrl)	s /v1	Ano
run gemini (GOOGLE_GEMINI_BASE_URL)	kořen	Ne — SDK přidává /v1beta/models/…

---

Udržování nativních závislostí při aktualizaci: --include=optional

Když aktualizujete pomocí omniroute update (po potvrzení nebo s --apply), OmniRoute spouští instalaci s --include=optional zabudovaným:

npm install -g omniroute@latest --include=optional

To není příznak, který předáváte omniroute update — je vždy aplikován aktualizátorem. Zaručuje, že optionalDependencies (better-sqlite3, keytar, tls-client, LLMLingua SLM stack) přežijí aktualizaci, i když je vaše npm konfigurace nastavena na omit=optional, což by jinak tiše odstranilo nativní SQLite ovladač a vazbu na OS-keyring. Chcete-li si prohlédnout přesný příkaz bez aplikace:

omniroute update --dry-run
# [DRY RUN] By běžel: npm install -g omniroute@latest --include=optional

Další příznaky omniroute update (ověřeno ve zdrojovém kódu): --check (ukončí s 1, pokud je zastaralý), --apply (nainstaluje bez výzvy), --changelog, --no-backup, --yes.

---

Google Gemini CLI přes omniroute run gemini

Smlouva ověřena proti @google/gemini-cli 0.50.0: CLI respektuje GOOGLE_GEMINI_BASE_URL a vydává POST /v1beta/models/<model>:generateContent (a :streamGenerateContent?alt=sse) proti němu — přesně jako nativní Gemini rozhraní OmniRoute (/v1beta). omniroute run gemini to automaticky propojuje:

• GOOGLE_GEMINI_BASE_URL → aktivní základní URL OmniRoute (kořen, žádné /v1);
• GEMINI_API_KEY → vyřešené pověření OmniRoute (volba/env/context);
• dočasný izolovaný GEMINI_CLI_HOME, jehož .gemini/settings.json vybírá autentizaci gemini-api-key, takže uložená relace Google OAuth (Code Assist) nikdy nepřepíše spuštění řízené OmniRoute — odstraněno po ukončení;
• hygiena prostředí: dětské prostředí je očištěno od GOOGLE_API_KEY, GOOGLE_GENAI_USE_VERTEXAI a GOOGLE_GENAI_USE_GCA (což by přesměrovalo autentizaci na Vertex/Code Assist), a GEMINI_DEFAULT_AUTH_TYPE=gemini-api-key je nastaven jako záložní — ostatní cíle run dostávají stejnou péči pro své vlastní konfliktní proměnné;
• injekce --model <id> z --provider/--model.

omniroute run gemini --model glm/glm-5.2 -- --skip-trust -p "hello"

Ochrana důvěry pracovního prostoru Gemini stále platí v bezhlavém režimu — předejte --skip-trust (nebo důvěřujte adresáři interaktivně) sami; spouštěč úmyslně neobchází tuto ochranu. Tento spouštěč je odlišný od registrace ACP (src/lib/acp/registry.ts, gemini --acp), která zůstává integrací agent-protokolu pro /dashboard/acp-agents.

---

Skutečné kouřové testy (opt-in)

Deterministické regresní testy plánu spuštění v CI (tests/unit/cli/run-command.test.ts, tests/unit/cli/run-execution.test.ts). Pro ověření SKUTEČNÝCH binárních souborů proti SKUTEČNÉMU serveru OmniRoute existuje opt-in rámec na tests/integration/upstream-cli-smoke.int.test.ts. Nikdy se nespouští automaticky (všechny podtesty přeskočí, pokud není RUN_CLI_SMOKE=1), předává pověření pomocí env-var NAME (nikdy podle hodnoty), rediguje klíčové řetězce z jakéhokoli zaznamenaného výstupu, přeskočí cíle, jejichž binární soubor není nainstalován, a klasifikuje selhání jako auth / upstream / config místo holého booleanu:

RUN_CLI_SMOKE=1 \
OMNIROUTE_SMOKE_BASE_URL="http://localhost:20128" \
OMNIROUTE_SMOKE_MODEL="<provider/model>" \
OMNIROUTE_SMOKE_API_KEY_ENV="OMNIROUTE_API_KEY" \
node --import tsx/esm --test tests/integration/upstream-cli-smoke.int.test.ts

Volitelně: OMNIROUTE_SMOKE_TARGETS="codex,opencode,qwen" omezuje testování; OMNIROUTE_SMOKE_TIMEOUT_MS přepisuje časový limit 120s na cíl.

Viz také

• Konfigurace Claude Code — hlubší průvodce Claude Code
• Konfigurace Codex CLI — jednorázové základní nastavení [model_providers.omniroute]
• Vzdálený režim — kontexty, přístupové tokeny s omezeným rozsahem, ovládání vzdáleného serveru
• Reference nástrojů CLI — kompletní katalog podporovaných nástrojů + stránky řídicího panelu
• Průvodce nastavením — metody instalace a onboarding při prvním spuštění