Skip to content

CLAUDE-CODE-CONFIGURATION.md

Latest commit

 

History

History
230 lines (165 loc) · 22 KB

CLAUDE-CODE-CONFIGURATION.md

File metadata and controls

230 lines (165 loc) · 22 KB
Raw

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

🌐 Languages: 🇺🇸 English · 🇸🇦 ar · 🇦🇿 az · 🇧🇬 bg · 🇧🇩 bn · 🇧🇦 bs · 🇨🇿 cs · 🇩🇰 da · 🇩🇪 de · 🇬🇷 el · 🇪🇸 es · 🇪🇪 et · 🇮🇷 fa · 🇫🇮 fi · 🇫🇷 fr · 🇮🇪 ga · 🇮🇳 gu · 🇳🇬 ha · 🇮🇱 he · 🇮🇳 hi · 🇭🇷 hr · 🇭🇺 hu · 🇦🇲 hy · 🇮🇩 id · 🇳🇬 ig · 🇮🇹 it · 🇯🇵 ja · 🇬🇪 ka · 🇰🇭 km · 🇮🇳 kn · 🇰🇷 ko · 🇱🇹 lt · 🇱🇻 lv · 🇮🇳 ml · 🇮🇳 mr · 🇲🇾 ms · 🇲🇹 mt · 🇲🇲 my · 🇳🇵 ne · 🇳🇱 nl · 🇳🇴 no · 🇮🇳 or · 🇮🇳 pa · 🇵🇭 phi · 🇵🇱 pl · 🇵🇹 pt · 🇧🇷 pt-BR · 🇷🇴 ro · 🇷🇺 ru · 🇱🇰 si · 🇸🇰 sk · 🇸🇮 sl · 🇷🇸 sr · 🇸🇪 sv · 🇰🇪 sw · 🇮🇳 ta · 🇮🇳 te · 🇹🇭 th · 🇹🇷 tr · 🇺🇦 uk-UA · 🇵🇰 ur · 🇺🇿 uz · 🇻🇳 vi · 🇳🇬 yo · 🇨🇳 zh-CN · 🇹🇼 zh-TW

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

ፈጣን አጀማመር

# በአካባቢ 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 መረጃ አዝራሩ አጠገብ፣ ከቅጂ አዝራር ጋር ያሳያል፦

{
  "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ን ያክሉ፦

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

idውን በprovider ገጽ ላይ ካለው የconnection ረድፍ xxxxxxxx… chip ይቅዱ። pinኑ የሚሠራው ለsingle-model ids (provider/model) ብቻ ነው፣ ለcombos አይደለም። ትክክለኛውን fallback ባህሪ ለማየት በእያንዳንዱ 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 ይጽፋል፦

// ~/.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ን ፈጽሞ አይቀይርም።

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

# አካባቢያዊ 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 ሞዴል ጋር ያዛምዱ፦

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> ን ካስኬዱ (የርቀት ሁነታን ይመልከቱ)፣ 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ን (በነባሪ ጠፍቷል፤ አካባቢን ይመልከቱ) — ይህም ቅድመ ቅጥያ የሌላቸውን claude-* IDዎች በምትኩ ወደ Claude Code ያዞራል። ግልጽ የአቅራቢ ቅድመ ቅጥያዎች ሁልጊዜ ቅድሚያ ያገኛሉ።

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

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