# Claude Code CLI — Configuration with OmniRoute (Azərbaycan dili) 🌐 **Languages:** 🇺🇸 [English](../../../../guides/CLAUDE-CODE-CONFIGURATION.md) · 🇪🇹 [am](../../../am/docs/guides/CLAUDE-CODE-CONFIGURATION.md) · 🇸🇦 [ar](../../../ar/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-ni (`claude`) hər model üçün ayrıca profillərlə, Codex quraşdırmasını təkrarlayaraq OmniRoute-a — lokal və ya uzaq VPS-ə — yönləndirin. --- ## Sürətli başlanğıc ```bash # Claude Code-u lokal OmniRoute ilə başladın (aktiv konteksti avtomatik aşkarlayır) omniroute launch # Uzaq OmniRoute ilə (`omniroute connect ` əmrindən sonra bu avtomatikdir) omniroute launch --remote http://192.168.0.15:20128 --api-key oma_live_xxx # Hər model üçün ayrıca profillər yaradın, sonra onlardan birini başladın omniroute setup-claude # ~/.claude/profiles//settings.json faylına yazır omniroute launch --profile glm52 # OmniRoute vasitəsilə glm/glm-5.2 istifadə edən Claude Code ``` --- ## Claude Code şlüzə necə qoşulur Claude Code **Anthropic Messages API** ilə əlaqə qurur və mühit dəyişənləri vasitəsilə xüsusi son nöqtəyə yönləndirilir (onun `--base-url` bayrağı yoxdur): | Dəyişən | Təyinatı | | -------------------------------------------- | ---------------------------------------------------------------------------------------------------------- | | `ANTHROPIC_BASE_URL` | Şlüzün kök URL-i (Claude Code `/v1/messages` əlavə edir). **`/v1` suffiksi olmamalıdır.** | | `ANTHROPIC_AUTH_TOKEN` | `Authorization: Bearer …` kimi göndərilir — OmniRoute giriş tokeninizdən / API açarınızdan istifadə edin | | `ANTHROPIC_API_KEY` | Alternativ: `x-api-key` kimi göndərilir. Hər ikisi təyin edilibsə, `ANTHROPIC_AUTH_TOKEN` üstünlük qazanır | | `ANTHROPIC_MODEL` | Konkret modeli məcburi seçir (`/model` seçicisinin standart dəyərini əvəz edir) | | `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` | `1` → daxili `/model` seçicisi `/v1/models` siyahısından `claude*`/`anthropic*` modellərini göstərir | | `CLAUDE_CODE_MAX_OUTPUT_TOKENS` | Hər cavab üçün çıxış tokenlərinin sayını məhdudlaşdırır (məsələn, `65536`) | | `CLAUDE_CODE_AUTO_COMPACT_WINDOW` | Avtomatik sıxlaşdırma üçün token həddi | > Mühit dəyişənləri **işə salınarkən yalnız bir dəfə** oxunur — onları dəyişdirdikdən sonra Claude Code-u yenidən başladın. `omniroute launch` bunların hamısını sizin üçün təyin edir: əsas URL-i və tokeni aktiv kontekstdən müəyyənləşdirir (beləliklə, `omniroute connect ` və ardınca `omniroute launch` dərhal işləyir), serverin sağlamlıq yoxlamasını aparır və `claude` proqramını işə salır. --- ## Aşkarlama aliasları — Claude olmayan modellərin `/model` seçicisində göstərilməsi Claude Code-un gateway model aşkarlaması yalnız `claude` və ya `anthropic` ilə başlayan id-ləri siyahıya alır, buna görə `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1` olduqda nativ `/model` seçicisi adətən OmniRoute-un **yalnız** Claude/Anthropic modellərini göstərir — `kimi/kimi-k2.6` və ya `glm/glm-5.2` heç vaxt görünmür, baxmayaraq ki, marşrutlaşdırma düzgün işləyir. OmniRoute istənilən aktiv modeli (və kombonu) `claude/…` id-si altında əks etdirə bilər ki, o, həmin filtrdən keçsin və seçicidə görünsün: ``` 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 ``` Claude Code-da bunlardan birini seçdikdə, OmniRoute marşrutlaşdırmadan əvvəl `claude/` örtüyünü çıxarıb real id-yə qaytarır — həqiqi `claude/` id-si (faktiki Claude OAuth provayderi) həmişə toxunulmaz qalır. Defolt olaraq yalnız baza id-ləri əks etdirilir. Opt-in `CATALOG_MIRROR_REFINEMENTS_ENABLED` feature flag-i aktiv olduqda, kataloqun artıq siyahıya aldığı mühakimə-səyi variantları (məs. `codex/gpt-6-sol-high`) istənilən digər id kimi əks etdirilir, beləliklə Claude Code açıq səy səviyyəsi seçə bilir, sorğu yolunun materializə edə bilmədiyi daxili `auto/*` id-ləri isə əks etdirilmir. Səy variantlarının ümumiyyətlə siyahıya alınıb-alınmaması hələ də `OMNIROUTE_DISABLE_THINKING_LEVEL_VARIANTS` tərəfindən idarə olunur — əks etdirmə baza kataloqda olmayan variantı heç vaxt əlavə etmir. **Bu, defolt olaraq sönülüdür** və üç səviyyəli nəzarət qapısı ilə idarə olunur (ən spesifik qalib gəlir), beləliklə sadə bir OmniRoute Claude Code istifadə etməyən müştərilər üçün kataloqunu heç vaxt ikiqat artırmır: | Səviyyə | Harada | | --------- | --------------------------------------------------------------------------------------- | | Model | Provayder təfərrüat səhifəsi → model üzrə "Claude Code-da göstər" keçidi | | Provayder | Provayder təfərrüat səhifəsi → provayder səviyyəli keçid (bütün modellərini əhatə edir) | | Qlobal | Tənzimləmələr → Funksiya Bayraqları → `EXPOSE_CC_DISCOVERY_ALIASES` (defolt sönülü) | `EXPOSE_CC_DISCOVERY_ALIASES` mühit dəyişəni qlobal səviyyəni məcburi aktivləşdirir və dashboard override-dan üstün tutulur (Funksiya Bayraqları ekranı bu halda "mühit dəyişəni vasitəsilə aktivdir" qeydini göstərir). Provayder və model üzrə keçidlər bundan sonra dəqiqləşdirmə edir — məs. qlobal sönülü + Kimi provayderi aktiv olduqda yalnız Kimi modelləri göstərilir. > ⚠️ **Claude olmayan modellərdə pəncərə uyğunsuzluğu.** Claude Code tanımadığı > istənilən id üçün 200K kontekst pəncərəsi olduğunu güman edir (`/v1/models`-dən > real pəncərəni oxuya bilmir). Daha böyük pəncərəli model üçün (məs. Kimi K2-nin > 256K), `CLAUDE_CODE_AUTO_COMPACT_WINDOW` dəyərini modelin real pəncərəsindən aşağı > təyin edin ki, avtomatik sıxılma vaxtından əvvəl işə düşməsin. Yuxarıdakı > generasiya olunmuş profillər bunu artıq hər model üçün edir. --- ## İdarəetmə panelində ilkin quraşdırma bloku Claude alət kartı (**İdarəetmə paneli → CLI Code**) bu instansiya üçün dəqiq `settings.json` fraqmentini aşkarlama aliası məlumat düyməsinin yanında, kopyalama düyməsi ilə birlikdə göstərir: ```jsonc { "env": { "ANTHROPIC_BASE_URL": "http://:20128", "ANTHROPIC_AUTH_TOKEN": "", "CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY": "1", }, } ``` Baza URL-i kart tərəfindən müəyyən edilən (yazdığınız fərdi əvəzləmə də daxil olmaqla) və artıq normallaşdırılmış ünvandır — `/v1` suffiksi və sonunda əyri xətt yoxdur. **Açar heç vaxt göstərilmir**: blokda yer tutucu təqdim olunur, buna görə ekran görüntüsü və ya yapışdırılmış fraqment açarı sızdıra bilməz. Açarınızı onun yerinə yapışdırın. Real kontekst pəncərəsi 200K olmayan istənilən model üçün eyni `env` blokuna `CLAUDE_CODE_AUTO_COMPACT_WINDOW` əlavə edin — Claude Code tanımadığı hər bir id üçün 200K nəzərdə tutur, buna görə əks halda avtomatik sıxlaşdırma yanlış nöqtədə işə düşür (əvvəlki bölmədəki xəbərdarlığa baxın). Fraqment qurucusu bu dəyəri də qəbul edir, beləliklə hədəf modelin pəncərəsini bilən çağıran tərəf onu birbaşa yarada bilər. Mənbə: `src/shared/services/claudeCliConfig.ts::buildClaudeDiscoverySettingsSnippet` (saf qurucu, vahid testlərdən keçirilib), `ClaudeGatewayOnboardingBlock` tərəfindən göstərilir. ### Bir hesabı sabitləyin (ixtiyari) Bütün Claude Code sorğularını müəyyən bir provayder hesabı vasitəsilə göndərmək üçün eyni `env` blokunda `ANTHROPIC_CUSTOM_HEADERS` vasitəsilə `x-omniroute-connection` başlığını əlavə edin: ```jsonc "ANTHROPIC_CUSTOM_HEADERS": "x-omniroute-connection: " ``` ID-ni provayder səhifəsindəki bağlantı sətrində yerləşən `xxxxxxxx…` nişanından kopyalayın. Sabitləmə yalnız tək model ID-lərinə (`provider/model`) tətbiq olunur, kombinasiyalara deyil. Dəqiq geri dönüş davranışı üçün [Hər sorğu üzrə hesab sabitləməsi](../reference/API_REFERENCE.md#account-pinning-per-request) bölməsinə baxın. --- ## Profillər (`CLAUDE_CONFIG_DIR`) Claude Code-un **yerli profil faylları yoxdur** (Codex-in `~/.codex/.config.toml` fayllarından fərqli olaraq). Standart mexanizm `CLAUDE_CONFIG_DIR`-dur — hər profil üçün ayrıca konfiqurasiya qovluğu; hər birinin öz `settings.json` faylı, giriş məlumatları, tarixçəsi və keşi olur. `omniroute setup-claude` aktual `/v1/models` kataloqunu əldə edir və **`setup-codex` ilə eyni adlardan** (`glm52`, `kimi-k27`, `deepseek-pro`, …) istifadə edərək hər model üçün `~/.claude/profiles//settings.json` ünvanında bir profil yaradır: ```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", }, } ``` > **Autentifikasi tokeni heç vaxt profilə yazılmır.** `omniroute launch --profile ` ilə başladın > (bu, aktiv kontekstdən `ANTHROPIC_AUTH_TOKEN` dəyərini əlavə edir) və ya `ANTHROPIC_AUTH_TOKEN` dəyişənini > özünüz ixrac edib `CLAUDE_CONFIG_DIR=~/.claude/profiles/ claude` əmrini icra edin. **Model aşkarlanmasından sonra avtomatik sinxronizasiya (istəyə bağlıdır).** Provayder modelinin sinxronizasiyası aktual kataloqu dəyişdikdə OmniRoute eyni `~/.claude/profiles//settings.json` fayllarını avtomatik olaraq yenidən yarada bilər — beləliklə, yeni və ya adı dəyişdirilmiş modellər əmri yenidən icra etmədən profil əldə edir. Bu funksiya **standart olaraq deaktivdir**: onu **CLI Code idarə panelindən** ("CLI profile auto-sync" → Claude Code) aktivləşdirin və ya `OMNIROUTE_AUTO_SYNC_CLAUDE_PROFILES=true` təyin edin (o həmçinin standart olaraq aktiv olan `CLI_ALLOW_CONFIG_WRITES` parametrini nəzərə alır). Aktivləşdirildikdə yalnız profil fayllarını yazır; aktiv/standart Claude konfiqurasiyanızı, autentifikasiyanızı və ya `~/.claude/settings.json` faylını heç vaxt dəyişmir. ### Profillərin yaradılması və istifadəsi ```bash # Lokal OmniRoute omniroute setup-claude # Uzaq VPS (VPS URL-ni hər profilə daxil edir) omniroute setup-claude --remote http://192.168.0.15:20128 --api-key oma_live_xxx # Yalnız bəzi provayderlər omniroute setup-claude --only glm,kimi # Həmçinin bu hostda aşkarlanmayan lokal CLI provayderləri (zcode, auggie, devin-cli-agentic, # codex-app-server) üçün profillər yaradın (lokal hədəf üçün standart olaraq ötürülür) omniroute setup-claude --include-local # Yazmadan önizləmə omniroute setup-claude --dry-run # Profili başladın omniroute launch --profile kimi-k27 ``` --- ## Model səviyyələri (istəyə bağlı) Claude Code sorğuları imkan səviyyələrinə yönləndirir. Hər səviyyə üçün fərqli provayderlərdən istifadə etmək istəyirsinizsə, env / parametrlər vasitəsilə hər birini OmniRoute modelinə uyğunlaşdırın: ```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" ``` Əks halda, hər şey üçün vahid `ANTHROPIC_MODEL` (profillərin təyin etdiyi) istifadə olunur. --- ## Uzaqdan rejim `omniroute connect ` əmrini icra etdikdən sonra (baxın: [Uzaqdan rejim](./REMOTE-MODE.md)), `omniroute launch` və `omniroute setup-claude` avtomatik olaraq həmin uzaq serveri hədəfləyir və onun əhatə dairəsi məhdudlaşdırılmış giriş tokenindən istifadə edir — əlavə bayraqlara ehtiyac yoxdur. Hər çağırış üçün bunu `--remote` / `--api-key` ilə dəyişdirin. --- ## Problemlərin aradan qaldırılması **Claude Code şlüzü nəzərə almır** — `ANTHROPIC_BASE_URL` dəyərində **`/v1` olmadığını** təsdiqləyin və `claude`-u yenidən başladın (env yalnız işə salınarkən bir dəfə oxunur). `omniroute launch` bunu sizin üçün idarə edir. **`/model` seçicisi boşdur / şlüz modelləri yoxdur** — Claude Code v2.1.219+ və `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1` tələb olunur. Seçicidə yalnız `claude*` / `anthropic*` model ID-ləri görünür; istənilən digər modeli `ANTHROPIC_MODEL=` ilə məcburi seçin (profillər də məhz bunu edir). **`400 Ambiguous model 'claude-…'`** — Claude Code həmişə **prefikssiz** model ID-ləri (məsələn, `claude-opus-4-8`) göndərir, buna görə həm Claude Code (`cc/…`), həm də Claude (`claude/…`) provayderləri qoşulduqda prefikssiz ID iki marşruta uyğun gəlir və OmniRoute təxmin etməyi rədd edir. Bunu iki üsuldan biri ilə düzəldin: prefiksli ID-ni `ANTHROPIC_MODEL=cc/claude-opus-4-8` ilə sabitləyin və ya **Prefikssiz Claude modelləri üçün Claude Code-a üstünlük ver** seçimini aktivləşdirin — Claude provayderi səhifəsindəki keçid və ya `OMNIROUTE_PREFER_CLAUDE_CODE_FOR_UNPREFIXED_CLAUDE_MODELS=true` (standart olaraq deaktivdir; baxın: [Mühit](../reference/ENVIRONMENT.md)) — bu, prefikssiz `claude-*` ID-lərini əvəzinə Claude Code-a yönləndirir. Aydın şəkildə göstərilmiş provayder prefiksləri həmişə üstünlük təşkil edir. **Autentifikasiya xətaları** — profildə token saxlanılmır. `omniroute launch --profile` istifadə edin (onu daxil edir) və ya `ANTHROPIC_AUTH_TOKEN` dəyişənini export edin. **Profillər bir-birindən təcrid edilmir** — hər profil ayrıca `CLAUDE_CONFIG_DIR` istifadə edir; sessiya daxilində `echo $CLAUDE_CONFIG_DIR` nəticəsinin `~/.claude/profiles/` yolunu göstərdiyini yoxlayın.