# Claude Code CLI — Configuration with OmniRoute (ଓଡ଼ିଆ)

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

---

ପ୍ରତି-ମଡେଲ୍ ପ୍ରୋଫାଇଲ୍ ସହିତ, Codex ସେଟଅପ୍କୁ ଅନୁସରଣ କରି, **Claude Code** CLI (`claude`)କୁ OmniRoute — ସ୍ଥାନୀୟ କିମ୍ବା ଏକ ରିମୋଟ୍ VPS — ଆଡ଼କୁ ନିର୍ଦ୍ଦେଶ କରନ୍ତୁ।

---

## ଶୀଘ୍ର ଆରମ୍ଭ

```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  # OmniRoute ମାଧ୍ୟମରେ glm/glm-5.2 ବ୍ୟବହାର କରୁଥିବା Claude Code
```

---

## Claude Code କିପରି ଏକ gateway ସହିତ ସଂଯୋଗ କରେ

Claude Code **Anthropic Messages API** ସହିତ ଯୋଗାଯୋଗ କରେ ଏବଂ environment variable ମାଧ୍ୟମରେ ଏକ କଷ୍ଟମ୍ endpoint ଆଡ଼କୁ ନିର୍ଦ୍ଦେଶିତ ହୁଏ (ଏଥିରେ କୌଣସି `--base-url` flag ନାହିଁ):

| Variable                                     | ଉଦ୍ଦେଶ୍ୟ                                                                                        |
| -------------------------------------------- | ----------------------------------------------------------------------------------------------- |
| `ANTHROPIC_BASE_URL`                         | Gateway root URL (Claude Code `/v1/messages` ଯୋଡ଼େ)। **କୌଣସି `/v1` suffix ନୁହେଁ।**              |
| `ANTHROPIC_AUTH_TOKEN`                       | `Authorization: Bearer …` ଭାବରେ ପଠାଯାଏ — ଆପଣଙ୍କ OmniRoute access token / API key ବ୍ୟବହାର କରନ୍ତୁ |
| `ANTHROPIC_API_KEY`                          | ବିକଳ୍ପ: `x-api-key` ଭାବରେ ପଠାଯାଏ। ଉଭୟ ସେଟ୍ ହୋଇଥିଲେ, `ANTHROPIC_AUTH_TOKEN` ପ୍ରାଧାନ୍ୟ ପାଏ        |
| `ANTHROPIC_MODEL`                            | ଏକ ନିର୍ଦ୍ଦିଷ୍ଟ model ବାଧ୍ୟତାମୂଳକ କରେ (`/model` pickerର defaultକୁ override କରେ)                  |
| `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` | `1` → native `/model` picker `/v1/models`ରୁ `claude*`/`anthropic*` modelଗୁଡ଼ିକୁ ତାଲିକାଭୁକ୍ତ କରେ |
| `CLAUDE_CODE_MAX_OUTPUT_TOKENS`              | ପ୍ରତି responseର output token ସୀମିତ କରେ (ଯଥା `65536`)                                            |
| `CLAUDE_CODE_AUTO_COMPACT_WINDOW`            | auto-compaction ପାଇଁ token threshold                                                            |

> Env varଗୁଡ଼ିକ **startup ସମୟରେ କେବଳ ଥରେ** ପଢ଼ାଯାଏ — ସେଗୁଡ଼ିକ ପରିବର୍ତ୍ତନ କରିବା ପରେ Claude Codeକୁ restart କରନ୍ତୁ।

`omniroute launch` ଆପଣଙ୍କ ପାଇଁ ଏସବୁ ସେଟ୍ କରେ: ଏହା ସକ୍ରିୟ contextରୁ base URL + token ନିର୍ଦ୍ଧାରଣ କରେ (ତେଣୁ `omniroute connect <vps>` ପରେ `omniroute launch` ସିଧାସଳଖ କାମ କରେ), serverର health-check କରେ, ଏବଂ `claude`କୁ exec କରେ।

---

## ଡିସ୍କଭରୀ alias ଗୁଡ଼ିକ — `/model` picker ରେ non-Claude model ଗୁଡ଼ିକୁ ଦେଖାନ୍ତୁ

