# Claude Code CLI — Configuration with OmniRoute (Slovenčina)

🌐 **Languages:** 🇺🇸 [English](../../../../guides/CLAUDE-CODE-CONFIGURATION.md) · 🇪🇹 [am](../../../am/docs/guides/CLAUDE-CODE-CONFIGURATION.md) · 🇸🇦 [ar](../../../ar/docs/guides/CLAUDE-CODE-CONFIGURATION.md) · 🇦🇿 [az](../../../az/docs/guides/CLAUDE-CODE-CONFIGURATION.md) · 🇧🇬 [bg](../../../bg/docs/guides/CLAUDE-CODE-CONFIGURATION.md) · 🇧🇩 [bn](../../../bn/docs/guides/CLAUDE-CODE-CONFIGURATION.md) · 🇧🇦 [bs](../../../bs/docs/guides/CLAUDE-CODE-CONFIGURATION.md) · 🇨🇿 [cs](../../../cs/docs/guides/CLAUDE-CODE-CONFIGURATION.md) · 🇩🇰 [da](../../../da/docs/guides/CLAUDE-CODE-CONFIGURATION.md) · 🇩🇪 [de](../../../de/docs/guides/CLAUDE-CODE-CONFIGURATION.md) · 🇬🇷 [el](../../../el/docs/guides/CLAUDE-CODE-CONFIGURATION.md) · 🇪🇸 [es](../../../es/docs/guides/CLAUDE-CODE-CONFIGURATION.md) · 🇪🇪 [et](../../../et/docs/guides/CLAUDE-CODE-CONFIGURATION.md) · 🇮🇷 [fa](../../../fa/docs/guides/CLAUDE-CODE-CONFIGURATION.md) · 🇫🇮 [fi](../../../fi/docs/guides/CLAUDE-CODE-CONFIGURATION.md) · 🇫🇷 [fr](../../../fr/docs/guides/CLAUDE-CODE-CONFIGURATION.md) · 🇮🇪 [ga](../../../ga/docs/guides/CLAUDE-CODE-CONFIGURATION.md) · 🇮🇳 [gu](../../../gu/docs/guides/CLAUDE-CODE-CONFIGURATION.md) · 🇳🇬 [ha](../../../ha/docs/guides/CLAUDE-CODE-CONFIGURATION.md) · 🇮🇱 [he](../../../he/docs/guides/CLAUDE-CODE-CONFIGURATION.md) · 🇮🇳 [hi](../../../hi/docs/guides/CLAUDE-CODE-CONFIGURATION.md) · 🇭🇷 [hr](../../../hr/docs/guides/CLAUDE-CODE-CONFIGURATION.md) · 🇭🇺 [hu](../../../hu/docs/guides/CLAUDE-CODE-CONFIGURATION.md) · 🇦🇲 [hy](../../../hy/docs/guides/CLAUDE-CODE-CONFIGURATION.md) · 🇮🇩 [id](../../../id/docs/guides/CLAUDE-CODE-CONFIGURATION.md) · 🇳🇬 [ig](../../../ig/docs/guides/CLAUDE-CODE-CONFIGURATION.md) · 🇮🇹 [it](../../../it/docs/guides/CLAUDE-CODE-CONFIGURATION.md) · 🇯🇵 [ja](../../../ja/docs/guides/CLAUDE-CODE-CONFIGURATION.md) · 🇬🇪 [ka](../../../ka/docs/guides/CLAUDE-CODE-CONFIGURATION.md) · 🇰🇭 [km](../../../km/docs/guides/CLAUDE-CODE-CONFIGURATION.md) · 🇮🇳 [kn](../../../kn/docs/guides/CLAUDE-CODE-CONFIGURATION.md) · 🇰🇷 [ko](../../../ko/docs/guides/CLAUDE-CODE-CONFIGURATION.md) · 🇱🇹 [lt](../../../lt/docs/guides/CLAUDE-CODE-CONFIGURATION.md) · 🇱🇻 [lv](../../../lv/docs/guides/CLAUDE-CODE-CONFIGURATION.md) · 🇮🇳 [ml](../../../ml/docs/guides/CLAUDE-CODE-CONFIGURATION.md) · 🇮🇳 [mr](../../../mr/docs/guides/CLAUDE-CODE-CONFIGURATION.md) · 🇲🇾 [ms](../../../ms/docs/guides/CLAUDE-CODE-CONFIGURATION.md) · 🇲🇹 [mt](../../../mt/docs/guides/CLAUDE-CODE-CONFIGURATION.md) · 🇲🇲 [my](../../../my/docs/guides/CLAUDE-CODE-CONFIGURATION.md) · 🇳🇵 [ne](../../../ne/docs/guides/CLAUDE-CODE-CONFIGURATION.md) · 🇳🇱 [nl](../../../nl/docs/guides/CLAUDE-CODE-CONFIGURATION.md) · 🇳🇴 [no](../../../no/docs/guides/CLAUDE-CODE-CONFIGURATION.md) · 🇮🇳 [or](../../../or/docs/guides/CLAUDE-CODE-CONFIGURATION.md) · 🇮🇳 [pa](../../../pa/docs/guides/CLAUDE-CODE-CONFIGURATION.md) · 🇵🇭 [phi](../../../phi/docs/guides/CLAUDE-CODE-CONFIGURATION.md) · 🇵🇱 [pl](../../../pl/docs/guides/CLAUDE-CODE-CONFIGURATION.md) · 🇵🇹 [pt](../../../pt/docs/guides/CLAUDE-CODE-CONFIGURATION.md) · 🇧🇷 [pt-BR](../../../pt-BR/docs/guides/CLAUDE-CODE-CONFIGURATION.md) · 🇷🇴 [ro](../../../ro/docs/guides/CLAUDE-CODE-CONFIGURATION.md) · 🇷🇺 [ru](../../../ru/docs/guides/CLAUDE-CODE-CONFIGURATION.md) · 🇱🇰 [si](../../../si/docs/guides/CLAUDE-CODE-CONFIGURATION.md) · 🇸🇮 [sl](../../../sl/docs/guides/CLAUDE-CODE-CONFIGURATION.md) · 🇷🇸 [sr](../../../sr/docs/guides/CLAUDE-CODE-CONFIGURATION.md) · 🇸🇪 [sv](../../../sv/docs/guides/CLAUDE-CODE-CONFIGURATION.md) · 🇰🇪 [sw](../../../sw/docs/guides/CLAUDE-CODE-CONFIGURATION.md) · 🇮🇳 [ta](../../../ta/docs/guides/CLAUDE-CODE-CONFIGURATION.md) · 🇮🇳 [te](../../../te/docs/guides/CLAUDE-CODE-CONFIGURATION.md) · 🇹🇭 [th](../../../th/docs/guides/CLAUDE-CODE-CONFIGURATION.md) · 🇹🇷 [tr](../../../tr/docs/guides/CLAUDE-CODE-CONFIGURATION.md) · 🇺🇦 [uk-UA](../../../uk-UA/docs/guides/CLAUDE-CODE-CONFIGURATION.md) · 🇵🇰 [ur](../../../ur/docs/guides/CLAUDE-CODE-CONFIGURATION.md) · 🇺🇿 [uz](../../../uz/docs/guides/CLAUDE-CODE-CONFIGURATION.md) · 🇻🇳 [vi](../../../vi/docs/guides/CLAUDE-CODE-CONFIGURATION.md) · 🇳🇬 [yo](../../../yo/docs/guides/CLAUDE-CODE-CONFIGURATION.md) · 🇨🇳 [zh-CN](../../../zh-CN/docs/guides/CLAUDE-CODE-CONFIGURATION.md) · 🇹🇼 [zh-TW](../../../zh-TW/docs/guides/CLAUDE-CODE-CONFIGURATION.md)

