# Claude Code CLI — Configuration with OmniRoute (Lietuvių) 🌐 **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) · 🇱🇻 [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) · 🇸🇮 [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) --- Nukreipkite **Claude Code** CLI (`claude`) į OmniRoute — vietinį arba nuotoliniame VPS — naudodami kiekvienam modeliui skirtus profilius, analogiškai Codex konfigūracijai. --- ## Greitoji pradžia ```bash # Paleiskite Claude Code su vietiniu OmniRoute (aktyvus kontekstas aptinkamas automatiškai) omniroute launch # Su nuotoliniu OmniRoute (įvykdžius `omniroute connect `, tai atliekama automatiškai) omniroute launch --remote http://192.168.0.15:20128 --api-key oma_live_xxx # Sugeneruokite kiekvienam modeliui skirtus profilius, tada paleiskite vieną iš jų omniroute setup-claude # įrašo ~/.claude/profiles//settings.json omniroute launch --profile glm52 # Claude Code naudoja glm/glm-5.2 per OmniRoute ``` --- ## Kaip Claude kodas jungiasi prie šliuzo Claude Code kalba apie**Anthropic Žinutės API** ir yra nukreiptas į pasirinktinį galinį tašką su aplinkos kintamaisiais (jis neturi `--base-url` vėliavėlės): | Kintamasis | Tikslas | | -------------------------------------------- | ----------------------------------------------------------------------------------------------- | | `ANTHROPIC_BASE_URL` | Šliuzo šaknis URL (Claude kodas pridedamas `/v1/messages`).** Nėra `/v1` priesagos.** | | `ANTHROPIC_AUTH_TOKEN` | Išsiųsta kaip `Authorization: Bearer …` — naudokite OmniRoute prieigos raktą / API raktą | | `ANTHROPIC_API_KEY` | Alternatyva: išsiųstas kaip `x-api-key`. Jei abu nustatomi, `ANTHROPIC_AUTH_TOKEN` laimi | | `ANTHROPIC_MODEL` | Priversti konkretų modelį (nepaiso `/model` rinkiklio numatytosios) | | `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` | `1` → vietiniame `/model` rinkiklyje pateikiami `claude*`/`anthropic*` modeliai iš `/v1/models` | | `CLAUDE_CODE_MAX_OUTPUT_TOKENS` | Apriboti išvesties prieigos raktus vienam atsakymui (pvz., `65536`) | | `CLAUDE_CODE_AUTO_COMPACT_WINDOW` | Automatinio sutankinimo prieigos rakto slenkstis | > Env vars skaitomi** vieną kartą paleidžiant** — iš naujo paleiskite Claude kodą juos pakeitę. Jei kredencialas sukasi, o ne fiksuota eilutė, nustatykite `apiKeyHelper` `~/.claude/settings.json` į komandą, kuri spausdina dabartinį kredencialą į stdout. Pagal numatytuosius nustatymus Claude kodas talpykloje saugo savo išvestį penkias minutes (`CLAUDE_CODE_API_KEY_HELPER_TTL_MS` nepaiso to) ir siunčia reikšmę ir `Authorization: Bearer` ir `x-api-key`. Scenarijus turi išspausdinti kredencialus ir nieko daugiau — reklamjuostę kartu su juo nepavyksta pagalbinės priemonės v2.1.227 +. Taip veikia Entra ID SSO : `scripts/cli/omniroute-sso.mjs token` vietoj API rakto išspausdina trumpalaikį Entra prieigos raktą, kurį OmniRoute patikrina. Žiūrėkite [`docs/security/ENTRA_SSO.md`](../security/ENTRA_SSO.md). `omniroute launch` nustato visa tai už jus: iš aktyvaus konteksto išskiria bazinį URL + raktą (taigi `omniroute connect ` tada `omniroute launch` tiesiog veikia), patikrina serverio būklę ir vykdo `claude`. --- ## Aptikimo slapyvardžiai — ne Claude modelių rodymas `/model` pasirinkiklyje Claude Code šliuzo modelių aptikimas išvardija tik ID, kurie prasideda `claude` arba `anthropic`, todėl su `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1` įgimtasis `/model` pasirinkiklis paprastai rodo **tik** OmniRoute Claude/Anthropic modelius — `kimi/kimi-k2.6` ar `glm/glm-5.2` niekada nepasirodo, nors nukreipimas į juos veikia gerai. OmniRoute gali dubliuoti bet kurį įjungtą modelį (ir kombinaciją) su `claude/…` ID, kad jis praeitų šį filtrą ir atsirastų pasirinkiklyje: ``` 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)" → claude/combo/custo-otimizado ``` Kai Claude Code pasirenkate vieną iš jų, OmniRoute prieš nukreipimą nuima `claude/` apvalkalą ir atkuria tikrąjį ID — tikras `claude/` ID (faktinis Claude OAuth teikėjas) visada paliekamas nepaliestas. Pagal numatymą dubliuojami tik baziniai ID. Įjungus pasirenkamą `CATALOG_MIRROR_REFINEMENTS_ENABLED` funkcijų vėliavėlę, samprotavimo intensyvumo variantai, kuriuos katalogas jau išvardija (pvz., `codex/gpt-6-sol-high`), dubliuojami kaip bet kuris kitas ID, todėl Claude Code gali pasirinkti aiškų intensyvumo lygį, o integruoti `auto/*` ID, kurių užklausos kelias negali materializuoti, nedubliuojami. Ar intensyvumo variantai apskritai išvardijami, vis dar lemia `OMNIROUTE_DISABLE_THINKING_LEVEL_VARIANTS` — dubliavimas niekada neprideda varianto, kurio neturi bazinis katalogas. **Pagal numatymą tai išjungta** ir valdoma trijų lygių kontrole (svarbiausias labiausiai specifinis lygmuo), todėl paprastas OmniRoute niekada nedvigubina savo katalogo klientams, kurie nenaudoja Claude Code: | Lygmuo | Kur | | -------- | ---------------------------------------------------------------------------------- | | Modelis | Teikėjo detalių puslapis → kiekvieno modelio perjungiklis „Expose in Claude Code" | | Teikėjas | Teikėjo detalių puslapis → teikėjo lygmens perjungiklis (apima visus jo modelius) | | Globalus | Settings → Feature Flags → `EXPOSE_CC_DISCOVERY_ALIASES` (pagal numatymą išjungta) | Aplinkos kintamasis `EXPOSE_CC_DISCOVERY_ALIASES` priverčia įjungti globalų lygmenį ir turi pirmenybę prieš valdymo skydo pakeitimą (tokiu atveju Feature Flags ekrane rodoma pastaba „active via environment variable"). Teikėjo ir modelio lygmens perjungikliai toliau tikslina nustatymus — pvz., globaliai išjungus + Kimi teikėjui įjungus atidengiami tik Kimi modeliai. > ⚠️ **Lango neatitikimas ne Claude modeliuose.** Claude Code bet kuriam neatpažįstamam ID > daro prielaidą, kad konteksto langas yra 200K (jis negali nuskaityti tikro lango iš > `/v1/models`). Modeliui su didesniu langu (pvz., Kimi K2 su 256K) nustatykite > `CLAUDE_CODE_AUTO_COMPACT_WINDOW` į reikšmę, mažesnę už tikrą modelio langą, kad > automatinis sutankinimas neįsijungtų per anksti. Aukščiau sugeneruoti profiliai tai jau > atlieka kiekvienam modeliui. --- ## Parengimo blokas prietaisų skydelyje Claude įrankio kortelėje (**Prietaisų skydelis → CLI Code**) pateikiamas tikslus šiam egzemplioriui skirtas `settings.json` fragmentas šalia aptikimo alternatyviojo pavadinimo informacijos mygtuko ir kopijavimo mygtukas: ```jsonc { "env": { "ANTHROPIC_BASE_URL": "http://:20128", "ANTHROPIC_AUTH_TOKEN": "", "CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY": "1", }, } ``` Bazinis URL yra tas, kurį nustatė kortelė (įskaitant jūsų įvestą pasirinktinį pakeitimą), ir jis jau normalizuotas — be `/v1` priesagos ir be pasvirojo brūkšnio pabaigoje. **Raktas niekada nepateikiamas**: bloke naudojamas vietos rezervavimo tekstas, todėl ekrano kopija ar įklijuotas fragmentas negali jo atskleisti. Vietoje jo įklijuokite savo raktą. Į tą patį `env` bloką įtraukite `CLAUDE_CODE_AUTO_COMPACT_WINDOW` bet kuriam modeliui, kurio tikrasis konteksto langas nėra 200K — Claude Code numato 200K kiekvienam neatpažįstamam id, todėl kitu atveju automatinis sutraukimas suaktyvinamas netinkamu metu (žr. ankstesnio skyriaus įspėjimą). Fragmento kūrimo priemonė taip pat priima šią reikšmę, todėl iškviečianti programa, žinanti tikslinio modelio lango dydį, gali ją įtraukti tiesiogiai. Šaltinis: `src/shared/services/claudeCliConfig.ts::buildClaudeDiscoverySettingsSnippet` (grynoji kūrimo funkcija, patikrinta vienetų testais), pateikiamas naudojant `ClaudeGatewayOnboardingBlock`. ### Vienos paskyros susiejimas (neprivaloma) Norėdami kiekvieną Claude Code užklausą siųsti per vieną konkrečią teikėjo paskyrą, tame pačiame `env` bloke per `ANTHROPIC_CUSTOM_HEADERS` pridėkite `x-omniroute-connection` antraštę: ```jsonc "ANTHROPIC_CUSTOM_HEADERS": "x-omniroute-connection: " ``` Nukopijuokite id iš teikėjo puslapio ryšio eilutėje esančios `xxxxxxxx…` žymos. Susiejimas taikomas tik vieno modelio id (`provider/model`), o ne deriniams. Tikslus veikimas, kai reikia naudoti atsarginį variantą, aprašytas skyriuje [Paskyros susiejimas kiekvienai užklausai](../reference/API_REFERENCE.md#account-pinning-per-request). --- ## Profiliai (`CLAUDE_CONFIG_DIR`) Claude Code **neturi savųjų profilių failų** (kitaip nei Codex `~/.codex/.config.toml`). Įprastas mechanizmas yra `CLAUDE_CONFIG_DIR` — atskiras konfigūracijos katalogas kiekvienam profiliui, kuriame saugomi jo `settings.json`, prisijungimo duomenys, istorija ir podėlis. `omniroute setup-claude` gauna dabartinį `/v1/models` katalogą ir įrašo po vieną profilį kiekvienam modeliui į `~/.claude/profiles//settings.json`, pakartotinai naudodama **tuos pačius pavadinimus kaip `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", }, } ``` > **Autentifikavimo prieigos raktas niekada neįrašomas į profilį.** Paleiskite naudodami > `omniroute launch --profile ` (ši komanda įterpia `ANTHROPIC_AUTH_TOKEN` iš > aktyvaus konteksto) arba patys eksportuokite `ANTHROPIC_AUTH_TOKEN` ir vykdykite > `CLAUDE_CONFIG_DIR=~/.claude/profiles/ claude`. **Automatinis sinchronizavimas po modelių aptikimo (pasirenkamas).** OmniRoute gali automatiškai iš naujo sugeneruoti tuos pačius `~/.claude/profiles//settings.json` failus, kai teikėjo modelių sinchronizavimas pakeičia dabartinį katalogą — taip nauji arba pervadinti modeliai gauna profilius, nereikalaujant iš naujo vykdyti komandos. Pagal numatytuosius nustatymus ši funkcija yra **išjungta**: įjunkite ją **CLI Code valdymo skydelyje** („CLI profilių automatinis sinchronizavimas“ → Claude Code) arba nustatykite `OMNIROUTE_AUTO_SYNC_CLAUDE_PROFILES=true` (taip pat atsižvelgiama į `CLI_ALLOW_CONFIG_WRITES`, kuris pagal numatytuosius nustatymus įjungtas). Įjungus šią funkciją, įrašomi tik profilių failai; ji niekada nekeičia aktyviosios ar numatytosios Claude konfigūracijos, autentifikavimo duomenų arba `~/.claude/settings.json`. ### Profilių generavimas ir naudojimas ```bash # Vietinis OmniRoute omniroute setup-claude # Nuotolinis VPS (įrašo VPS URL į kiekvieną profilį) omniroute setup-claude --remote http://192.168.0.15:20128 --api-key oma_live_xxx # Tik kai kurie teikėjai omniroute setup-claude --only glm,kimi # Taip pat įrašyti profilius vietiniams CLI teikėjams (zcode, auggie, devin-cli-agentic, # codex-app-server), neaptiktiems šiame kompiuteryje (pagal numatytuosius nustatymus praleidžiami vietiniam tikslui) omniroute setup-claude --include-local # Peržiūrėti nieko neįrašant omniroute setup-claude --dry-run # Paleisti profilį omniroute launch --profile kimi-k27 ``` --- ## Modelių lygiai (neprivaloma) Claude Code nukreipia užklausas pagal galimybių lygius. Jei kiekvienam lygiui norite naudoti skirtingus teikėjus, susiekite jį su OmniRoute modeliu naudodami aplinkos kintamuosius / nustatymus: ```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" ``` Priešingu atveju viskam naudojamas vienas `ANTHROPIC_MODEL` (kurį nustato profiliai). --- ## Nuotolinis režimas Paleidus `omniroute connect ` (žr. [Nuotolinis režimas](./REMOTE-MODE.md)), `omniroute launch` ir `omniroute setup-claude` automatiškai naudoja tą nuotolinį serverį bei jam skirtą ribotos apimties prieigos prieigos raktą — jokių papildomų parinkčių nereikia. Konkrečiam paleidimui šį nustatymą galite pakeisti naudodami `--remote` / `--api-key`. --- ## Trikčių šalinimas **Claude Code nepaiso šliuzo** — įsitikinkite, kad `ANTHROPIC_BASE_URL` **neturi `/v1`**, ir iš naujo paleiskite `claude` (aplinkos kintamieji nuskaitomi vieną kartą paleidimo metu). `omniroute launch` tuo pasirūpina už jus. **`/model` parinkiklis tuščias / jame nėra šliuzo modelių** — reikia Claude Code v2.1.219+ ir `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1`. Parinkiklyje rodomi tik `claude*` / `anthropic*` modelių ID; norėdami priverstinai naudoti bet kurį kitą modelį, nustatykite `ANTHROPIC_MODEL=` (būtent taip veikia profiliai). **`400 Ambiguous model 'claude-…'`** — Claude Code visada siunčia modelių ID **be prefikso** (pvz., `claude-opus-4-8`), todėl, kai prijungti ir Claude Code (`cc/…`), ir Claude (`claude/…`) teikėjai, ID be prefikso atitinka du maršrutus, o OmniRoute atsisako spėti. Tai galima išspręsti dviem būdais: nurodykite ID su prefiksu naudodami `ANTHROPIC_MODEL=cc/claude-opus-4-8` arba įjunkite **Teikti pirmenybę Claude Code Claude modeliams be prefikso** — šį jungiklį rasite Claude teikėjo puslapyje; taip pat galite nustatyti `OMNIROUTE_PREFER_CLAUDE_CODE_FOR_UNPREFIXED_CLAUDE_MODELS=true` (pagal numatytąsias nuostatas išjungta; žr. [Aplinka](../reference/ENVIRONMENT.md)) — tuomet ID be prefikso `claude-*` bus nukreipiami į Claude Code. Aiškiai nurodyti teikėjo prefiksai visada turi pirmenybę. **Autentifikavimo klaidos** — profilyje nėra prieigos rakto. Naudokite `omniroute launch --profile` (jis įterpia prieigos raktą) arba eksportuokite `ANTHROPIC_AUTH_TOKEN`. **Profiliai nėra izoliuoti** — kiekvienas profilis turi atskirą `CLAUDE_CONFIG_DIR`; seanso viduje patikrinkite, ar `echo $CLAUDE_CONFIG_DIR` nurodo `~/.claude/profiles/`.