# 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 prehoda v Claude Code prikaže samo ID-je, ki se začnejo s `claude`
ali `anthropic`, zato izvorni izbirnik `/model` pri nastavitvi
`CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1` običajno prikaže **samo**
Claude/Anthropic modele OmniRoute — modela `kimi/kimi-k2.6` ali `glm/glm-5.2` ne
prikaže nikoli, čeprav je usmerjanje zanju povsem pravilno.

OmniRoute lahko kateri koli omogočeni model (in kombinacijo) prezrcali pod ID `claude/…`,
da prestane ta filter in se prikaže 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)"
<kombinacija "custo-otimizado"> →  claude/combo/custo-otimizado
```

Ko v Claude Code izberete enega od teh modelov, OmniRoute pred usmerjanjem odstrani
ovoj `claude/` in obnovi pravi ID — pristen ID `claude/<real-claude-model>`
(dejanski ponudnik Claude OAuth) vedno ostane nespremenjen.

**Ta možnost je privzeto izklopljena** in jo nadzorujejo tri ravni (najbolj
specifična ima prednost), zato običajni OmniRoute ne podvoji kataloga za odjemalce,
ki ne uporabljajo Claude Code:

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

Spremenljivka okolja `EXPOSE_CC_DISCOVERY_ALIASES` prisilno vklopi globalno raven
in ima prednost pred nastavitvijo na nadzorni plošči (zaslon Zastavice funkcij
prikaže opombo »aktivno prek spremenljivke okolja«, kadar je tako). Stikala za
posamezne ponudnike in modele nato nastavitev dodatno natančno določijo — na primer:
če je globalna možnost izklopljena, ponudnik Kimi pa vklopljen, se prikažejo samo
modeli Kimi.

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

---

## Uvodni blok na nadzorni plošči

Kartica orodja Claude (**Nadzorna plošča → Koda CLI**) prikaže natančen fragment `settings.json`
za ta primerek, poleg informacijskega gumba za vzdevek za odkrivanje 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 razreši 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
nadomestno besedilo, zato ga posnetek zaslona ali prilepljeni izsek ne more razkriti. Nadomestno besedilo zamenjajte 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, predpostavlja 200K, zato se
samodejno strnjevanje sicer sproži ob napačnem času (glejte opozorilo v prejšnjem razdelku).
Graditelj izseka sprejema tudi to vrednost, zato jo lahko klicatelj, ki pozna velikost kontekstnega okna
ciljnega modela, vključi neposredno.

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

---

## Profili (`CLAUDE_CONFIG_DIR`)

Claude Code **nima izvornih datotek profilov** (za razliko od Codexove datoteke `~/.codex/<name>.config.toml`).
Običajni mehanizem je `CLAUDE_CONFIG_DIR` — ločen imenik z nastavitvami za vsak
profil, pri čemer ima vsak svoj `settings.json`, poverilnice, zgodovino in predpomnilnik.

`omniroute setup-claude` pridobi aktualni katalog `/v1/models` in zapiše en
profil na model v `~/.claude/profiles/<name>/settings.json`, pri čemer znova 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 ni nikoli zapisan v profil.** Zaženite z ukazom
> `omniroute launch --profile <name>` (ta 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 odkrivanju modelov (zahteva izrecno vključitev).** 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, ne da bi morali znova zagnati
ukaz. Ta možnost je **privzeto izklopljena**: preklopite jo na **nadzorni plošči Koda CLI** (»Samodejna
sinhronizacija profilov CLI« → Claude Code) ali nastavite `OMNIROUTE_AUTO_SYNC_CLAUDE_PROFILES=true` (upošteva tudi
`CLI_ALLOW_CONFIG_WRITES`, ki je privzeto vključen). Ko je možnost 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 (URL strežnika VPS vključi v vsak profil)
omniroute setup-claude --remote http://192.168.0.15:20128 --api-key oma_live_xxx

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

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

# Zagon profila
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>`.