# 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) · 🇸🇰 [sk](../../../sk/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)

---

Usmerite CLI **Claude Code** (`claude`) na OmniRoute — lokalno ali na oddaljenem VPS-ju —
s profili za posamezne modele, podobno kot pri nastavitvi Codex.

---

## Hitri začetek

```bash
# Zaženi Claude Code z lokalnim OmniRoute (samodejno zazna aktivni kontekst)
omniroute launch

# Z oddaljenim OmniRoute (po `omniroute connect <host>` je to samodejno)
omniroute launch --remote http://192.168.0.15:20128 --api-key oma_live_xxx

# Ustvari profile za posamezne modele in nato zaženi enega
omniroute setup-claude            # zapiše ~/.claude/profiles/<name>/settings.json
omniroute launch --profile glm52  # Claude Code, ki prek OmniRoute uporablja glm/glm-5.2
```

---

## Kako se Claude Code poveže s prehodom

Claude Code komunicira prek API-ja **Anthropic Messages** in je na končno točko po meri
usmerjen s spremenljivkami okolja (nima zastavice `--base-url`):

| Spremenljivka                                | Namen                                                                                                           |
| -------------------------------------------- | --------------------------------------------------------------------------------------------------------------- |
| `ANTHROPIC_BASE_URL`                         | Korenski URL prehoda (Claude Code doda `/v1/messages`). **Brez pripone `/v1`.**                                 |
| `ANTHROPIC_AUTH_TOKEN`                       | Poslano kot `Authorization: Bearer …` — uporabite svoj žeton za dostop oziroma ključ API za OmniRoute           |
| `ANTHROPIC_API_KEY`                          | Alternativa: poslano kot `x-api-key`. Če sta nastavljeni obe spremenljivki, ima prednost `ANTHROPIC_AUTH_TOKEN` |
| `ANTHROPIC_MODEL`                            | Vsili določen model (preglasi privzeto izbiro iz izbirnika `/model`)                                            |
| `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` | `1` → izvorni izbirnik `/model` prikaže modele `claude*`/`anthropic*` iz `/v1/models`                           |
| `CLAUDE_CODE_MAX_OUTPUT_TOKENS`              | Omeji število izhodnih žetonov na odgovor (npr. `65536`)                                                        |
| `CLAUDE_CODE_AUTO_COMPACT_WINDOW`            | Prag števila žetonov za samodejno strnjevanje                                                                   |

> Spremenljivke okolja se preberejo **samo enkrat ob zagonu** — po njihovi spremembi znova zaženite Claude Code.

`omniroute launch` vse te spremenljivke nastavi namesto vas: osnovni URL in žeton
razreši iz aktivnega konteksta (zato po `omniroute connect <vps>` ukaz
`omniroute launch` preprosto deluje), preveri stanje strežnika in izvede `claude`.

---

## Vzdevki za odkrivanje — prikaz modelov, ki niso Claude, v izbirniku `/model`

Odkrivanje modelov prek prehoda v Claude Code izpiše samo ID-je, ki se začnejo s
`claude` ali `anthropic`, zato ob vklopljeni `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1`
izvirni izbirnik `/model` običajno prikaže **samo** OmniRoute-ove modele
Claude/Anthropic — `kimi/kimi-k2.6` ali `glm/glm-5.2` se nikoli ne pojavi, čeprav
usmerjanje deluje brez težav.

OmniRoute lahko katerega koli omogočenega modela (in kombinacije) zrcali pod ID-jem
`claude/…`, da prestane ta filter in se pojavi v izbirniku:

```
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)"
<combo "custo-otimizado"> →  claude/combo/custo-otimizado
```

Ko v Claude Code izberete enega od teh, OmniRoute pred usmerjanjem odstrani ovoj
`claude/` in povrne pravi ID — pristni ID `claude/<real-claude-model>` (dejanski
ponudnik Claude OAuth) pa vedno pusti nespremenjenega.

Privzeto se zrcalijo samo osnovni ID-ji. Ko je vklopljena opcijska funkcijska
zastavica `CATALOG_MIRROR_REFINEMENTS_ENABLED`, se različice z raven napora
razmišljanja, ki jih katalog že izpiše (npr. `codex/gpt-6-sol-high`), zrcalijo kot
vsak drug ID, tako da lahko Claude Code izbere izrecno raven napora, vgrajeni ID-ji
`auto/*`, ki jih pot zahteve ne more udejaniti, pa se ne zrcalijo. Ali so različice
z ravnjo napora sploh izpisane, še vedno določa `OMNIROUTE_DISABLE_THINKING_LEVEL_VARIANTS` —
zrcalo nikoli ne doda različice, ki je osnovni katalog nima.

**To je privzeto izklopljeno** in nadzorovano s trinivojskim mehanizmom (zmaga
najbolj specifična raven), tako da običajen OmniRoute nikoli ne podvoji svojega
kataloga za odjemalce, ki ne uporabljajo Claude Code:

