# Claude Code CLI — Configuration with OmniRoute (Igbo)

🌐 **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) · 🇮🇹 [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)

---

Tụnye **Claude Code** CLI (`claude`) aka na OmniRoute — nke mpaghara ma ọ bụ VPS dị anya —
site na profaịlụ nke ụdịdị ọ bụla, dịka nhazi Codex.

---

## Mmalite ngwa ngwa

```bash
# Mepụta Claude Code ka ọ jiri OmniRoute mpaghara (ọ na-achọpụta ọnọdụ na-arụ ọrụ na-akpaghị aka)
omniroute launch

# Ka ọ jiri OmniRoute dị anya (mgbe `omniroute connect <host>` gasịrị, nke a na-eme na-akpaghị aka)
omniroute launch --remote http://192.168.0.15:20128 --api-key oma_live_xxx

# Mepụta profaịlụ nke ụdịdị ọ bụla, wee malite otu n'ime ha
omniroute setup-claude            # na-ede ~/.claude/profiles/<name>/settings.json
omniroute launch --profile glm52  # Claude Code na-eji glm/glm-5.2 site na OmniRoute
```

---

## Otu Claude Code si ejikọta na gateway

Claude Code na-eji **Anthropic Messages API** ekwurịta okwu, a na-ejikwa environment variables
tụnye ya aka na endpoint ahaziri iche (o nweghị ọkọlọtọ `--base-url`):

| Variable                                     | Ebumnuche                                                                                                 |
| -------------------------------------------- | --------------------------------------------------------------------------------------------------------- |
| `ANTHROPIC_BASE_URL`                         | URL mgbọrọgwụ nke gateway (Claude Code na-etinye `/v1/messages`). **Etinyekwala ngwụcha `/v1`.**          |
| `ANTHROPIC_AUTH_TOKEN`                       | A na-eziga ya dịka `Authorization: Bearer …` — jiri token nnweta / API key OmniRoute gị                   |
| `ANTHROPIC_API_KEY`                          | Nhọrọ ọzọ: a na-eziga ya dịka `x-api-key`. Ọ bụrụ na edobere ha abụọ, `ANTHROPIC_AUTH_TOKEN` ga-ebute ụzọ |
| `ANTHROPIC_MODEL`                            | Manye otu ụdịdị kpọmkwem (na-akagbu ndabara nke onye-ahọpụta `/model`)                                    |
| `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` | `1` → onye-ahọpụta `/model` nke mbụ na-edepụta ụdịdị `claude*`/`anthropic*` sitere na `/v1/models`        |
| `CLAUDE_CODE_MAX_OUTPUT_TOKENS`              | Debe oke token mmepụta maka nzaghachi ọ bụla (dịka `65536`)                                               |
| `CLAUDE_CODE_AUTO_COMPACT_WINDOW`            | Oke token nke na-akpalite mkpakọ na-akpaghị aka                                                           |

> A na-agụ env vars **naanị otu ugboro mgbe mmalite** — malitegharịa Claude Code mgbe ị gbanwere ha.

`omniroute launch` na-edozi ihe ndị a niile maka gị: ọ na-achọpụta base URL + token
site na ọnọdụ na-arụ ọrụ (ya mere `omniroute connect <vps>` wee bụrụ `omniroute launch`
ga-arụ ọrụ ozugbo), na-enyocha ahụike sava, ma na-eme exec nke `claude`.

---

## Aha nnọchi maka nchọpụta — mee ka ụdịdị na-abụghị Claude pụta na onye-ahọpụta `/model`

Nchọpụta ụdịdị gateway nke Claude Code na-edepụta naanị id ndị malitere na `claude`
ma ọ bụ `anthropic`, ya mere, mgbe `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1`, onye-ahọpụta
`/model` nke mbụ na-egosikarị **naanị** ụdịdị Claude/Anthropic nke OmniRoute — ụdịdị
`kimi/kimi-k2.6` ma ọ bụ `glm/glm-5.2` agaghị apụta ma ọlị, n'agbanyeghị na a pụrụ iduzi ya nke ọma.

OmniRoute nwere ike ịmepụta oyiri nke ụdịdị ọ bụla enyere ikike (na combo) n'okpuru id `claude/…` ka ọ
gafee nzacha ahụ ma pụta na onye-ahọpụta:

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