Claude Code ର gateway model ଡିସ୍କଭରୀ କେବଳ `claude` କିମ୍ବା `anthropic` ରେ ଆରମ୍ଭ ହେଉଥିବା id ଗୁଡ଼ିକୁ ତାଲିକାଭୁକ୍ତ କରେ, ତେଣୁ `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1` ସହିତ native `/model` picker ସାଧାରଣତଃ **କେବଳ** OmniRoute ର Claude/Anthropic model ଗୁଡ଼ିକୁ ଦେଖାଏ — `kimi/kimi-k2.6` କିମ୍ବା `glm/glm-5.2` କେବେବି ଦେଖାଯାଏ ନାହିଁ, ଯଦିଓ ଏହା ଠିକ୍ ଭାବରେ route ହୁଏ।

OmniRoute ଯେକୌଣସି enabled model (ଏବଂ combo) କୁ `claude/…` id ଅଧୀନରେ mirror କରିପାରେ, ଯାହା ଫଳରେ ଏହା ସେହି filter ପାସ୍ କରି picker ରେ ଦେଖାଯାଏ:

```
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 routing ପୂର୍ବରୁ `claude/` wrapper କୁ କାଢ଼ି ପ୍ରକୃତ id କୁ ଫେରାଇ ଦିଏ — ଏକ ପ୍ରକୃତ `claude/<real-claude-model>` id (ବାସ୍ତବ Claude OAuth provider) ସବୁବେଳେ ଅଛୁଁଆ ରହେ।

ଡିଫଲ୍ଟ ରୂପରେ କେବଳ base id ଗୁଡ଼ିକ mirror ହୁଏ। opt-in `CATALOG_MIRROR_REFINEMENTS_ENABLED` feature flag ଅନ୍ ଥିଲେ, catalog ରେ ପୂର୍ବରୁ ତାଲିକାଭୁକ୍ତ ଥିବା reasoning-effort variant ଗୁଡ଼ିକ (ଯେପରିକି `codex/gpt-6-sol-high`) ଅନ୍ୟ ଯେକୌଣସି id ପରି mirror ହୁଏ, ଯାହା ଫଳରେ Claude Code ଏକ ସ୍ପଷ୍ଟ effort level ବାଛିପାରେ, ଏବଂ built-in `auto/*` id ଗୁଡ଼ିକ ଯାହାକୁ request path materialize କରିପାରିବ ନାହିଁ ସେଗୁଡ଼ିକ mirror ହୁଏ ନାହିଁ। effort variant ଗୁଡ଼ିକ ଆଦୌ ତାଲିକାଭୁକ୍ତ ହେଉଛି କି ନାହିଁ ତାହା ଏବେବି `OMNIROUTE_DISABLE_THINKING_LEVEL_VARIANTS` ଦ୍ୱାରା ନିୟନ୍ତ୍ରିତ — mirror base catalog ରେ ନଥିବା କୌଣସି variant କେବେବି ଯୋଡ଼େ ନାହିଁ।

**ଏହା ଡିଫଲ୍ଟ ରୂପରେ ଅଫ୍ ଅଟେ** ଏବଂ ଏକ ତିନି-ସ୍ତରୀୟ gate (ସବୁଠାରୁ ନିର୍ଦ୍ଦିଷ୍ଟ ଜିତେ) ଦ୍ୱାରା ନିୟନ୍ତ୍ରିତ, ଯାହା ଫଳରେ ଏକ ସାଧାରଣ OmniRoute Claude Code ବ୍ୟବହାର ନକରୁଥିବା client ମାନଙ୍କ ପାଇଁ ନିଜ catalog କୁ କେବେବି ଦ୍ୱିଗୁଣିତ କରେ ନାହିଁ:

| ସ୍ତର     | କେଉଁଠାରେ                                                                                      |
| -------- | --------------------------------------------------------------------------------------------- |
| Model    | Provider detail ପୃଷ୍ଠା → per-model "Claude Code ରେ ଦେଖାନ୍ତୁ" ("Expose in Claude Code") toggle |
| Provider | Provider detail ପୃଷ୍ଠା → provider-level toggle (ଏହାର ସମସ୍ତ model କଭର କରେ)                     |
| Global   | Settings → Feature Flags → `EXPOSE_CC_DISCOVERY_ALIASES` (ଡିଫଲ୍ଟ ଅଫ୍)                         |

`EXPOSE_CC_DISCOVERY_ALIASES` environment variable global level କୁ ବାଧ୍ୟତାମୂଳକ ଭାବରେ ଅନ୍ କରେ ଏବଂ dashboard override ଠାରୁ ପ୍ରାଥମିକତା ପାଏ (ଏପରି ହେଲେ Feature Flags ସ୍କ୍ରିନ୍ ଏକ "environment variable ମାଧ୍ୟମରେ ସକ୍ରିୟ" ("active via environment variable") ନୋଟ୍ ଦେଖାଏ)। Per-provider ଏବଂ per-model toggle ଗୁଡ଼ିକ ସେଠାରୁ ଆଗକୁ ପରିମାର୍ଜନ କରେ — ଯେପରିକି global ଅଫ୍ + Kimi provider ଅନ୍ କେବଳ Kimi ର model ଗୁଡ଼ିକୁ ଉନ୍ମୋଚନ କରେ।

> ⚠️ **Non-Claude model ଗୁଡ଼ିକରେ window mismatch.** Claude Code ନିଜେ ଚିହ୍ନିପାରୁନଥିବା ଯେକୌଣସି id ପାଇଁ 200K context window ଅନୁମାନ କରେ (ଏହା `/v1/models` ରୁ ପ୍ରକୃତ window ପଢ଼ିପାରେ ନାହିଁ)। ଅଧିକ ବଡ଼ window ଥିବା model ପାଇଁ (ଯେପରିକି Kimi K2 ର 256K), `CLAUDE_CODE_AUTO_COMPACT_WINDOW` କୁ model ର ପ୍ରକୃତ window ଠାରୁ କମ୍ ମୂଲ୍ୟରେ ସେଟ୍ କରନ୍ତୁ ଯାହା ଫଳରେ auto-compaction ଅକାଳରେ କାର୍ଯ୍ୟ କରେ ନାହିଁ। ଉପରୋକ୍ତ generated profile ଗୁଡ଼ିକ ଏହାକୁ ପୂର୍ବରୁ ପ୍ରତି model ପାଇଁ କରନ୍ତି।

---

## ଡ୍ୟାଶବୋର୍ଡରେ ଅନବୋର୍ଡିଂ ବ୍ଲକ୍

Claude ଟୁଲ୍ କାର୍ଡ (**Dashboard → CLI Code**) ଏହି ଇନ୍ଷ୍ଟାନ୍ସ ପାଇଁ ସଠିକ୍ `settings.json` ଖଣ୍ଡକୁ
ଡିସକଭରି-ଆଲିଆସ୍ ସୂଚନା ବଟନ୍ ପାଖରେ ଏକ କପି ବଟନ୍ ସହିତ ପ୍ରଦର୍ଶନ କରେ:

```jsonc
{
  "env": {
    "ANTHROPIC_BASE_URL": "http://<ଆପଣଙ୍କ OmniRoute>:20128",
    "ANTHROPIC_AUTH_TOKEN": "<ଆପଣଙ୍କ OmniRoute API କି>",
    "CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY": "1",
  },
}
```

ବେସ୍ URL ହେଉଛି କାର୍ଡ ଦ୍ୱାରା ନିର୍ଦ୍ଧାରିତ URL (ଆପଣ ଟାଇପ୍ କରିଥିବା କଷ୍ଟମ୍ ଓଭର୍ରାଇଡ୍ ସମେତ), ଯାହା ପୂର୍ବରୁ
ସାମାନ୍ୟୀକୃତ — କୌଣସି `/v1` ସଫିକ୍ସ ନାହିଁ, କିମ୍ବା ଶେଷରେ ସ୍ଲାସ୍ ନାହିଁ। **କି କେବେବି ପ୍ରଦର୍ଶିତ ହୁଏ ନାହିଁ**: ବ୍ଲକ୍ରେ ଏକ
ପ୍ଲେସ୍ହୋଲ୍ଡର୍ ଥାଏ, ତେଣୁ ସ୍କ୍ରିନ୍ସଟ୍ କିମ୍ବା ପେଷ୍ଟ କରାଯାଇଥିବା ସ୍ନିପେଟ୍ରୁ କି ଲିକ୍ ହୋଇପାରିବ ନାହିଁ। ଏହା ଉପରେ ଆପଣଙ୍କ କି ପେଷ୍ଟ କରନ୍ତୁ।

ଯେକୌଣସି ମଡେଲ୍ର ପ୍ରକୃତ କଣ୍ଟେକ୍ସ୍ଟ ୱିଣ୍ଡୋ 200K ନୁହେଁ, ତାହା ପାଇଁ ସେହି `env` ବ୍ଲକ୍ ଅଧୀନରେ
`CLAUDE_CODE_AUTO_COMPACT_WINDOW` ଯୋଡ଼ନ୍ତୁ — Claude Code ଚିହ୍ନି ନଥିବା ପ୍ରତ୍ୟେକ id ପାଇଁ 200K ଧାରଣା କରେ, ତେଣୁ
ଅନ୍ୟଥା ଅଟୋ-କମ୍ପାକ୍ସନ୍ ଭୁଲ୍ ସମୟରେ ଆରମ୍ଭ ହୁଏ (ପୂର୍ବ ବିଭାଗରେ ଥିବା ଚେତାବନୀ ଦେଖନ୍ତୁ)।
ସ୍ନିପେଟ୍ ବିଲ୍ଡର୍ ମଧ୍ୟ ସେହି ମୂଲ୍ୟ ଗ୍ରହଣ କରେ, ତେଣୁ ଟାର୍ଗେଟ୍ ମଡେଲ୍ର ୱିଣ୍ଡୋ ଜାଣିଥିବା ଏକ କଲର୍
ଏହାକୁ ସିଧାସଳଖ ନିର୍ଗତ କରିପାରିବ।

ଉତ୍ସ: `src/shared/services/claudeCliConfig.ts::buildClaudeDiscoverySettingsSnippet` (ବିଶୁଦ୍ଧ
ବିଲ୍ଡର୍, ୟୁନିଟ୍-ପରୀକ୍ଷିତ), ଯାହା `ClaudeGatewayOnboardingBlock` ଦ୍ୱାରା ପ୍ରଦର୍ଶିତ ହୁଏ।

### ଗୋଟିଏ ଆକାଉଣ୍ଟ ପିନ୍ କରନ୍ତୁ (ଇଚ୍ଛାଧୀନ)

ପ୍ରତ୍ୟେକ Claude Code ଅନୁରୋଧକୁ ଗୋଟିଏ ନିର୍ଦ୍ଦିଷ୍ଟ ପ୍ରଦାନକାରୀ ଆକାଉଣ୍ଟ ମାଧ୍ୟମରେ ପଠାଇବା ପାଇଁ, ସେହି `env` ବ୍ଲକ୍ରେ
`ANTHROPIC_CUSTOM_HEADERS` ମାଧ୍ୟମରେ `x-omniroute-connection` ହେଡର୍ ଯୋଡ଼ନ୍ତୁ:

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

ପ୍ରଦାନକାରୀ ପୃଷ୍ଠାର କନେକ୍ସନ୍ ଧାଡ଼ିରେ ଥିବା `xxxxxxxx…` ଚିପ୍ରୁ id କପି କରନ୍ତୁ। ପିନ୍ କେବଳ
ଏକକ-ମଡେଲ୍ id (`provider/model`) ପାଇଁ ପ୍ରଯୋଜ୍ୟ, କମ୍ବୋ ପାଇଁ ନୁହେଁ। ସଠିକ୍ ଫଲ୍ବ୍ୟାକ୍ ଆଚରଣ ପାଇଁ
[ପ୍ରତ୍ୟେକ ଅନୁରୋଧ ପାଇଁ ଆକାଉଣ୍ଟ ପିନିଂ](../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` କ୍ୟାଟାଲଗ୍ ଆଣେ ଏବଂ
`~/.claude/profiles/<name>/settings.json`ରେ ପ୍ରତ୍ୟେକ ମଡେଲ୍ ପାଇଁ ଗୋଟିଏ ପ୍ରୋଫାଇଲ୍ ଲେଖେ, ଯେଉଁଥିରେ
**`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",
  },
}
```

> **ପ୍ରମାଣୀକରଣ ଟୋକନ୍ କେବେବି ପ୍ରୋଫାଇଲ୍ରେ ଲେଖାଯାଏ ନାହିଁ।** `omniroute launch --profile <name>` ସହିତ
> ଆରମ୍ଭ କରନ୍ତୁ (ଏହା ସକ୍ରିୟ କଣ୍ଟେକ୍ସ୍ଟରୁ `ANTHROPIC_AUTH_TOKEN` ଇଞ୍ଜେକ୍ଟ କରେ), କିମ୍ବା ନିଜେ
> `ANTHROPIC_AUTH_TOKEN` ଏକ୍ସପୋର୍ଟ କରି `CLAUDE_CONFIG_DIR=~/.claude/profiles/<name> claude`
> ଚଲାନ୍ତୁ।

**ମଡେଲ୍ ଆବିଷ୍କାର ପରେ ସ୍ୱୟଂଚାଳିତ ସିଙ୍କ୍ (ଇଚ୍ଛାଧୀନ)।** କୌଣସି ପ୍ରଦାତା ମଡେଲ୍
ସିଙ୍କ୍ ସକ୍ରିୟ କ୍ୟାଟାଲଗ୍କୁ ପରିବର୍ତ୍ତନ କଲେ OmniRoute ସ୍ୱୟଂଚାଳିତ ଭାବେ ଏହି ସମାନ
`~/.claude/profiles/<name>/settings.json` ଫାଇଲ୍ଗୁଡ଼ିକୁ ପୁନଃସୃଷ୍ଟି କରିପାରେ — ତେଣୁ କମାଣ୍ଡକୁ
ପୁଣି ଚଲାଇବା ବିନା ନୂଆ/ପୁନଃନାମିତ ମଡେଲ୍ଗୁଡ଼ିକ ପ୍ରୋଫାଇଲ୍ ପାଆନ୍ତି।
ଏହା **ଡିଫଲ୍ଟ ଭାବେ ବନ୍ଦ** ରହେ: **CLI Code ଡ୍ୟାସ୍ବୋର୍ଡ**ରୁ ଏହାକୁ ଟୋଗଲ୍ କରନ୍ତୁ ("CLI ପ୍ରୋଫାଇଲ୍
ସ୍ୱୟଂଚାଳିତ ସିଙ୍କ୍" → 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 ଅନୁମାନ କରିବାକୁ ମନା କରେ। ଦୁଇଟି ଉପାୟରୁ ଯେକୌଣସି ଗୋଟିଏରେ ଏହାକୁ ସମାଧାନ କରନ୍ତୁ: `ANTHROPIC_MODEL=cc/claude-opus-4-8` ସହିତ
ଏକ ପ୍ରିଫିକ୍ସଯୁକ୍ତ id-କୁ ପିନ୍ କରନ୍ତୁ, କିମ୍ବା **ପ୍ରିଫିକ୍ସ ନଥିବା 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` ଏକ୍ସପୋର୍ଟ କରନ୍ତୁ।

**ପ୍ରୋଫାଇଲ୍ଗୁଡ଼ିକ ପୃଥକ୍ ହେଉନାହାନ୍ତି** — ପ୍ରତ୍ୟେକ ପ୍ରୋଫାଇଲ୍ ଏକ ସ୍ୱତନ୍ତ୍ର `CLAUDE_CONFIG_DIR` ଅଟେ;
ନିଶ୍ଚିତ କରନ୍ତୁ ଯେ ସେସନ୍ ଭିତରେ `echo $CLAUDE_CONFIG_DIR`, `~/.claude/profiles/<name>` ଆଡ଼କୁ ଇଙ୍ଗିତ କରୁଛି।