| Raven    | Kje                                                                                      |
| -------- | ---------------------------------------------------------------------------------------- |
| Model    | Stran s podrobnostmi ponudnika → preklop »Prikaži v Claude Code« za posamezen model      |
| Ponudnik | Stran s podrobnostmi ponudnika → preklop na ravni ponudnika (zajema vse njegove modele)  |
| Globalno | Nastavitve → Funkcijske zastavice → `EXPOSE_CC_DISCOVERY_ALIASES` (privzeto izklopljeno) |

Okoljska spremenljivka `EXPOSE_CC_DISCOVERY_ALIASES` prisili vklop globalne ravni in
ima prednost pred nastavitvijo na nadzorni plošči (zaslon Funkcijske zastavice v tem
primeru prikaže opombo »aktivno prek okoljske spremenljivke«). Preklopa na ravni
ponudnika in modela od tu dalje natančneje določata obseg — npr. globalno
izklopljeno + ponudnik Kimi vklopljen razkrije samo Kimijeve modele.

> ⚠️ **Neujemanje okna pri modelih, ki niso Claude.** Claude Code za vsak ID, ki ga
> ne prepozna, predpostavi kontekstno okno 200K (pravega okna ne more prebrati iz
> `/v1/models`). Pri modelu z večjim oknom (npr. 256K pri Kimi K2) nastavite
> `CLAUDE_CODE_AUTO_COMPACT_WINDOW` na vrednost pod dejanskim oknom modela, da se
> samodejno strnjevanje ne sproži prezgodaj. Zgornji ustvarjeni profili to že
> naredijo za vsak model posebej.

---

## Uvodni blok na nadzorni plošči

Kartica orodja Claude (**Nadzorna plošča → Koda CLI**) prikaže točen fragment `settings.json`
za ta primerek, poleg informacijskega gumba za vzdevek odkrivanja in z gumbom za kopiranje:

```jsonc
{
  "env": {
    "ANTHROPIC_BASE_URL": "http://<vaš OmniRoute>:20128",
    "ANTHROPIC_AUTH_TOKEN": "<vaš ključ API za OmniRoute>",
    "CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY": "1",
  },
}
```

Osnovni URL je tisti, ki ga je razrešila kartica (vključno s preglasitvijo po meri, ki ste jo vnesli), in je že
normaliziran — brez pripone `/v1` in brez končne poševnice. **Ključ ni nikoli prikazan**: blok vsebuje
označbo mesta, zato ga posnetek zaslona ali prilepljen izsek ne more razkriti. Označbo mesta nadomestite s svojim ključem.

Dodajte `CLAUDE_CODE_AUTO_COMPACT_WINDOW` v isti blok `env` za vsak model, katerega dejansko
kontekstno okno ni 200K — Claude Code za vsak ID, ki ga ne prepozna, privzame 200K, zato se sicer
samodejno zgoščevanje sproži ob napačnem trenutku (glejte opozorilo v prejšnjem razdelku).
Sestavljalnik izsekov sprejme tudi to vrednost, zato jo lahko klicatelj, ki pozna velikost kontekstnega okna
ciljnega modela, neposredno vključi.

Vir: `src/shared/services/claudeCliConfig.ts::buildClaudeDiscoverySettingsSnippet` (čisti
sestavljalnik, pokrit s testi enot), ki ga prikaže `ClaudeGatewayOnboardingBlock`.

### Pripnite en račun (izbirno)

Če želite vse zahteve Claude Code poslati prek enega določenega računa ponudnika, dodajte glavo
`x-omniroute-connection` prek `ANTHROPIC_CUSTOM_HEADERS` v istem bloku `env`:

```jsonc
"ANTHROPIC_CUSTOM_HEADERS": "x-omniroute-connection: <connection id>"
```

