# Claude Code CLI — Configuration with OmniRoute (አማርኛ)

🌐 **Languages:** 🇺🇸 [English](../../../../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) · 🇸🇮 [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)

---

የ **Claude Code** CLI (`claude`)ን ወደ OmniRoute — የአካባቢ ወይም የርቀት VPS —
በእያንዳንዱ ሞዴል መገለጫዎች፣ የCodex ውቅርን በማንጸባረቅ ያመልክቱ።

---

## ፈጣን አጀማመር

```bash
# በአካባቢ OmniRoute ላይ Claude Codeን ያስጀምሩ (ንቁውን አውድ በራስ-ሰር ያገኛል)
omniroute launch

# በርቀት OmniRoute ላይ (`omniroute connect <host>`ን ካስኬዱ በኋላ፣ ይህ በራስ-ሰር ይሆናል)
omniroute launch --remote http://192.168.0.15:20128 --api-key oma_live_xxx

# ለእያንዳንዱ ሞዴል መገለጫዎችን ይፍጠሩ፣ ከዚያም አንዱን ያስጀምሩ
omniroute setup-claude            # ወደ ~/.claude/profiles/<name>/settings.json ይጽፋል
omniroute launch --profile glm52  # Claude Code glm/glm-5.2ን በOmniRoute በኩል በመጠቀም
```

---

## Claude Code ከጌትዌይ ጋር እንዴት እንደሚገናኝ

Claude Code ከ **Anthropic Messages API** ጋር ይገናኛል፣ እናም የአካባቢ ተለዋዋጮችን በመጠቀም ወደ ብጁ
መዳረሻ ይመራል (`--base-url` ጠቋሚ የለውም)፦

| ተለዋዋጭ                                        | ዓላማ                                                                             |
| -------------------------------------------- | ------------------------------------------------------------------------------- |
| `ANTHROPIC_BASE_URL`                         | የጌትዌይ መሠረታዊ URL (Claude Code `/v1/messages`ን ይጨምራል)። **የ`/v1` ቅጥያ አይኖርም።**      |
| `ANTHROPIC_AUTH_TOKEN`                       | እንደ `Authorization: Bearer …` ይላካል — የOmniRoute መዳረሻ ቶከንዎን / API ቁልፍዎን ይጠቀሙ     |
| `ANTHROPIC_API_KEY`                          | አማራጭ፦ እንደ `x-api-key` ይላካል። ሁለቱም ከተዋቀሩ፣ `ANTHROPIC_AUTH_TOKEN` ቅድሚያ ያገኛል        |
| `ANTHROPIC_MODEL`                            | የተወሰነ ሞዴል እንዲጠቀም ያስገድዳል (የ`/model` መራጭን ነባሪ ይሽራል)                               |
| `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` | `1` → ቤተኛው የ`/model` መራጭ ከ`/v1/models` የተገኙ `claude*`/`anthropic*` ሞዴሎችን ይዘረዝራል |
| `CLAUDE_CODE_MAX_OUTPUT_TOKENS`              | በእያንዳንዱ ምላሽ የውጤት ቶከኖችን ይገድባል (ለምሳሌ `65536`)                                     |
| `CLAUDE_CODE_AUTO_COMPACT_WINDOW`            | ለራስ-ሰር ማጠቃለያ የቶከን ገደብ                                                           |

> የአካባቢ ተለዋዋጮች **በማስጀመሪያ ጊዜ አንድ ጊዜ** ይነበባሉ — ከቀየሯቸው በኋላ Claude Codeን እንደገና ያስጀምሩ።

`omniroute launch` እነዚህን ሁሉ ያዋቅርልዎታል፦ መሠረታዊ URL + ቶከንን
ከንቁው አውድ ይፈታል (ስለዚህ `omniroute connect <vps>` ከዚያም `omniroute launch`
በቀጥታ ይሠራል)፣ የሰርቨሩን ጤና ይፈትሻል፣ እና `claude`ን ያስኬዳል።

---

## የማግኘት ምትክ-ስሞች (discovery aliases) — በ `/model` መራጭ ውስጥ Claude ያልሆኑ ሞዴሎችን ማሳየት