---

Nasmerujte CLI **Claude Code** (`claude`) na OmniRoute — lokálne alebo na vzdialenom VPS —
s profilmi pre jednotlivé modely, analogicky k nastaveniu Codexu.

---

## Rýchly štart

```bash
# Spustenie Claude Code s lokálnym OmniRoute (automaticky zistí aktívny kontext)
omniroute launch

# So vzdialeným OmniRoute (po `omniroute connect <host>` je to automatické)
omniroute launch --remote http://192.168.0.15:20128 --api-key oma_live_xxx

# Vygenerovanie profilov pre jednotlivé modely a následné spustenie jedného z nich
omniroute setup-claude            # zapíše ~/.claude/profiles/<name>/settings.json
omniroute launch --profile glm52  # Claude Code používajúci glm/glm-5.2 cez OmniRoute
```

---

## Ako sa Claude Code pripája k bráne

Claude Code komunikuje prostredníctvom **Anthropic Messages API** a na vlastný
koncový bod sa nasmeruje pomocou premenných prostredia (nemá príznak `--base-url`):

| Premenná                                     | Účel                                                                                              |
| -------------------------------------------- | ------------------------------------------------------------------------------------------------- |
| `ANTHROPIC_BASE_URL`                         | Koreňová URL brány (Claude Code pridá `/v1/messages`). **Bez prípony `/v1`.**                     |
| `ANTHROPIC_AUTH_TOKEN`                       | Odosiela sa ako `Authorization: Bearer …` — použite svoj prístupový token / API kľúč OmniRoute    |
| `ANTHROPIC_API_KEY`                          | Alternatíva: odosiela sa ako `x-api-key`. Ak sú nastavené obe, `ANTHROPIC_AUTH_TOKEN` má prednosť |
| `ANTHROPIC_MODEL`                            | Vynúti konkrétny model (prepíše predvolenú možnosť vo výbere `/model`)                            |
| `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` | `1` → natívny výber `/model` zobrazí modely `claude*`/`anthropic*` z `/v1/models`                 |
| `CLAUDE_CODE_MAX_OUTPUT_TOKENS`              | Obmedzí počet výstupných tokenov na odpoveď (napr. `65536`)                                       |
| `CLAUDE_CODE_AUTO_COMPACT_WINDOW`            | Prahová hodnota tokenov pre automatickú kompakciu                                                 |