ID kopirajte iz oznake `xxxxxxxx…` v vrstici povezave na strani ponudnika. Pripenjanje velja samo
za ID-je posameznih modelov (`provider/model`), ne pa za kombinacije. Za natančno
vedenje ob preklopu glejte [Pripenjanje računa za posamezno zahtevo](../reference/API_REFERENCE.md#account-pinning-per-request).

---

## Profili (`CLAUDE_CONFIG_DIR`)

Claude Code **nima izvornih datotek profilov** (za razliko od Codexovih `~/.codex/<name>.config.toml`).
Običajni mehanizem je `CLAUDE_CONFIG_DIR` — ločen konfiguracijski imenik za vsak
profil, vsak s svojimi nastavitvami `settings.json`, poverilnicami, zgodovino in predpomnilnikom.

`omniroute setup-claude` pridobi aktualni katalog `/v1/models` in zapiše en
profil na model v `~/.claude/profiles/<name>/settings.json`, pri čemer ponovno uporabi
**ista imena kot `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",
  },
}
```

> **Žeton za preverjanje pristnosti se nikoli ne zapiše v profil.** Zaženite z
> `omniroute launch --profile <name>` (vstavi `ANTHROPIC_AUTH_TOKEN` iz
> aktivnega konteksta) ali pa sami izvozite `ANTHROPIC_AUTH_TOKEN` in zaženite
> `CLAUDE_CONFIG_DIR=~/.claude/profiles/<name> claude`.

**Samodejna sinhronizacija po odkritju modelov (izbirno).** OmniRoute lahko samodejno znova ustvari iste
datoteke `~/.claude/profiles/<name>/settings.json` vsakič, ko sinhronizacija modelov ponudnika
spremeni aktualni katalog — tako novi ali preimenovani modeli dobijo profile brez ponovnega zagona
ukaza. Privzeto je **izklopljena**: preklopite jo na **nadzorni plošči CLI Code** ("Samodejna
sinhronizacija profilov CLI" → Claude Code) ali nastavite `OMNIROUTE_AUTO_SYNC_CLAUDE_PROFILES=true` (upošteva tudi
`CLI_ALLOW_CONFIG_WRITES`, ki je privzeto vklopljen). Ko je omogočena, zapisuje samo datoteke profilov; nikoli
ne spremeni vaše aktivne/privzete konfiguracije Claude, preverjanja pristnosti ali datoteke `~/.claude/settings.json`.

### Ustvarjanje in uporaba profilov

```bash
# Lokalni OmniRoute
omniroute setup-claude

# Oddaljeni VPS (v vsak profil vgradi URL strežnika VPS)
omniroute setup-claude --remote http://192.168.0.15:20128 --api-key oma_live_xxx

# Samo nekateri ponudniki
omniroute setup-claude --only glm,kimi

# Zapiši tudi profile za ponudnike lokalnega CLI-ja (zcode, auggie, devin-cli-agentic,
# codex-app-server), ki niso zaznani na tem gostitelju (privzeto so za lokalni cilj preskočeni)
omniroute setup-claude --include-local

# Predogled brez zapisovanja
omniroute setup-claude --dry-run

# Zaženi profil
omniroute launch --profile kimi-k27
```

---

## Ravni modelov (izbirno)

Claude Code usmerja zahteve glede na ravni zmogljivosti. Če želite za posamezne ravni uporabljati različne ponudnike, vsako raven preslikajte v model OmniRoute prek okoljskih spremenljivk /
nastavitev:

```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"
```

Sicer se za vse uporablja en sam `ANTHROPIC_MODEL` (ki ga nastavijo profili).

---

## Oddaljeni način

Ko zaženete `omniroute connect <host>` (glejte
[Oddaljeni način](./REMOTE-MODE.md)), ukaza `omniroute launch` in `omniroute setup-claude`
samodejno ciljata ta oddaljeni strežnik in uporabljata njegov žeton za dostop z omejenim obsegom — dodatne
zastavice niso potrebne. Za posamezen klic lahko to preglasite z `--remote` / `--api-key`.

---

## Odpravljanje težav

**Claude Code prezre prehod** — preverite, da `ANTHROPIC_BASE_URL` **ne vsebuje
`/v1`**, in znova zaženite `claude` (okoljske spremenljivke se preberejo samo enkrat ob zagonu). `omniroute launch`
to uredi namesto vas.

**Izbirnik `/model` je prazen / modeli prehoda manjkajo** — potrebujete Claude Code
v2.1.219+ in `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1`. V izbirniku so prikazani samo ID-ji modelov `claude*` /
`anthropic*`; kateri koli drug model vsilite z
`ANTHROPIC_MODEL=<id>` (to počnejo profili).

**`400 Ambiguous model 'claude-…'`** — Claude Code vedno pošilja **ID-je modelov brez predpone**
(npr. `claude-opus-4-8`), zato se pri hkratni povezavi ponudnikov Claude Code (`cc/…`) in
Claude (`claude/…`) goli ID ujema z dvema potema, OmniRoute pa zavrne ugibanje. Težavo lahko odpravite na enega od dveh načinov: določite ID s predpono z
`ANTHROPIC_MODEL=cc/claude-opus-4-8` ali omogočite **Daj prednost Claude Code za
modele Claude brez predpone** — s preklopnikom na strani ponudnika Claude ali z
`OMNIROUTE_PREFER_CLAUDE_CODE_FOR_UNPREFIXED_CLAUDE_MODELS=true` (privzeto izklopljeno;
glejte [Okolje](../reference/ENVIRONMENT.md)) — s čimer se goli ID-ji `claude-*`
namesto tega usmerijo v Claude Code. Izrecne predpone ponudnikov imajo vedno prednost.

**Napake pri preverjanju pristnosti** — profil ne vsebuje žetona. Uporabite `omniroute launch --profile`
(ki ga vstavi) ali izvozite `ANTHROPIC_AUTH_TOKEN`.

**Profili niso ločeni** — vsak profil je ločen `CLAUDE_CONFIG_DIR`;
preverite, ali `echo $CLAUDE_CONFIG_DIR` znotraj seje kaže na
`~/.claude/profiles/<name>`.