Mgbe ịhọrọ otu n'ime ndị a na Claude Code, OmniRoute na-ewepụ mkpuchi `claude/`
wee weghachite ya na id n'ezie tupu iduzi ya — a na-ahapụ id ezigbo `claude/<real-claude-model>`
(nke bụ Claude OAuth provider n'ezie) na-emetụghị ya aka mgbe niile.

**A na-agbanyụ nke a na ndabara**, ọnụ ụzọ ọkwa atọ na-achịkwa ya (nke kacha
kpọmkwem na-ebute ụzọ), ka OmniRoute nkịtị ghara ime katalọgụ ya okpukpu abụọ maka ndị ahịa na-adịghị eji
Claude Code:

| Ọkwa         | Ebe                                                                             |
| ------------ | ------------------------------------------------------------------------------- |
| Ụdịdị        | Ibe nkọwa provider → mgba ọkụ "Gosipụta na Claude Code" maka ụdịdị ọ bụla       |
| Provider     | Ibe nkọwa provider → mgba ọkụ ọkwa-provider (na-emetụta ụdịdị ya niile)         |
| Zuru ụwa ọnụ | Settings → Feature Flags → `EXPOSE_CC_DISCOVERY_ALIASES` (agbanyụrụ na ndabara) |

Environment variable `EXPOSE_CC_DISCOVERY_ALIASES` na-amanye ka a gbanye ọkwa zuru ụwa ọnụ
ma na-ebute ụzọ karịa mgbanwe e mere na dashboard (ihuenyo Feature Flags na-egosi
ndetu "na-arụ ọrụ site na environment variable" mgbe ọ mere). Mgba ọkụ nke provider ọ bụla na
ụdịdị ọ bụla na-emezi ya ọzọ site n'ebe ahụ — dịka ọmụmaatụ, ọ bụrụ na agbanyụrụ nke zuru ụwa ọnụ ma gbanye Kimi provider,
naanị ụdịdị Kimi ka a ga-egosipụta.

> ⚠️ **Window adabaghị na ụdịdị na-abụghị Claude.** Claude Code na-ewere na id ọ bụla ọ na-amataghị
> nwere context window 200K (ọ pụghị ịgụ window n'ezie site na
> `/v1/models`). Maka ụdịdị nwere window ka ukwuu (dịka 256K nke Kimi K2), debe
> `CLAUDE_CODE_AUTO_COMPACT_WINDOW` na uru dị ala karịa window n'ezie nke ụdịdị ahụ ka
> mkpakọ na-akpaghị aka ghara ịmalite tupu oge eruo. Profaịlụ ndị e mepụtara n'elu emeelarị
> nke a maka ụdịdị ọ bụla.

---

## Ngalaba nnabata na dashboard

Kaadị ngwáọrụ Claude (**Dashboard → CLI Code**) na-egosipụta kpọmkwem iberibe `settings.json`
maka instance a, n'akụkụ bọtịnụ ozi discovery-alias, yana bọtịnụ idetuo:

```jsonc
{
  "env": {
    "ANTHROPIC_BASE_URL": "http://<your OmniRoute>:20128",
    "ANTHROPIC_AUTH_TOKEN": "<your OmniRoute API key>",
    "CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY": "1",
  },
}
```

URL ntọala ahụ bụ nke kaadị ahụ chọpụtara (gụnyere override ahaziri iche nke ị pịnyere), nke
emelarị ka ọ bụrụ otu ụkpụrụ — enweghị mgbakwunye `/v1`, enweghị slash n'azụ. **A naghị egosipụta key ahụ ma ọlị**: ngalaba ahụ na-eji
placeholder abịa, ya mere screenshot ma ọ bụ snippet e tinyere enweghị ike ikpughe ya. Dochie ya na key gị.

Tinye `CLAUDE_CODE_AUTO_COMPACT_WINDOW` n'okpuru otu ngalaba `env` ahụ maka model ọ bụla nke ezigbo
context window ya na-abụghị 200K — Claude Code na-ewere na ọ bụ 200K maka id ọ bụla ọ na-amaghị, ya mere
auto-compaction ga-eme n'ebe na-ekwesịghị ekwesị ma ọ bụghị ya (lee ịdọ aka ná ntị dị na ngalaba gara aga).
Onye na-ewu snippet na-anabatakwa value ahụ, ya mere caller maara window nke model a na-achọ
nwere ike iwepụta ya ozugbo.

Isi mmalite: `src/shared/services/claudeCliConfig.ts::buildClaudeDiscoverySettingsSnippet` (builder dị ọcha,
nke e ji unit test nwalee) nke `ClaudeGatewayOnboardingBlock` na-egosipụta.

---

## Profaịlụ (`CLAUDE_CONFIG_DIR`)

Claude Code **enweghị faịlụ profaịlụ nke ya** (n'adịghị ka `~/.codex/<name>.config.toml` nke Codex).
Usoro a na-ejikarị eme ya bụ `CLAUDE_CONFIG_DIR` — ndekọ config dị iche maka
profaịlụ ọ bụla, nke ọ bụla nwere `settings.json`, credentials, history na cache nke ya.

`omniroute setup-claude` na-eweta katalọgụ `/v1/models` dị ugbu a ma dee otu
profaịlụ maka model ọ bụla na `~/.claude/profiles/<name>/settings.json`, na-eji
**otu aha ndị `setup-codex` na-eji** (`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",
  },
}
```

> **A naghị ede auth token ahụ na profaịlụ ma ọlị.** Jiri
> `omniroute launch --profile <name>` malite ya (ọ na-etinye `ANTHROPIC_AUTH_TOKEN` sitere na
> context na-arụ ọrụ), ma ọ bụ jiri aka gị export `ANTHROPIC_AUTH_TOKEN` wee mee
> `CLAUDE_CONFIG_DIR=~/.claude/profiles/<name> claude`.

**Auto-sync mgbe nchọpụta model gasịrị (ị ga-ahọrọ ịgbanye ya).** OmniRoute nwere ike imepụtaghachi otu
faịlụ `~/.claude/profiles/<name>/settings.json` ndị a na-akpaghị aka mgbe ọ bụla sync nke model provider
gbanwere katalọgụ dị ugbu a — ya mere model ọhụrụ ma ọ bụ ndị a gbanwere aha na-enweta profaịlụ n'ebughị ụzọ mee
command ahụ ọzọ. Ọ **gbanyụrụ na ndabara**: gbanye ya site na **dashboard CLI Code** ("CLI profile
auto-sync" → Claude Code), ma ọ bụ tọọ `OMNIROUTE_AUTO_SYNC_CLAUDE_PROFILES=true` (ọ na-asọpụrụkwa
`CLI_ALLOW_CONFIG_WRITES`, nke gbanyere na ndabara). Mgbe agbanyere ya, ọ na-ede naanị faịlụ profaịlụ; ọ naghị
agbanwe config Claude na-arụ ọrụ/nke ndabara, auth, ma ọ bụ `~/.claude/settings.json` gị.

### Ịmepụta + iji profaịlụ

```bash
# OmniRoute dị na mpaghara
omniroute setup-claude

# VPS dị anya (na-etinye URL VPS n'ime profaịlụ ọ bụla)
omniroute setup-claude --remote http://192.168.0.15:20128 --api-key oma_live_xxx

# Naanị ụfọdụ provider
omniroute setup-claude --only glm,kimi

# Lelee ihe ga-eme n'edeghị ihe ọ bụla
omniroute setup-claude --dry-run

# Bido profaịlụ
omniroute launch --profile kimi-k27
```

---

## Ọkwa model (nhọrọ)

Claude Code na-eziga arịrịọ n'ọkwa ike dị iche iche. Jikọta nke ọ bụla na model OmniRoute site na env /
ntọala ma ọ bụrụ na ịchọrọ ndị na-eweta dị iche iche maka ọkwa ọ bụla:

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

Ma ọ bụghị ya, a ga-eji otu `ANTHROPIC_MODEL` (nke profaịlụ na-ahazi) maka ihe niile.

---

## Ọnọdụ remote

Ozugbo ị gbasịrị `omniroute connect <host>` (lee
[Ọnọdụ Remote](./REMOTE-MODE.md)), `omniroute launch` na `omniroute setup-claude`
ga-ezubere sava remote ahụ ozugbo ma jiri token nnweta ya nwere oke — enweghị
flags ndị ọzọ achọrọ. Jiri `--remote` / `--api-key` dochie ya maka otu ịkpọ ọrụ.

---

## Nchọpụta na idozi nsogbu

**Claude Code na-eleghara gateway anya** — gosi na `ANTHROPIC_BASE_URL` enweghị
`/v1` ma malitegharịa `claude` (a na-agụ env naanị otu ugboro mgbe ọ na-amalite). `omniroute launch`
na-ahụ maka nke a n'ọnọdụ gị.

**Ihe nhọpụta `/model` tọgbọ chakoo / model gateway adịghị** — ọ chọrọ Claude Code
v2.1.219+ na `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1`. Naanị ID model `claude*` /
`anthropic*` na-apụta n'ihe nhọpụta ahụ; jiri
`ANTHROPIC_MODEL=<id>` manye model ọ bụla ọzọ (nke a bụ ihe profaịlụ na-eme).

**`400 Ambiguous model 'claude-…'`** — Claude Code na-eziga ID model **na-enweghị prefix**
mgbe niile (dịka `claude-opus-4-8`), ya mere mgbe ejikọtara ma ndị na-eweta Claude Code (`cc/…`) na
Claude (`claude/…`), id na-enweghị prefix ga-adaba na route abụọ, OmniRoute
agaghịkwa achọ ịkọ nkọ. Dozie ya n'otu n'ime ụzọ abụọ: jiri
`ANTHROPIC_MODEL=cc/claude-opus-4-8` họrọ id nwere prefix kpọmkwem, ma ọ bụ gbanye **Họrọ Claude Code karịa
maka model Claude ndị na-enweghị prefix** — toggle dị na peeji onye na-eweta Claude, ma ọ bụ
`OMNIROUTE_PREFER_CLAUDE_CODE_FOR_UNPREFIXED_CLAUDE_MODELS=true` (agbanyụghị ya na ndabara;
lee [Environment](../reference/ENVIRONMENT.md)) — nke na-eziga ID `claude-*` na-enweghị prefix
na Claude Code kama. Prefix onye na-eweta e depụtara kpọmkwem na-emeri mgbe niile.

**Njehie auth** — profaịlụ ahụ enweghị token. Jiri `omniroute launch --profile`
(ọ na-etinye ya) ma ọ bụ export `ANTHROPIC_AUTH_TOKEN`.

**Profaịlụ anaghị ekewapụ onwe ha** — profaịlụ ọ bụla nwere `CLAUDE_CONFIG_DIR` pụrụ iche;
jiri `echo $CLAUDE_CONFIG_DIR` nyochaa n'ime session ahụ na ọ na-arụtụ aka na
`~/.claude/profiles/<name>`.