የ Claude Code የጌትዌይ ሞዴል ማግኘት `claude` ወይም `anthropic` በሚጀምሩ መታወቂያዎችን ብቻ ይዘረዝራል፣ ስለዚህ `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1` ሲሆን አገናዊው `/model` መራጭ **ብቻ** የ OmniRoute Claude/Anthropic ሞዴሎችን ያሳያል — `kimi/kimi-k2.6` ወይም `glm/glm-5.2` በፍጹም አይታይም፣ ምንም እንኳን ራውቲንግ በደንብ ቢሰራም።

OmniRoute ማንኛውንም ነቃ ሞዴል (እና ኮምቦ) በ `claude/…` መታወቂያ ስር ማንጸባረቅ ይችላል፣ ይህም ያን ማጣሪያ እንዲያልፍ እና በመራጩ ውስጥ እንዲታይ ያደርገዋል:

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

እነዚህን አንዱን በ Claude Code ውስጥ ሲመርጡ፣ OmniRoute ከራውቲንግ በፊት የ `claude/` መሸፈኛውን ወደ እውነተኛው መታወቂያ ይነስፋል — እውነተኛ `claude/<real-claude-model>` መታወቂያ (እውነተኛው የ Claude OAuth አቅራቢ) ሁልጊዜ ያለንክብካቤ ይቀራል።

በነባሪነት የመሠረት መታወቂያዎች ብቻ ነው የሚንጸባረቁት። በፈቃደኝነት (opt-in) የሚነቃው `CATALOG_MIRROR_REFINEMENTS_ENABLED` የባህሪ ሰንደቅ ሲነቃ፣ ካታሎጉ አስቀድሞ የሚዘረዝራቸው የአስተሳሰብ-ጥረት (reasoning-effort) ተለዋዋጮች (ለምሳሌ `codex/gpt-6-sol-high`) እንደ ሌላው ማንኛውም መታወቂያ ይንጸባረቃሉ፣ ስለዚህ Claude Code ግልጽ የጥረት ደረጃ መምረጥ ይችላል፣ እና የጥያቄ መንገዱ መፍጠር (materialize) የማይችላቸው እንቅስቃሴ-ውስጣዊ (built-in) `auto/*` መታወቂያዎች አይንጸባረቁም። የጥረት ተለዋዋጮች በፍጹም መዘረዝራቸው ገና በ `OMNIROUTE_DISABLE_THINKING_LEVEL_VARIANTS` ነው የሚገዛው — መስታወቱ መሠረታዊው ካታሎግ የሌለውን ተለዋዋጭ በፍጹም አይጨምርም።

**ይህ በነባሪነት ጠፍቷል** እና በሦስት-ደረጃ መቆጣጠሪያ በር (በጣም የተወሰነው ያሸንፋል) ይቆጣጠራል፣ ስለዚህ ተራ OmniRoute Claude Code ለማይጠቀሙ ደንበኞች ካታሎጉን በፍጹም አያባዛም:

| ደረጃ    | የት                                                               |
| ------ | ---------------------------------------------------------------- |
| ሞዴል    | የአቅራቢ ዝርዝር ገጽ → የእያንዳንዱ ሞዴል "Expose in Claude Code" ቶግል          |
| አቅራቢ   | የአቅራቢ ዝርዝር ገጽ → የአቅራቢ-ደረጃ ቶግል (ሁሉንም ሞዴሎቹን ይሸፍናል)                 |
| አለምአቀፍ | ቅንብሮች → የባህሪ ሰንደቆች → `EXPOSE_CC_DISCOVERY_ALIASES` (በነባሪነት ጠፍቷል) |

የ `EXPOSE_CC_DISCOVERY_ALIASES` የአካባቢ ተለዋዋጭ አለምአቀፍ ደረጃውን በግድ ያበራል እና ከዳሽቦርዱ ቅድሚያ-ማሻሻያ (override) ላይ ቅድሚያ ይወስዳል (ሲሆን የባህሪ ሰንደቆች ማያ ገጽ "active via environment variable" የሚል ማስታወሻ ያሳያል)። የአቅራቢ-እና የሞዴል-ደረጃ ቶግሎች ከዚያ ጀምሮ ያጣራሉ — ለምሳሌ አለምአቀፍ ጠፍቶ + የ Kimi አቅራቢ በርቶ የ Kimi ሞዴሎችን ብቻ ያሳያል።

