# Claude Code CLI — Configuration with OmniRoute (Gaeilge) 🌐 **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) · 🇮🇳 [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) · 🇸🇮 [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) --- Treoraigh CLI **Claude Code** (`claude`) chuig OmniRoute — go háitiúil nó chuig VPS cianda — le próifílí de réir samhla, ar aon dul le socrú Codex. --- ## Tús tapa ```bash # Tosaigh Claude Code le OmniRoute áitiúil (braitear an comhthéacs gníomhach go huathoibríoch) omniroute launch # Le OmniRoute cianda (tar éis `omniroute connect `, déantar é seo go huathoibríoch) omniroute launch --remote http://192.168.0.15:20128 --api-key oma_live_xxx # Gin próifílí de réir samhla, ansin seol ceann acu omniroute setup-claude # scríobhann sé ~/.claude/profiles//settings.json omniroute launch --profile glm52 # Claude Code ag úsáid glm/glm-5.2 trí OmniRoute ``` --- ## Conas a nascann Claude Code le geata Déanann Claude Code cumarsáid le **Anthropic Messages API** agus treoraítear é chuig críochphointe saincheaptha le hathróga timpeallachta (níl bratach `--base-url` aige): | Athróg | Cuspóir | | -------------------------------------------- | -------------------------------------------------------------------------------------------------------------- | | `ANTHROPIC_BASE_URL` | Fréamh-URL an gheata (cuireann Claude Code `/v1/messages` leis). **Gan iarmhír `/v1`.** | | `ANTHROPIC_AUTH_TOKEN` | Seoltar mar `Authorization: Bearer …` é — úsáid do chomhartha rochtana / eochair API OmniRoute | | `ANTHROPIC_API_KEY` | Rogha eile: seoltar mar `x-api-key` é. Má tá an dá cheann socraithe, bíonn tosaíocht ag `ANTHROPIC_AUTH_TOKEN` | | `ANTHROPIC_MODEL` | Cuir samhail shonrach i bhfeidhm (sáraíonn sé réamhshocrú roghnóir `/model`) | | `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` | `1` → liostaíonn an roghnóir dúchasach `/model` samhlacha `claude*`/`anthropic*` ó `/v1/models` | | `CLAUDE_CODE_MAX_OUTPUT_TOKENS` | Cuir teorainn le comharthaí aschuir in aghaidh an fhreagra (m.sh. `65536`) | | `CLAUDE_CODE_AUTO_COMPACT_WINDOW` | Tairseach comharthaí don uath-chomhbhrú | > Léitear athróga timpeallachta **uair amháin ag am tosaithe** — atosaigh Claude Code tar éis iad a athrú. Socraíonn `omniroute launch` iad seo go léir duit: réitíonn sé an bun-URL + an comhartha ón gcomhthéacs gníomhach (mar sin oibríonn `omniroute connect ` agus ansin `omniroute launch` gan aon chumraíocht eile), déanann sé seiceáil sláinte ar an bhfreastalaí, agus ritheann sé `claude` trí exec. --- ## Ailiasanna fionnachtana — nocht samhlacha neamh-Claude sa roghnóir `/model` Ní liostaíonn fionnachtain samhail gheata Claude Code ach aitheantais a thosaíonn le `claude` nó `anthropic`, mar sin le `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1` ní thaispeánann an roghnóir dúchais `/model` de ghnáth samhlacha Claude/Anthropic OmniRoute **amháin** — ní thagann `kimi/kimi-k2.6` ná `glm/glm-5.2` chun cinn riamh, cé go ródófar iad gan aon fhadhb. Is féidir le OmniRoute aon tsamhail (agus teaglaim) atá cumasaithe a scáthánú faoi aitheantas `claude/…` ionas go dtéann sí tríd an scagaire sin agus go dtaispeánfar í sa roghnóir: ``` 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 ``` Nuair a roghnaíonn tú ceann díobh seo in Claude Code, baineann OmniRoute an timfhilleadh `claude/` den aitheantas agus tugtar ar ais go dtí an fíoraitheantas é sula ródófar é — fágtar aitheantas fíor `claude/` (an soláthraí OAuth Claude féin) gan bhaint i gcónaí. De réir réamhshocraithe, ní scáthánaítear ach bunaiteantais. Leis an mbratach gnéithe roghnacha `CATALOG_MIRROR_REFINEMENTS_ENABLED` ar siúl, scáthánaítear leaganacha dícheall-réasúnaíochta atá liostaithe ag an gcatalóg cheana féin (m.sh. `codex/gpt-6-sol-high`) mar aon le haon aitheantas eile, ionas gur féidir le Claude Code leibhéal dícheall sainráite a roghnú, agus ní scáthánaítear aitheantais ionsuite `auto/*` nach féidir le conair an iarratais a réadú. Is é `OMNIROUTE_DISABLE_THINKING_LEVEL_VARIANTS` a rialaíonn fós cé acu a liostaítear leaganacha dícheall ar chor ar bith — ní chuireann an scáthán leagan leis riamh nach bhfuil sa bhunchatalóg. **Tá sé seo múchta de réir réamhshocraithe** agus tá sé faoi rialú geata trí leibhéal (is é an leibhéal is sainiúla a bhuaileann), ionas nach ndúbálann OmniRoute simplí a chatalóg riamh do chliaint nach n-úsáideann Claude Code: | Leibhéal | Cá háit | | --------- | -------------------------------------------------------------------------------------------------------- | | Samhail | Leathanach sonraí an tsoláthraí → lasc "Nocht in Claude Code" in aghaidh na samhla | | Soláthraí | Leathanach sonraí an tsoláthraí → lasc ar leibhéal an tsoláthraí (clúdaíonn sí a cuid samhlacha go léir) | | Domhanda | Socruithe → Bratacha Gnéithe → `EXPOSE_CC_DISCOVERY_ALIASES` (múchta de réir réamhshocraithe) | Cuirfidh an athróg chomhshaoil `EXPOSE_CC_DISCOVERY_ALIASES` an leibhéal domhanda ar siúl de ghnáth agus beidh tosach aici thar an sárú deise (taispeánann scáileán na mBratacha Gnéithe nóta "gníomhach trí athróg chomhshaoil" nuair is amhlaidh). Déanann na lasca in aghaidh an tsoláthraí agus in aghaidh na samhla an scagadh a mhionchoigeartú as sin amach — m.sh. leis an leibhéal domhanda múchta agus soláthraí Kimi ar siúl, ní nochtaítear ach samhlacha Kimi. > ⚠️ **Neamhréir fuinneoige ar shamhlacha neamh-Claude.** Glacann Claude Code le fuinneog comhthéacs 200K d'aon aitheantas nach n-aithníonn sé (ní féidir leis fíorfhuinneog a léamh ó `/v1/models`). I gcás samhail le fuinneog níos mó (m.sh. 256K ag Kimi K2), socraigh `CLAUDE_CODE_AUTO_COMPACT_WINDOW` go luach faoi bhun fíorfhuinneog na samhla ionas nach rachaidh an féin-dhlúthú i bhfeidhm roimh am. Déanann na próifílí ginte thuas é seo cheana féin in aghaidh gach samhla. --- ## Bloc ionduchtúcháin ar an deais Taispeánann cárta uirlisí Claude (**Deais → Cód CLI**) an blúire beacht `settings.json` don ásc seo, in aice leis an gcnaipe faisnéise faoin ailias fionnachtana, agus cnaipe cóipeála leis: ```jsonc { "env": { "ANTHROPIC_BASE_URL": "http://:20128", "ANTHROPIC_AUTH_TOKEN": "", "CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY": "1", }, } ``` Is é an bun-URL an ceann a réitíonn an cárta (lena n-áirítear sárú saincheaptha a chlóscríobh tú), agus é normalaithe cheana féin — gan iarmhír `/v1`, gan slais deiridh. **Ní thaispeántar an eochair riamh**: cuirtear ionadchoinneálaí sa bhloc, mar sin ní féidir le gabháil scáileáin ná le blúire greamaithe í a sceitheadh. Greamaigh d'eochair ina áit. Cuir `CLAUDE_CODE_AUTO_COMPACT_WINDOW` faoin mbloc `env` céanna le haghaidh aon samhail nach 200K a fíorfhuinneog comhthéacs — glacann Claude Code leis gur 200K atá i gceist do gach id nach n-aithníonn sé, mar sin murach sin cuirtear an t-uath-chomhbhrú i ngníomh ag an bpointe mícheart (féach an rabhadh sa roinn roimhe seo). Glacann tógálaí na mblúirí leis an luach sin freisin, ionas gur féidir le glaoiteoir a bhfuil fuinneog na sprice-shamhla ar eolas aige é a aschur go díreach. Foinse: `src/shared/services/claudeCliConfig.ts::buildClaudeDiscoverySettingsSnippet` (tógálaí íon, aonadthástáilte) arna thaispeáint ag `ClaudeGatewayOnboardingBlock`. ### Cuir cuntas amháin in airde (roghnach) Chun gach iarratas Claude Code a sheoladh trí chuntas soláthraí sonrach amháin, cuir an ceanntásc `x-omniroute-connection` leis trí `ANTHROPIC_CUSTOM_HEADERS` sa bhloc `env` céanna: ```jsonc "ANTHROPIC_CUSTOM_HEADERS": "x-omniroute-connection: " ``` Cóipeáil an id ón tslis `xxxxxxxx…` ar ró an cheangail ar leathanach an tsoláthraí. Ní bhaineann an socrú seasta ach le hidanna aon-samhla (`provider/model`), agus ní bhaineann sé le teaglamaí. Féach [Ceangal cuntais de réir iarratais](../reference/API_REFERENCE.md#account-pinning-per-request) chun an t-iompar cúltaca beacht a fháil. --- ## Próifílí (`CLAUDE_CONFIG_DIR`) Níl **aon chomhad próifíle dúchasach** ag Claude Code (murab ionann agus `~/.codex/.config.toml` Codex). Is é `CLAUDE_CONFIG_DIR` an mheicníocht ghnásúil — comhadlann chumraíochta ar leith do gach próifíl, agus a `settings.json`, a dintiúir, a stair agus a taisce féin ag gach ceann acu. Faigheann `omniroute setup-claude` catalóg bheo `/v1/models` agus scríobhann sé próifíl amháin do gach samhail ag `~/.claude/profiles//settings.json`, ag athúsáid na **n-ainmneacha céanna le `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", }, } ``` > **Ní scríobhtar an ceadchomhartha fíordheimhnithe sa phróifíl riamh.** Seol é le > `omniroute launch --profile ` (insteallann sé `ANTHROPIC_AUTH_TOKEN` ón > gcomhthéacs gníomhach), nó easpórtáil `ANTHROPIC_AUTH_TOKEN` tú féin agus rith > `CLAUDE_CONFIG_DIR=~/.claude/profiles/ claude`. **Uathshioncronú tar éis aimsiú samhlacha (roghnach).** Is féidir le OmniRoute na comhaid chéanna `~/.claude/profiles//settings.json` a athghiniúint go huathoibríoch aon uair a athraíonn sioncronú samhlacha soláthraí an chatalóg bheo — mar sin faigheann samhlacha nua nó athainmnithe próifílí gan an t-ordú a rith arís. Tá sé **múchta de réir réamhshocraithe**: scoránaigh é ón **deais CLI Code** ("Uathshioncronú próifílí CLI" → Claude Code), nó socraigh `OMNIROUTE_AUTO_SYNC_CLAUDE_PROFILES=true` (urramaíonn sé `CLI_ALLOW_CONFIG_WRITES` freisin, atá casta air de réir réamhshocraithe). Nuair atá sé cumasaithe, ní scríobhann sé ach comhaid phróifíle; ní athraíonn sé do chumraíocht ghníomhach/réamhshocraithe Claude, an fíordheimhniú, ná `~/.claude/settings.json` riamh. ### Próifílí a ghiniúint + a úsáid ```bash # OmniRoute áitiúil omniroute setup-claude # VPS cianda (leabaíonn sé URL an VPS i ngach próifíl) omniroute setup-claude --remote http://192.168.0.15:20128 --api-key oma_live_xxx # Roinnt soláthraithe amháin omniroute setup-claude --only glm,kimi # Scríobh próifílí freisin do sholáthraithe CLI áitiúla (zcode, auggie, devin-cli-agentic, # codex-app-server) nach mbraitear ar an óstríomhaire seo (fágtar ar lár iad de réir réamhshocraithe do sprioc áitiúil) omniroute setup-claude --include-local # Réamhamharc gan scríobh omniroute setup-claude --dry-run # Seol próifíl omniroute launch --profile kimi-k27 ``` --- ## Sraitheanna samhlacha (roghnach) Treoraíonn Claude Code iarratais chuig sraitheanna cumais. Mapáil gach ceann acu chuig samhail OmniRoute trí env / socruithe más mian leat soláthraithe éagsúla a úsáid do gach sraith: ```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" ``` Seachas sin, úsáidtear `ANTHROPIC_MODEL` aonair (an ceann a shocraíonn próifílí) do gach rud. --- ## Mód cianda Nuair a bheidh `omniroute connect ` rite agat (féach [Mód Cianda](./REMOTE-MODE.md)), díríonn `omniroute launch` agus `omniroute setup-claude` go huathoibríoch ar an bhfreastalaí cianda sin agus úsáideann siad a chomhartha rochtana a bhfuil raon feidhme aige — ní theastaíonn bratacha breise. Sáraigh é do gach glao ar leith le `--remote` / `--api-key`. --- ## Fabhtcheartú **Déanann Claude Code neamhaird den gheata** — deimhnigh nach bhfuil **`/v1`** in `ANTHROPIC_BASE_URL` agus atosaigh `claude` (ní léitear env ach uair amháin ag an tosú). Láimhseálann `omniroute launch` é seo duit. **Tá roghnóir `/model` folamh / tá samhlacha geata ar iarraidh** — teastaíonn Claude Code v2.1.219+ agus `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1`. Ní bhíonn ach aitheantais samhlacha `claude*` / `anthropic*` le feiceáil sa roghnóir; cuir iallach ar aon samhail eile le `ANTHROPIC_MODEL=` (seo a dhéanann próifílí). **`400 Ambiguous model 'claude-…'`** — seolann Claude Code aitheantais samhlacha **gan réimír** i gcónaí (m.sh. `claude-opus-4-8`), mar sin nuair atá soláthraí Claude Code (`cc/…`) agus soláthraí Claude (`claude/…`) araon nasctha, meaitseálann an t-aitheantas lom dhá bhealach agus diúltaíonn OmniRoute tomhas a dhéanamh. Is féidir é a réiteach ar cheachtar bealach: pionnaigh aitheantas a bhfuil réimír air le `ANTHROPIC_MODEL=cc/claude-opus-4-8`, nó cumasaigh **Tabhair Tosaíocht do Claude Code le haghaidh samhlacha Claude gan réimír** — an scorán ar leathanach an tsoláthraí Claude, nó `OMNIROUTE_PREFER_CLAUDE_CODE_FOR_UNPREFIXED_CLAUDE_MODELS=true` (díchumasaithe de réir réamhshocraithe; féach [Timpeallacht](../reference/ENVIRONMENT.md)) — rud a threoraíonn aitheantais loma `claude-*` chuig Claude Code ina ionad sin. Bíonn an bua i gcónaí ag réimíreanna follasacha soláthraí. **Earráidí fíordheimhnithe** — níl aon chomhartha sa phróifíl. Úsáid `omniroute launch --profile` (insteallann sé é) nó easpórtáil `ANTHROPIC_AUTH_TOKEN`. **Ní dhéanann próifílí aonrú** — is `CLAUDE_CONFIG_DIR` ar leith é gach próifíl; deimhnigh go bhfuil `echo $CLAUDE_CONFIG_DIR` taobh istigh den seisiún dírithe ar `~/.claude/profiles/`.