> Premenné prostredia sa načítajú **iba raz pri spustení** — po ich zmene reštartujte Claude Code.

`omniroute launch` nastaví všetky tieto premenné za vás: z aktívneho kontextu
zistí základnú URL a token (takže po `omniroute connect <vps>` stačí použiť
`omniroute launch`), skontroluje stav servera a spustí `claude` prostredníctvom `exec`.

---

## Aliasy na vyhľadávanie — zobrazenie modelov mimo Claude vo výbere `/model`

Vyhľadávanie modelov brány v Claude Code zobrazuje iba ID, ktoré sa začínajú na
`claude` alebo `anthropic`, takže pri nastavení `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1`
natívny výber `/model` bežne zobrazuje **iba** modely Claude/Anthropic z OmniRoute —
`kimi/kimi-k2.6` ani `glm/glm-5.2` sa nikdy nezobrazia, hoci ich smerovanie funguje správne.

OmniRoute môže zrkadliť ľubovoľný povolený model (aj kombináciu) pod ID `claude/…`,
aby prešiel týmto filtrom a zobrazil sa vo výbere:

```
kimi/kimi-k2.6            →  claude/kimi/kimi-k2.6      "Kimi K2.6 (OmniRoute)"
glm/glm-5.2              →  claude/glm/glm-5.2         "GLM 5.2 (OmniRoute)"
<kombinácia "custo-otimizado"> →  claude/combo/custo-otimizado
```

Keď v Claude Code vyberiete jeden z týchto modelov, OmniRoute pred smerovaním
odstráni obal `claude/` a obnoví skutočné ID — pravé ID `claude/<real-claude-model>`
(skutočný poskytovateľ Claude OAuth) sa vždy ponechá bez zmeny.

**Táto funkcia je predvolene vypnutá** a riadi ju trojúrovňový mechanizmus
(najkonkrétnejšie nastavenie má prednosť), takže bežná inštancia OmniRoute nikdy
nezdvojnásobí svoj katalóg pre klientov, ktorí Claude Code nepoužívajú:

| Úroveň       | Kde                                                                                              |
| ------------ | ------------------------------------------------------------------------------------------------ |
| Model        | Stránka podrobností poskytovateľa → prepínač „Zobraziť v Claude Code“ pre model                  |
| Poskytovateľ | Stránka podrobností poskytovateľa → prepínač na úrovni poskytovateľa (zahŕňa všetky jeho modely) |
| Globálna     | Nastavenia → Príznaky funkcií → `EXPOSE_CC_DISCOVERY_ALIASES` (predvolene vypnuté)               |

Premenná prostredia `EXPOSE_CC_DISCOVERY_ALIASES` vynúti zapnutie globálnej
úrovne a má prednosť pred nastavením v ovládacom paneli (obrazovka Príznaky
funkcií zobrazí poznámku „aktívne prostredníctvom premennej prostredia“).
Prepínače pre jednotlivých poskytovateľov a modely toto nastavenie ďalej
spresňujú — napr. globálne vypnutie + zapnutie poskytovateľa Kimi sprístupní
iba modely Kimi.

