Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 5 additions & 5 deletions docs-site/src/content/docs/fr/guides/claude-code.md
Original file line number Diff line number Diff line change
Expand Up @@ -254,9 +254,9 @@ Support/Claude/configLibrary` sur macOS, `%APPDATA%\Claude\configLibrary` sur Wi
`CLAUDE_USER_DATA_DIR` pour utiliser une autre racine de données Claude Desktop. L'ancien répertoire `Claude-3p` n'est
ni lu ni supprimé automatiquement.

Les routes non Anthropic reçoivent des alias stables comme `claude-opus-4-8-YYYYMMDD`, dont l'année va de 2026 à 2035. La partie qui ressemble à une date
est un emplacement synthétique de route, et non la date de publication du modèle. Les emplacements de 2026 sont attribués en premier, de sorte que les alias
existants conservent leur identifiant ; les années suivantes ne sont utilisées qu'une fois 2026 saturée. Les véritables routes Anthropic Claude conservent
Les routes non Anthropic reçoivent des alias stables comme `claude-opus-4-8-p01q`, avec un code de quatre caractères préfixé par `p`. OpenCodex conserve
un emplacement synthétique daté en interne pour stabiliser les affectations du profil, mais n'expose pas cette date comme identifiant Desktop : les versions
actuelles de Desktop retirent les dates finales lors de la comparaison des modèles d'une session active, ce qui peut empêcher un changement. Les véritables routes Anthropic Claude conservent
leur identité. Les nouvelles routes appartiennent par défaut à la famille Opus, mais déplacer une route ne change ni le
fournisseur ni le modèle qu'elle appelle. Les anciens indicateurs `--static`, `--hybrid` et `--discovery-only`
restent disponibles pour les scripts existants.
Expand Down Expand Up @@ -376,10 +376,10 @@ chaque ligne du CLI Claude Code (`Routed by OpenCodex to <provider>/<model>` ; l
| Surface | Format | Exemple |
| --- | --- | --- |
| Claude Code CLI | `ocx-claude-<provider>--<model>` (simple) ou `ocx-claude2-…` (échappé) | `ocx-claude-native--gpt-5.6-sol` |
| Claude Desktop 3P | `claude-opus-4-8-<code>` (hachage base36 de 3 caractères) | `claude-opus-4-8-ncb` |
| Claude Desktop 3P | `claude-opus-4-8-p<code>` (emplacement base36 de 3 caractères) | `claude-opus-4-8-p01q` |

Le proxy choisit la famille pour chaque requête : `?ids=cli` ou `?ids=desktop` est prioritaire ; à défaut, l'agent utilisateur
`claude-code/*` reçoit la forme lisible de la CLI et les autres clients reçoivent la forme hachée de Claude Desktop.
`claude-code/*` reçoit la forme lisible de la CLI et les autres clients reçoivent le code Claude Desktop.
Les deux familles restent toujours décodables : un modèle enregistré sous l'une ou l'autre forme dans `settings.json` continue de fonctionner.
Chaque entrée porte un nom d'affichage explicite, comme `gemini-3-pro (gemini)`, ainsi que toutes les capacités du modèle
(échelle d'effort de raisonnement et types de réflexion) dans la structure officielle ModelInfo. Le mode passerelle tierce de Claude
Expand Down
24 changes: 12 additions & 12 deletions docs-site/src/content/docs/guides/claude-code.md
Original file line number Diff line number Diff line change
Expand Up @@ -324,10 +324,10 @@ Support/Claude/configLibrary` on macOS, `%APPDATA%\Claude\configLibrary` on Wind
`CLAUDE_USER_DATA_DIR` for an alternate Desktop user-data root. The legacy `Claude-3p` directory is
not read or deleted automatically.

Non-Anthropic routes receive stable aliases such as `claude-opus-4-8-YYYYMMDD`, where the year runs
from 2026 to 2035. The date-looking
part is a synthetic route slot, not the model's release date. 2026 slots are allocated first, so
existing aliases keep their ids; the later years are reached only once 2026 fills.
Non-Anthropic routes receive stable aliases such as `claude-opus-4-8-p01q`, with a `p`-prefixed
four-character code. OpenCodex keeps a separate synthetic date slot internally so existing profile
assignments stay stable, but it does not expose that date as the Desktop model id: current Desktop
builds strip terminal dates when comparing active-session models, which can suppress model changes.
Real Anthropic Claude routes keep
their real ids. New routes default to the Opus family, but moving a route does not change the
provider or model it calls. The legacy apply flags `--static`, `--hybrid`, and `--discovery-only`
Expand Down Expand Up @@ -452,22 +452,22 @@ for every Claude Code CLI row (`Routed by OpenCodex to <provider>/<model>`; nati
| Surface | Format | Example |
| --- | --- | --- |
| Claude Code CLI | `ocx-claude-<provider>--<model>` (plain) or `ocx-claude2-…` (escaped) | `ocx-claude-native--gpt-5.6-sol` |
| Claude Desktop 3P | `claude-opus-4-8-<code>` (3-char base36 hash) | `claude-opus-4-8-ncb` |
| Claude Desktop 3P | `claude-opus-4-8-p<code>` (3-char base36 profile slot) | `claude-opus-4-8-p01q` |

The proxy picks the family per request: `?ids=cli` or `?ids=desktop` wins; otherwise the
`claude-code/*` user-agent gets the readable CLI form and other clients get the Desktop hash.
`claude-code/*` user-agent gets the readable CLI form and other clients get the Desktop code.
Both families decode forever — a model saved in `settings.json` under either form keeps working.
Each entry carries an honest display name such as `gemini-3-pro (gemini)`, plus full model
capabilities (reasoning-effort ladder, thinking types) in the official ModelInfo shape so Claude
Desktop's third-party gateway mode can offer its effort selector. Real Anthropic models keep their
canonical ids. The synthetic 2026 date is an internal slot, not a release date. Legacy hash aliases and `claude-ocx-<provider>--<model>` / `claude-ocx2-<provider>--<model>` ids from older configs still resolve. A legacy id configured in an OpenCodex model slot (`claudeCode.model`, `tierModels`, `smallFastModel`) is sent to Claude Code in its current spelling automatically. A legacy id saved by Claude Code's own picker still routes, but Claude Code keeps its 200k accounting for that id. Pick `ocx-claude-` for a saved `claude-ocx-` id, and `ocx-claude2-` for a saved escaped `claude-ocx2-` id, so the real context window and compact both apply.

If Claude Desktop's footer picker does not change the model for an already-running 3P
conversation, you can try `/model <id>`, but this workaround may also fail on affected Desktop
builds. [Issue #3782](https://github.com/lidge-jun/opencodex/issues/3782) reports that on Windows
with Claude Desktop 1.46388.4, the conversation continues using its initial model after both
footer-picker and `/model` changes. The report does not establish which client or routing
component causes the behavior.
Older managed profiles exposed their internal `YYYYMMDD` slots directly. Affected Desktop builds strip
that terminal date when comparing active-session models, so two distinct routes can look identical
and no `set_model` control request is sent ([#3782](https://github.com/lidge-jun/opencodex/issues/3782)).
Current profiles expose non-date codes instead. After upgrading, reapply the Desktop profile and fully
quit and reopen Desktop; an already-running worker can still retain its old date-shaped id. The proxy
continues decoding those old ids for migration, but it cannot make Desktop emit a suppressed switch.

You can also try selecting the intended default model in the OpenCodex Claude Desktop profile,
reapplying the profile, and starting a new conversation. This is a troubleshooting step, not a
Expand Down
4 changes: 2 additions & 2 deletions docs-site/src/content/docs/ja/guides/claude-code.md
Original file line number Diff line number Diff line change
Expand Up @@ -244,10 +244,10 @@ Claude Code 2.1.129 以降は `GET /v1/models?limit=1000` でゲートウェイ
| 画面 | 形式 | 例 |
| --- | --- | --- |
| Claude Code CLI | `ocx-claude-<provider>--<model>` (plain) または `ocx-claude2-…` (escaped) | `ocx-claude-native--gpt-5.6-sol` |
| Claude Desktop 3P | `claude-opus-4-8-<code>` (3 桁の base36 ハッシュ) | `claude-opus-4-8-ncb` |
| Claude Desktop 3P | `claude-opus-4-8-p<code>` (3 桁の base36 プロファイルスロット) | `claude-opus-4-8-p01q` |

プロキシはリクエストごとに系列を選びます。`?ids=cli` または `?ids=desktop` が優先し、指定しないと
`claude-code/*` user-agent には読みやすい CLI 形式を、他のクライアントには Desktop ハッシュを
`claude-code/*` user-agent には読みやすい CLI 形式を、他のクライアントには Desktop コードを
提供します。両系列は継続してデコードできるため、どちらの形式でも `settings.json` に保存したモデルは
引き続き動作します。古い設定の `claude-ocx-<provider>--<model>` / `claude-ocx2-<provider>--<model>` も
引き続き解決されますが、保存済みの旧 ID はルーティングされても Claude Code 側では 200k として計算されます。
Expand Down
4 changes: 2 additions & 2 deletions docs-site/src/content/docs/ko/guides/claude-code.md
Original file line number Diff line number Diff line change
Expand Up @@ -279,10 +279,10 @@ Claude Code 2.1.129 이상은 `GET /v1/models?limit=1000`에서 게이트웨이
| 화면 | 형식 | 예시 |
| --- | --- | --- |
| Claude Code CLI | `ocx-claude-<provider>--<model>` (plain) 또는 `ocx-claude2-…` (escaped) | `ocx-claude-native--gpt-5.6-sol` |
| Claude Desktop 3P | `claude-opus-4-8-<code>` (3자리 base36 해시) | `claude-opus-4-8-ncb` |
| Claude Desktop 3P | `claude-opus-4-8-p<code>` (3자리 base36 프로필 슬롯) | `claude-opus-4-8-p01q` |

프록시는 요청마다 계열을 골라요. `?ids=cli` 또는 `?ids=desktop`이 우선하고, 지정하지 않으면
`claude-code/*` user-agent에는 읽기 쉬운 CLI 형식을, 다른 클라이언트에는 Desktop 해시를
`claude-code/*` user-agent에는 읽기 쉬운 CLI 형식을, 다른 클라이언트에는 Desktop 코드를
제공해요. 두 계열은 계속 디코딩할 수 있으므로 어느 형식이든 `settings.json`에 저장한 모델이
계속 작동해요.

Expand Down
4 changes: 2 additions & 2 deletions docs-site/src/content/docs/ru/guides/claude-code.md
Original file line number Diff line number Diff line change
Expand Up @@ -254,10 +254,10 @@ Claude Code 2.1.129+ обнаруживает модели шлюза через
| Интерфейс | Формат | Пример |
| --- | --- | --- |
| Claude Code CLI | `ocx-claude-<provider>--<model>` (plain) или `ocx-claude2-…` (escaped) | `ocx-claude-native--gpt-5.6-sol` |
| Claude Desktop 3P | `claude-opus-4-8-<code>` (3-символьный base36-хеш) | `claude-opus-4-8-ncb` |
| Claude Desktop 3P | `claude-opus-4-8-p<code>` (3-символьный слот профиля base36) | `claude-opus-4-8-p01q` |

Прокси выбирает семейство для каждого запроса: приоритет у `?ids=cli` или `?ids=desktop`; иначе
user-agent `claude-code/*` получает читаемую CLI-форму, а остальные клиенты — Desktop-хеш. Оба
user-agent `claude-code/*` получает читаемую CLI-форму, а остальные клиенты — Desktop-код. Оба
семейства декодируются бессрочно — модель, сохранённая в `settings.json` в любой из форм,
продолжает работать. Устаревшие id `claude-ocx-<provider>--<model>` и `claude-ocx2-<provider>--<model>`
из старых конфигураций тоже разрешаются, но Claude Code продолжает считать такой сохранённый id как 200k.
Expand Down
12 changes: 7 additions & 5 deletions docs-site/src/content/docs/tr/guides/claude-code.md
Original file line number Diff line number Diff line change
Expand Up @@ -246,9 +246,11 @@ alternatif bir Desktop kullanıcı verisi kökü için `CLAUDE_USER_DATA_DIR`
değerini ayarlayın. Eski `Claude-3p` dizini otomatik olarak okunmaz veya
silinmez.

Anthropic harici rotalar, `claude-opus-4-8-YYYYMMDD` gibi kararlı takma adlar
alır; yıl 2026 ile 2035 arasındadır. Tarih benzeri kısım, modelin çıkış tarihi
değil, sentetik bir rota yuvasıdır. Önce 2026 yuvaları atanır, bu nedenle mevcut
Anthropic harici rotalar, `p` önekli dört karakterli bir kod kullanan
`claude-opus-4-8-p01q` gibi kararlı takma adlar alır. OpenCodex profil atamalarını
kararlı tutmak için dahili olarak sentetik tarih yuvaları saklar; ancak güncel
Desktop sürümleri etkin oturum modellerini karşılaştırırken sondaki tarihleri
kaldırdığı ve model değişimini engelleyebildiği için bu tarihi Desktop model kimliği olarak yayımlamaz. Mevcut
takma adlar kimliklerini korur; sonraki yıllara ancak 2026 dolduktan sonra
geçilir. Gerçek Anthropic Claude rotaları kendi gerçek kimliklerini korur.
Yeni rotalar varsayılan olarak Opus ailesine gider, ancak bir rotayı taşımak
Expand Down Expand Up @@ -415,11 +417,11 @@ satırı için bir tane gönderir (`Routed by OpenCodex to <provider>/<model>`;
| Yüzey | Format | Örnek |
| --- | --- | --- |
| Claude Code CLI | `ocx-claude-<provider>--<model>` (düz) veya `ocx-claude2-…` (kaçışlı) | `ocx-claude-openai--gpt-5.6-sol` |
| Claude Desktop 3P | `claude-opus-4-8-<code>` (3 karakterli base36 karması) | `claude-opus-4-8-ncb` |
| Claude Desktop 3P | `claude-opus-4-8-p<code>` (3 karakterli base36 profil yuvası) | `claude-opus-4-8-p01q` |

Proxy, istek başına aileyi seçer: `?ids=cli` veya `?ids=desktop` kazanır; aksi
takdirde `claude-code/*` kullanıcı aracısı okunabilir CLI biçimini alır ve diğer
istemciler Desktop karmasını alır. Her iki aile de süresiz olarak kodu çözer —
istemciler Desktop kodunu alır. Her iki aile de süresiz olarak kodu çözer —
her iki biçimde `settings.json` içine kaydedilen bir model çalışmaya devam eder.
Her girdi, `gemini-3-pro (gemini)` gibi dürüst bir görünen adın yanı sıra Claude
Desktop'ın üçüncü taraf ağ geçidi modunun çaba seçicisini sunabilmesi için resmi
Expand Down
4 changes: 2 additions & 2 deletions docs-site/src/content/docs/zh-cn/guides/claude-code.md
Original file line number Diff line number Diff line change
Expand Up @@ -232,10 +232,10 @@ Claude Code 2.1.278 接受包含 `claude` 或 `anthropic` 的 ID。以 `claude-`
| 界面 | 格式 | 示例 |
| --- | --- | --- |
| Claude Code CLI | `ocx-claude-<provider>--<model>`(plain)或 `ocx-claude2-…`(escaped) | `ocx-claude-native--gpt-5.6-sol` |
| Claude Desktop 3P | `claude-opus-4-8-<code>`(3 字符 base36 哈希) | `claude-opus-4-8-ncb` |
| Claude Desktop 3P | `claude-opus-4-8-p<code>`(3 字符 base36 配置槽) | `claude-opus-4-8-p01q` |

代理会按请求选择别名族:`?ids=cli` 或 `?ids=desktop` 优先;否则,`claude-code/*`
user-agent 会获得易读的 CLI 形式,其他客户端会获得 Desktop 哈希形式。两种别名族都会永久
user-agent 会获得易读的 CLI 形式,其他客户端会获得 Desktop 代码形式。两种别名族都会永久
保持可解码——以任一形式保存在 `settings.json` 中的模型都能继续工作。

如果 Claude Desktop 底部的选择器没有切换正在进行的 3P 对话的模型,可以尝试
Expand Down
9 changes: 5 additions & 4 deletions docs-site/src/content/docs/zh-tw/guides/claude-code.md
Original file line number Diff line number Diff line change
Expand Up @@ -180,8 +180,9 @@ ocx claude desktop import <path> [--apply]
檔案,因此無效檔案不會改動目前設定檔。加上 `--apply` 可在匯入有效設定檔後立即寫入 Desktop。
`none` 僅適用於空系列;每個非空系列都必須保留一個預設。

非 Anthropic 路由會得到穩定別名,例如 `claude-opus-4-8-YYYYMMDD`,年份範圍為 2026 至 2035。看起來像日期的部分是合成的
路由槽位,不是模型釋出日期。系統會先配置 2026 的槽位,因此既有別名的 id 不變;2026 用盡後才會用到後續年份。
非 Anthropic 路由會得到穩定別名,例如 `claude-opus-4-8-p01q`,其後綴是以 `p` 開頭的四字元代碼。OpenCodex 仍會在內部保留合成日期槽位,
以維持既有設定檔配置的穩定性,但不會把日期當成 Desktop 模型 ID;目前的 Desktop 版本在比較作用中工作階段的模型時會移除尾端日期,
因而可能抑制模型切換。
真正的 Anthropic Claude 路由保留真實 id。新路由預設落在 Opus
系列,但移動路由不會改變它所呼叫的供應商或模型。舊版 apply 旗標 `--static`、`--hybrid` 與
`--discovery-only` 仍可供既有腳本使用。
Expand Down Expand Up @@ -308,10 +309,10 @@ Claude Code 2.1.278 接受包含 `claude` 或 `anthropic` 的 ID。以 `claude-`
| 介面 | 格式 | 示例 |
| --- | --- | --- |
| Claude Code CLI | `ocx-claude-<provider>--<model>`(plain)或 `ocx-claude2-…`(escaped) | `ocx-claude-native--gpt-5.6-sol` |
| Claude Desktop 3P | `claude-opus-4-8-<code>`(3 字元 base36 雜湊) | `claude-opus-4-8-ncb` |
| Claude Desktop 3P | `claude-opus-4-8-p<code>`(3 字元 base36 設定檔槽位) | `claude-opus-4-8-p01q` |

代理會按請求選擇別名族:`?ids=cli` 或 `?ids=desktop` 優先;否則,`claude-code/*`
user-agent 會獲得易讀的 CLI 形式,其他用戶端會獲得 Desktop 雜湊形式。兩種別名族都會永久
user-agent 會獲得易讀的 CLI 形式,其他用戶端會獲得 Desktop 代碼形式。兩種別名族都會永久
保持可解碼——以任一形式儲存在 `settings.json` 中的模型都能繼續工作。
每個條目帶有誠實的顯示名(如 `gemini-3-pro (gemini)`),並以官方 ModelInfo 形態附帶完整模型
能力(推理強度階梯、thinking 型別),使 Claude Desktop 的第三方閘道器模式能夠提供其推理強度
Expand Down
Loading
Loading