> ⚠️ **በ Claude ያልሆኑ ሞዴሎች ላይ የመስኮት ልዩነት.** Claude Code ለማያውቀው ማንኛውም መታወቂያ 200K የአውድ መስኮት (context window) ይገምታል (እውነተኛ መስኮት ከ `/v1/models` ማንበብ አይችልም)። ከዚህ የላቀ መስኮት ላለው ሞዴል (ለምሳሌ የ Kimi K2 256K)፣ `CLAUDE_CODE_AUTO_COMPACT_WINDOW` ከሞዴሉ እውነተኛ መስኮት በታች ወደሆነ እሴት ያዋቅሩት፣ ስለዚህ ራስ-ሰር-ማጠብ (auto-compaction) ከጊዜው በፊት አይነሳም። ከላይ የተፈጠሩት መገለጫዎች (profiles) ይህንን አስቀድመው በእያንዳንዱ ሞዴል ያደርጋሉ።

---

## በዳሽቦርዱ ላይ ያለው የመጀመሪያ ማዋቀሪያ ብሎክ

የClaude መሣሪያ ካርድ (**Dashboard → CLI Code**) ለዚህ instance ትክክለኛውን የ`settings.json` ክፍል
ከdiscovery-alias መረጃ አዝራሩ አጠገብ፣ ከቅጂ አዝራር ጋር ያሳያል፦

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

የመሠረት URL በካርዱ የተወሰነው ነው (እርስዎ ያስገቡትን ብጁ override ጨምሮ)፣ እና አስቀድሞ
normalized ተደርጓል — የ`/v1` ቅጥያም ሆነ የመጨረሻ slash የለውም። **ቁልፉ ፈጽሞ አይታይም**፦ ብሎኩ
placeholder ይዞ ይመጣል፣ ስለዚህ screenshot ወይም የተለጠፈ snippet ቁልፍን ሊያጋልጥ አይችልም። ቁልፍዎን በእሱ ላይ ይለጥፉ።

ትክክለኛው context window 200K ላልሆነ ማንኛውም model፣ `CLAUDE_CODE_AUTO_COMPACT_WINDOW`ን በተመሳሳዩ
የ`env` ብሎክ ስር ያክሉ — Claude Code ለማያውቀው እያንዳንዱ id 200K እንዳለው ይገምታል፣ ስለዚህ
ካልታከለ auto-compaction በተሳሳተ ቦታ ይጀምራል (ባለፈው ክፍል ያለውን ማስጠንቀቂያ ይመልከቱ)።
የsnippet builder ይህን እሴትም ይቀበላል፣ ስለዚህ የዒላማ model windowን የሚያውቅ caller
በቀጥታ ሊያመነጨው ይችላል።

ምንጭ፦ `src/shared/services/claudeCliConfig.ts::buildClaudeDiscoverySettingsSnippet` (ንጹሕ
builder፣ unit-tested) በ`ClaudeGatewayOnboardingBlock` የሚታይ።

### አንድ መለያ ይሰኩ (አማራጭ)

እያንዳንዱን የClaude Code request በአንድ የተወሰነ provider account በኩል ለመላክ፣ በተመሳሳዩ የ`env` ብሎክ
ውስጥ `ANTHROPIC_CUSTOM_HEADERS`ን በመጠቀም የ`x-omniroute-connection` headerን ያክሉ፦

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