> ⚠️ **Nesúlad kontextového okna pri modeloch mimo Claude.** Claude Code predpokladá
> kontextové okno 200K pre každé ID, ktoré nerozpozná (skutočnú veľkosť okna
> nedokáže načítať z `/v1/models`). Pre model s väčším oknom (napr. 256K pri Kimi K2)
> nastavte `CLAUDE_CODE_AUTO_COMPACT_WINDOW` na hodnotu nižšiu než skutočná veľkosť
> okna modelu, aby sa automatická kompakcia nespustila predčasne. Vyššie uvedené
> vygenerované profily to už nastavujú osobitne pre každý model.

---

## Blok úvodného nastavenia na paneli

Karta nástroja Claude (**Panel → Kód CLI**) zobrazuje presný fragment `settings.json`
pre túto inštanciu vedľa informačného tlačidla aliasu zisťovania a s tlačidlom na kopírovanie:

```jsonc
{
  "env": {
    "ANTHROPIC_BASE_URL": "http://<váš OmniRoute>:20128",
    "ANTHROPIC_AUTH_TOKEN": "<váš kľúč API OmniRoute>",
    "CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY": "1",
  },
}
```

Základná URL je adresa rozpoznaná kartou (vrátane vlastnej hodnoty, ktorú ste zadali), už
normalizovaná — bez prípony `/v1` a bez koncovej lomky. **Kľúč sa nikdy nezobrazuje**: blok obsahuje
zástupný text, takže snímka obrazovky ani vložený úryvok ho nemôžu prezradiť. Nahraďte ho svojím kľúčom.

Pridajte `CLAUDE_CODE_AUTO_COMPACT_WINDOW` do rovnakého bloku `env` pre každý model, ktorého skutočné
kontextové okno nemá veľkosť 200K — Claude Code predpokladá veľkosť 200K pre každý identifikátor, ktorý
nerozpozná, takže automatická kompakcia by sa inak spustila v nesprávnom bode (pozrite si upozornenie
v predchádzajúcej časti). Tvorca úryvku prijíma aj túto hodnotu, takže volajúci, ktorý pozná veľkosť
okna cieľového modelu, ju môže priamo uviesť.

Zdroj: `src/shared/services/claudeCliConfig.ts::buildClaudeDiscoverySettingsSnippet` (čistý
tvorca, testovaný jednotkovými testami), ktorý vykresľuje `ClaudeGatewayOnboardingBlock`.

---

## Profily (`CLAUDE_CONFIG_DIR`)

Claude Code **nemá natívne súbory profilov** (na rozdiel od `~/.codex/<name>.config.toml` v Codexe).
Odporúčaným mechanizmom je `CLAUDE_CONFIG_DIR` — samostatný konfiguračný adresár pre každý
profil, pričom každý má vlastné nastavenia `settings.json`, prihlasovacie údaje, históriu a vyrovnávaciu pamäť.

`omniroute setup-claude` načíta aktuálny katalóg `/v1/models` a zapíše jeden
profil pre každý model do `~/.claude/profiles/<name>/settings.json`, pričom znova použije
**rovnaké názvy ako `setup-codex`** (`glm52`, `kimi-k27`, `deepseek-pro`, …):

```jsonc
// ~/.claude/profiles/glm52/settings.json
{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "model": "glm/glm-5.2",
  "effortLevel": "xhigh",
  "env": {
    "ANTHROPIC_BASE_URL": "http://192.168.0.15:20128",
    "ANTHROPIC_MODEL": "glm/glm-5.2",
    "CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY": "1",
    "CLAUDE_CODE_AUTO_COMPACT_WINDOW": "190000",
  },
}
```

> **Autorizačný token sa do profilu nikdy nezapisuje.** Spustite ho pomocou
> `omniroute launch --profile <name>` (tento príkaz vloží `ANTHROPIC_AUTH_TOKEN` z
> aktívneho kontextu), prípadne sami exportujte `ANTHROPIC_AUTH_TOKEN` a spustite
> `CLAUDE_CONFIG_DIR=~/.claude/profiles/<name> claude`.

**Automatická synchronizácia po zisťovaní modelov (voliteľná).** OmniRoute môže automaticky znova generovať tie isté
súbory `~/.claude/profiles/<name>/settings.json` vždy, keď synchronizácia modelov poskytovateľa
zmení aktuálny katalóg — nové alebo premenované modely tak získajú profily bez nutnosti opätovne spustiť
príkaz. Táto možnosť je **predvolene vypnutá**: zapnite ju na **paneli CLI Code** („Automatická
synchronizácia profilov CLI“ → Claude Code) alebo nastavte `OMNIROUTE_AUTO_SYNC_CLAUDE_PROFILES=true` (zohľadňuje aj
`CLI_ALLOW_CONFIG_WRITES`, ktoré je predvolene zapnuté). Keď je táto možnosť zapnutá, zapisujú sa iba súbory profilov; nikdy sa
nemení aktívna/predvolená konfigurácia Claude, autorizácia ani súbor `~/.claude/settings.json`.