idውን በprovider ገጽ ላይ ካለው የconnection ረድፍ `xxxxxxxx…` chip ይቅዱ። pinኑ የሚሠራው
ለsingle-model ids (`provider/model`) ብቻ ነው፣ ለcombos አይደለም። ትክክለኛውን fallback ባህሪ ለማየት
[በእያንዳንዱ request የመለያ መሰካት](../reference/API_REFERENCE.md#account-pinning-per-request)ን ይመልከቱ።

---

## መገለጫዎች (`CLAUDE_CONFIG_DIR`)

Claude Code **አብሮገነብ የመገለጫ ፋይሎች የሉትም** (እንደ Codex `~/.codex/<name>.config.toml` አይደለም)።
የተለመደው ዘዴ `CLAUDE_CONFIG_DIR` ነው — ለእያንዳንዱ መገለጫ የተለየ የውቅረት ማውጫ ሲሆን፣
እያንዳንዱም የራሱ `settings.json`፣ የመግቢያ ማረጋገጫዎች፣ ታሪክ እና መሸጎጫ አለው።

`omniroute setup-claude` ቀጥታውን `/v1/models` ካታሎግ አምጥቶ፣ ከ**`setup-codex` ጋር ተመሳሳይ ስሞችን** (`glm52`፣ `kimi-k27`፣ `deepseek-pro`፣ …) በመጠቀም ለእያንዳንዱ ሞዴል አንድ መገለጫ በ`~/.claude/profiles/<name>/settings.json` ይጽፋል፦

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

> **የማረጋገጫ ቶከኑ በመገለጫው ውስጥ ፈጽሞ አይጻፍም።** በ
> `omniroute launch --profile <name>` ያስጀምሩ (ከንቁ አውድ `ANTHROPIC_AUTH_TOKEN`ን ያስገባል)፣ ወይም `ANTHROPIC_AUTH_TOKEN`ን ራስዎ export አድርገው
> `CLAUDE_CONFIG_DIR=~/.claude/profiles/<name> claude`ን ያሂዱ።

**ከሞዴል ፍለጋ በኋላ ራስ-ሰር ማመሳሰል (በምርጫ የሚነቃ)።** የአቅራቢ ሞዴል
ማመሳሰል ቀጥታውን ካታሎግ በሚቀይርበት ጊዜ ሁሉ፣ OmniRoute እነዚህን ተመሳሳይ
`~/.claude/profiles/<name>/settings.json` ፋይሎች በራስ-ሰር እንደገና ማመንጨት ይችላል — ስለዚህ አዲስ/እንደገና የተሰየሙ ሞዴሎች ትዕዛዙን እንደገና ሳያሂዱ መገለጫዎችን ያገኛሉ።
በ**ነባሪነት ጠፍቷል**፦ ከ**CLI Code ዳሽቦርድ** ("CLI profile
auto-sync" → Claude Code) ያብሩት፣ ወይም `OMNIROUTE_AUTO_SYNC_CLAUDE_PROFILES=true` ያዘጋጁ (`CLI_ALLOW_CONFIG_WRITES`ንም ያከብራል፤ ይህም በነባሪነት እንዲሰራ ተደርጓል)። ሲነቃ የሚጽፈው የመገለጫ ፋይሎችን ብቻ ነው፤ ንቁ/ነባሪ የClaude ውቅርዎን፣ ማረጋገጫዎን ወይም `~/.claude/settings.json`ን ፈጽሞ አይቀይርም።

### መገለጫዎችን ማመንጨት + መጠቀም

```bash
# አካባቢያዊ OmniRoute
omniroute setup-claude

# የርቀት VPS (የVPS URLን በእያንዳንዱ መገለጫ ውስጥ ያካትታል)
omniroute setup-claude --remote http://192.168.0.15:20128 --api-key oma_live_xxx

# የተወሰኑ አቅራቢዎች ብቻ
omniroute setup-claude --only glm,kimi

# በዚህ አስተናጋጅ ላይ ያልተገኙ የአካባቢያዊ-CLI አቅራቢዎችን (zcode, auggie, devin-cli-agentic,
# codex-app-server) መገለጫዎችም ይጻፉ (ለአካባቢያዊ ዒላማ በነባሪነት ይዘለላሉ)
omniroute setup-claude --include-local

# ሳይጽፉ ቅድመ ዕይታ ያድርጉ
omniroute setup-claude --dry-run

# አንድ መገለጫ ያስጀምሩ
omniroute launch --profile kimi-k27
```

---

## የሞዴል ደረጃዎች (አማራጭ)

Claude Code ጥያቄዎችን ወደ ችሎታ ደረጃዎች ያዞራል። ለእያንዳንዱ ደረጃ የተለያዩ አቅራቢዎችን መጠቀም ከፈለጉ፣ በenv /
ቅንብሮች በኩል እያንዳንዱን ከአንድ OmniRoute ሞዴል ጋር ያዛምዱ፦

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

አለበለዚያ፣ አንድ `ANTHROPIC_MODEL` (መገለጫዎች የሚያዘጋጁት) ለሁሉም ነገር ጥቅም ላይ ይውላል።

---

## የርቀት ሁነታ

አንዴ `omniroute connect <host>` ን ካስኬዱ ([የርቀት ሁነታ](./REMOTE-MODE.md)ን ይመልከቱ)፣ `omniroute launch` እና `omniroute setup-claude`
ያንን የርቀት አገልጋይ በራስ-ሰር ዒላማ ያደርጋሉ፣ እንዲሁም የእሱን ወሰን የተበጀለት የመዳረሻ ቶከን ይጠቀማሉ — ተጨማሪ
ጥቆማዎች አያስፈልጉም። ለእያንዳንዱ ጥሪ በ`--remote` / `--api-key` ይሽሩት።

---

## መላ ፍለጋ

**Claude Code መግቢያውን ችላ ይላል** — `ANTHROPIC_BASE_URL` **`/v1` እንደሌለው**
ያረጋግጡ፣ ከዚያ `claude`ን ዳግም ያስጀምሩ (env በማስጀመሪያ ጊዜ አንድ ጊዜ ብቻ ይነበባል)። `omniroute launch`
ይህን ለእርስዎ ያከናውናል።

**የ`/model` መራጩ ባዶ ነው / የመግቢያ ሞዴሎች ጠፍተዋል** — Claude Code
v2.1.219+ እና `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1` ያስፈልጋሉ። በመራጩ ውስጥ የሚታዩት `claude*` /
`anthropic*` የሞዴል IDዎች ብቻ ናቸው፤ ማንኛውንም ሌላ ሞዴል በ
`ANTHROPIC_MODEL=<id>` ያስገድዱ (መገለጫዎች የሚያደርጉት ይህንኑ ነው)።

**`400 Ambiguous model 'claude-…'`** — Claude Code ሁልጊዜ **ቅድመ ቅጥያ የሌላቸው**
የሞዴል IDዎችን (ለምሳሌ `claude-opus-4-8`) ይልካል፤ ስለዚህ ሁለቱም Claude Code (`cc/…`) እና
Claude (`claude/…`) አቅራቢዎች ሲገናኙ ቅድመ ቅጥያ የሌለው id ከሁለት መስመሮች ጋር ይዛመዳል፣ እና
OmniRoute መገመትን አይቀበልም። ከሁለቱ መንገዶች በአንዱ ያስተካክሉት፦ ቅድመ ቅጥያ ያለውን id በ
`ANTHROPIC_MODEL=cc/claude-opus-4-8` ይወስኑ፣ ወይም **ቅድመ ቅጥያ ለሌላቸው Claude ሞዴሎች Claude Codeን
ቅድሚያ ስጥ**ን ያንቁ — በClaude አቅራቢ ገጽ ላይ ያለውን መቀያየሪያ፣ ወይም
`OMNIROUTE_PREFER_CLAUDE_CODE_FOR_UNPREFIXED_CLAUDE_MODELS=true`ን (በነባሪ ጠፍቷል፤
[አካባቢ](../reference/ENVIRONMENT.md)ን ይመልከቱ) — ይህም ቅድመ ቅጥያ የሌላቸውን `claude-*`
IDዎች በምትኩ ወደ Claude Code ያዞራል። ግልጽ የአቅራቢ ቅድመ ቅጥያዎች ሁልጊዜ ቅድሚያ ያገኛሉ።

**የማረጋገጫ ስህተቶች** — መገለጫው ምንም ቶከን አይይዝም። `omniroute launch --profile`ን
ይጠቀሙ (ቶከኑን ያስገባል) ወይም `ANTHROPIC_AUTH_TOKEN`ን export ያድርጉ።

**መገለጫዎች አይነጣጠሉም** — እያንዳንዱ መገለጫ የተለየ `CLAUDE_CONFIG_DIR` ነው፤ በክፍለ ጊዜው ውስጥ
`echo $CLAUDE_CONFIG_DIR` ወደ `~/.claude/profiles/<name>` እንደሚያመለክት ያረጋግጡ።