### Generovanie a používanie profilov

```bash
# Lokálny OmniRoute
omniroute setup-claude

# Vzdialený VPS (vloží URL adresu VPS do každého profilu)
omniroute setup-claude --remote http://192.168.0.15:20128 --api-key oma_live_xxx

# Iba niektorí poskytovatelia
omniroute setup-claude --only glm,kimi

# Zapísať aj profily pre poskytovateľov lokálneho CLI (zcode, auggie, devin-cli-agentic,
# codex-app-server), ktorí neboli zistení na tomto hostiteľovi (pre lokálny cieľ sa predvolene preskočia)
omniroute setup-claude --include-local

# Náhľad bez zápisu
omniroute setup-claude --dry-run

# Spustenie profilu
omniroute launch --profile kimi-k27
```

---

## Úrovne modelov (voliteľné)

Claude Code smeruje požiadavky podľa úrovní schopností. Ak chcete pre jednotlivé úrovne používať rôznych poskytovateľov, namapujte každú z nich na model OmniRoute prostredníctvom premenných prostredia /
nastavení:

```bash
export ANTHROPIC_DEFAULT_OPUS_MODEL="glm/glm-5.2"
export ANTHROPIC_DEFAULT_SONNET_MODEL="kmc/kimi-k2.6"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="glm/glm-4.7-flash"
```

V opačnom prípade sa na všetko použije jediný model `ANTHROPIC_MODEL` (nastavený profilmi).

---

## Vzdialený režim

Po spustení `omniroute connect <host>` (pozrite si
[Vzdialený režim](./REMOTE-MODE.md)) sa príkazy `omniroute launch` a `omniroute setup-claude`
automaticky zamerajú na tento vzdialený server a použijú jeho prístupový token s obmedzeným rozsahom — nie sú
potrebné žiadne ďalšie príznaky. Pre jednotlivé spustenie môžete toto správanie prepísať pomocou `--remote` / `--api-key`.

---

## Riešenie problémov

**Claude Code ignoruje bránu** — overte, že `ANTHROPIC_BASE_URL` **neobsahuje
`/v1`**, a reštartujte `claude` (premenné prostredia sa načítajú iba raz pri spustení). `omniroute launch`
to vykoná za vás.

**Výber `/model` je prázdny / chýbajú modely brány** — vyžaduje sa Claude Code
v2.1.219+ a `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1`. Vo výbere sa zobrazia iba identifikátory modelov `claude*` /
`anthropic*`; akýkoľvek iný model môžete vynútiť pomocou
`ANTHROPIC_MODEL=<id>` (presne to robia profily).

**`400 Ambiguous model 'claude-…'`** — Claude Code vždy odosiela **identifikátory modelov bez predpony**
(napr. `claude-opus-4-8`), takže keď sú pripojení poskytovatelia Claude Code (`cc/…`) aj
Claude (`claude/…`), identifikátor bez predpony zodpovedá dvom trasám a
OmniRoute odmietne hádať. Môžete to vyriešiť jedným z dvoch spôsobov: nastavte identifikátor s predponou pomocou
`ANTHROPIC_MODEL=cc/claude-opus-4-8` alebo povoľte možnosť **Uprednostniť Claude Code pre
modely Claude bez predpony** — prepínač na stránke poskytovateľa Claude alebo
`OMNIROUTE_PREFER_CLAUDE_CODE_FOR_UNPREFIXED_CLAUDE_MODELS=true` (predvolene vypnuté;
pozrite si [Prostredie](../reference/ENVIRONMENT.md)) — ktorá namiesto toho smeruje identifikátory `claude-*`
bez predpony do Claude Code. Explicitné predpony poskytovateľov majú vždy prednosť.

**Chyby overenia** — profil neobsahuje žiadny token. Použite `omniroute launch --profile`
(vloží ho) alebo exportujte `ANTHROPIC_AUTH_TOKEN`.

**Profily nie sú izolované** — každý profil predstavuje odlišný adresár `CLAUDE_CONFIG_DIR`;
overte, že `echo $CLAUDE_CONFIG_DIR` v rámci relácie ukazuje na
`~/.claude/profiles/<name>`.