Skip to content

Commit 9fe96b6

Browse files
lidge-junclaude
andcommitted
docs(claude): document long-window 1M marking in the Claude Code guides
English and the six translated guides now say that a window of 1M or at least the 829,800 default compaction threshold gets the [1m] row, that the floor is fixed, that Claude models on an Anthropic route need a genuine 1M, and that an overflow is recovered by Claude Code's own compaction. Co-Authored-By: Claude Opus 5.5 <[email protected]>
1 parent 74bc4d3 commit 9fe96b6

7 files changed

Lines changed: 31 additions & 20 deletions

File tree

‎docs-site/src/content/docs/fr/guides/claude-code.md‎

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -423,7 +423,7 @@ d'OpenCodex, de réappliquer ce profil et de démarrer une nouvelle conversation
423423
dépannage, sans garantie de résolution. OpenCodex ne peut pas observer l'état du sélecteur ; il achemine
424424
l'identifiant du modèle porté par chaque requête. Vérifiez ce que le client envoie sous **Logs → requestedModel**.
425425

426-
Les modèles dont la fenêtre de contexte de référence atteint 1M obtiennent une ligne supplémentaire `…[1m]` dans le sélecteur.
426+
Les modèles dont la fenêtre de contexte de référence atteint 1M ou au moins le seuil de compactage par défaut (829 800) obtiennent une ligne supplémentaire `…[1m]` dans le sélecteur.
427427
Sa sélection indique à Claude Code la fenêtre complète de 1M pour ce modèle, tout en maintenant le compactage automatique ; le proxy retire
428428
le marqueur avant le routage.
429429
La sélection est conservée dans le champ `model` de `settings.json` ; pour les requêtes entrantes, l'alias est de nouveau
@@ -458,8 +458,10 @@ conservent leurs identifiants canoniques sur les deux interfaces.
458458

459459
### Marqueur `[1m]` de variante contextuelle
460460

461-
Les modèles dont la fenêtre de contexte de référence atteint 1M — ou, avec le contexte automatique, dépasse 200k tout en atteignant
462-
au moins le seuil de compactage — obtiennent une ligne supplémentaire `…[1m]` dans le sélecteur. En la sélectionnant, Claude Code
461+
Les modèles dont la fenêtre de contexte de référence atteint 1M ou au moins le seuil de compactage par défaut (829 800)
462+
obtiennent une ligne supplémentaire `…[1m]` dans le sélecteur. Ce plancher est fixe : modifier la valeur de compactage ne l'abaisse pas,
463+
et un modèle Claude sur une route Anthropic doit réellement atteindre 1M. Sans contexte automatique, seule une fenêtre de 1M compte.
464+
Au-delà de la fenêtre réelle, l'erreur `prompt is too long` déclenche le compactage automatique de Claude Code. En la sélectionnant, Claude Code
463465
tient compte d'un contexte complet de 1M. Le proxy supprime le suffixe `[1m]`, sans tenir compte de la casse, avant la
464466
résolution de l'alias et le routage.
465467

‎docs-site/src/content/docs/guides/claude-code.md‎

Lines changed: 7 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -584,7 +584,8 @@ reapplying the profile, and starting a new conversation. This is a troubleshooti
584584
guaranteed fix. OpenCodex cannot observe picker state; it routes the model id carried by each
585585
request. Confirm what the client sends under **Logs → requestedModel**.
586586

587-
Models with an authoritative 1M context window get an extra `…[1m]` picker row: selecting it makes
587+
Models with a long context window (1M, or at least the 829,800-token default compaction threshold;
588+
Claude models on an Anthropic route need a genuine 1M) get an extra `…[1m]` picker row: selecting it makes
588589
Claude Code account a full 1M context for that model (auto-compaction stays on) — the proxy strips
589590
the marker before routing.
590591
Selecting one persists it to Claude Code's `settings.json` `model` field; inbound requests resolve
@@ -620,8 +621,10 @@ keep their canonical ids on both surfaces.
620621

621622
### Context-variant `[1m]` marker
622623

623-
Models with an authoritative context window of 1M (or, under auto-context, above 200k and at
624-
least the compaction threshold) get an extra `…[1m]` picker row. Selecting it makes Claude Code
624+
Models with an authoritative context window of 1M, or at least the 829,800-token default
625+
compaction threshold, get an extra `…[1m]` picker row; the floor is fixed, so a custom compaction
626+
value does not lower it, and Claude models on an Anthropic route need a genuine 1M. Turning
627+
auto-context off limits the row to 1M windows. Selecting it makes Claude Code
625628
account a full 1M context. The proxy strips the case-insensitive `[1m]` suffix before alias
626629
resolution and routing.
627630

@@ -1045,7 +1048,7 @@ the confirmed obsolete token file and applying first-party mode again; never del
10451048

10461049
### First-party picker context markers
10471050

1048-
The Desktop Code-tab picker adds `[1m]` to routed models whose authoritative context window is at least one million tokens, so Claude uses its 1M accounting instead of the smaller custom-model fallback. Labels, profile order, and provider routes stay unchanged. Unknown and sub-million windows remain unmarked, including native long-window opt-ins: the picker cannot guarantee that a Desktop or remote runner receives the matching compaction environment. The paired auto-context setup for `ocx claude` is unchanged. An existing conversation keeps its saved selector until you select the model again from the refreshed picker.
1051+
The Desktop Code-tab picker adds `[1m]` to routed models whose authoritative context window is at least one million tokens or at least the 829,800-token default compaction threshold (for example a native GPT-6 model opted into its 872k window), so Claude uses its 1M accounting instead of the smaller custom-model fallback. Claude models on an Anthropic route still need a genuine 1M. Labels, profile order, and provider routes stay unchanged. Unknown and shorter windows remain unmarked. The picker cannot guarantee that a Desktop or remote runner receives the matching compaction environment, so a long-window model that outgrows its real window gets a `prompt is too long` error, which Claude Code answers by compacting. Desktop 3P `supports1m`/`prefer1m` and generated subagents follow the same rule. The paired auto-context setup for `ocx claude` is unchanged. An existing conversation keeps its saved selector until you select the model again from the refreshed picker.
10491052

10501053
### Forced Claude Code subagent model
10511054

‎docs-site/src/content/docs/ja/guides/claude-code.md‎

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -311,8 +311,9 @@ v2 エイリアスはエスケープを展開します。読みやすい形式
311311

312312
### コンテキスト変種 `[1m]` 標識
313313

314-
公式コンテキストウィンドウが 1M のモデルには `…[1m]` ピッカー行がもう一つできます。自動コンテキスト使用時は
315-
コンテキストが 200k を超え、圧縮しきい値以上のモデルも該当します。この行を選ぶと Claude Code が
314+
公式コンテキストウィンドウが 1M、またはデフォルトの圧縮しきい値(829,800)以上のモデルには `…[1m]` ピッカー行がもう一つできます。
315+
この基準は固定で、圧縮値を変えても下がりません。Anthropic 経路の Claude モデルは実際に 1M である必要があります。自動コンテキストをオフにすると
316+
1M のモデルだけが対象です。実際のウィンドウを超えると `prompt is too long` エラーが返り、Claude Code が自動で圧縮します。この行を選ぶと Claude Code が
316317
全体 1M コンテキストを計算します。プロキシはエイリアス解決とルーティング前に大文字小文字を区別せず `[1m]`
317318
接尾辞を削除します。
318319

‎docs-site/src/content/docs/ko/guides/claude-code.md‎

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -283,7 +283,7 @@ import/export는 로컬 설정만 다뤄요. 허브 프로필을 바꾸지 않
283283
능력 정보(추론 강도 사다리, thinking 타입)를 실어 보냅니다 — Claude Desktop의 서드파티
284284
게이트웨이 모드가 추론 강도 선택 UI를 열 수 있게 하기 위해서입니다. 실제 Anthropic 모델은
285285
원래 id를 그대로 유지합니다. 합성된 2026 날짜는 내부 슬롯이며 출시일이 아닙니다. 구버전의
286-
해시 별칭과 `claude-ocx-<provider>--<model>`, `claude-ocx2-<provider>--<model>` 별칭도 계속 해석됩니다. 저장된 `claude-ocx-`는 `ocx-claude-`로, 이스케이프된 `claude-ocx2-`는 `ocx-claude2-`로 한 번 다시 고르면 실제 컨텍스트 창과 compact가 함께 적용됩니다. 컨텍스트가 1M인 모델에는
286+
해시 별칭과 `claude-ocx-<provider>--<model>`, `claude-ocx2-<provider>--<model>` 별칭도 계속 해석됩니다. 저장된 `claude-ocx-`는 `ocx-claude-`로, 이스케이프된 `claude-ocx2-`는 `ocx-claude2-`로 한 번 다시 고르면 실제 컨텍스트 창과 compact가 함께 적용됩니다. 컨텍스트가 1M이거나 기본 압축 임곗값(829,800) 이상인 모델에는
287287
`…[1m]` 행이 하나 더 생깁니다 — 이걸 고르면 Claude Code가 그 모델의 컨텍스트를 1M로 계산합니다
288288
(자동 요약 유지, 프록시가 표식을 떼고 라우팅). 선택하면 Claude Code의
289289
`settings.json` `model` 필드에 저장되고, 인바운드 요청에서
@@ -343,8 +343,9 @@ v2 별칭은 이스케이프를 펼쳐요. 읽기 쉬운 형식으로 표현할
343343

344344
### 컨텍스트 변형 `[1m]` 표식
345345

346-
공식 컨텍스트 창이 1M인 모델에는 `…[1m]` 선택기 행이 하나 더 생겨요. 자동 컨텍스트를 사용할
347-
때는 컨텍스트가 200k를 넘고 압축 임곗값 이상인 모델도 해당해요. 이 행을 선택하면 Claude Code가
346+
공식 컨텍스트 창이 1M이거나 기본 압축 임곗값(829,800) 이상인 모델에는 `…[1m]` 선택기 행이 하나 더
347+
생겨요. 이 기준은 고정이라 압축 값을 직접 바꿔도 낮아지지 않고, Anthropic 경로의 Claude 모델은 실제 1M이어야
348+
해요. 자동 컨텍스트를 끄면 1M 모델만 해당해요. 실제 창을 넘으면 `prompt is too long` 오류가 오고 Claude Code가 자동으로 압축해요. 이 행을 선택하면 Claude Code가
348349
전체 1M 컨텍스트를 계산해요. 프록시는 별칭 해석과 라우팅 전에 대소문자를 구분하지 않고 `[1m]`
349350
접미사를 제거해요.
350351

‎docs-site/src/content/docs/ru/guides/claude-code.md‎

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -330,8 +330,10 @@ Anthropic сохраняют канонические id в обоих инте
330330

331331
### Маркер контекстного варианта `[1m]`
332332

333-
Модели с подтверждённым контекстным окном 1M (или, при автоконтексте, больше 200k и не ниже
334-
порога сжатия) получают дополнительную строку `…[1m]` в селекторе. Её выбор заставляет Claude Code
333+
Модели с подтверждённым контекстным окном 1M или не ниже порога сжатия по умолчанию (829 800)
334+
получают дополнительную строку `…[1m]` в селекторе. Этот порог фиксирован: изменение значения сжатия его
335+
не понижает, а модель Claude на маршруте Anthropic должна действительно иметь 1M. Без автоконтекста учитываются
336+
только окна 1M. При выходе за реальное окно приходит ошибка `prompt is too long`, и Claude Code сам сжимает контекст. Её выбор заставляет Claude Code
335337
учитывать полный контекст 1M. Прокси удаляет суффикс `[1m]` (без учёта регистра) до разрешения
336338
алиасов и маршрутизации.
337339

‎docs-site/src/content/docs/zh-cn/guides/claude-code.md‎

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -239,7 +239,7 @@ UI。真实 Anthropic 模型保留其原始 id。合成的 2026 日期是内部
239239
别名和 `claude-ocx-<provider>--<model>` 别名仍可解析,转义的 `claude-ocx2-<provider>--<model>` 也同样可解析。
240240
已保存的旧 id 仍会路由,但 Claude Code 对它仍按 200k 计算。把已保存的 `claude-ocx-` 重新选一次对应的
241241
`ocx-claude-`,转义的 `claude-ocx2-` 重新选一次 `ocx-claude2-`,即可同时用上真实上下文窗口和 compact。
242-
拥有 1M 上下文的模型会多出一行 `…[1m]`:
242+
上下文为 1M 或不低于默认压缩阈值(829,800)的模型会多出一行 `…[1m]`:
243243
选中后 Claude Code 会按 1M 计算该模型的上下文(自动压缩保留,代理在路由前去掉该标记)。
244244
选中后会保存到 Claude Code 的 `settings.json` `model` 字段;入站请求会将别名解析回路由
245245
模型。旧版 Claude Code 中选择器保持原生 — 通过 `ANTHROPIC_MODEL` 设置槽位,或直接在 `/model`
@@ -293,8 +293,9 @@ v1 别名按字面解码(历史上 model ID 中包含的两字符序列 `~s` /
293293

294294
### 上下文变体 `[1m]` 标记
295295

296-
权威上下文窗口为 1M 的模型(或者启用自动上下文时,窗口大于 200k 且至少达到压缩阈值的模型)
297-
会多出一个带 `…[1m]` 的选择器条目。选择它后,Claude Code 会按完整的 1M 上下文计算。
296+
权威上下文窗口为 1M 或不低于默认压缩阈值(829,800)的模型会多出一个带 `…[1m]` 的选择器条目。
297+
该下限是固定的,修改压缩值不会降低它;Anthropic 路由上的 Claude 模型必须真正达到 1M;关闭自动上下文后只对 1M 模型生效。
298+
超出真实窗口时会返回 `prompt is too long` 错误,Claude Code 会自动压缩。选择它后,Claude Code 会按完整的 1M 上下文计算。
298299
代理会在进行别名解析和路由之前移除不区分大小写的 `[1m]` 后缀。
299300

300301
## 自动上下文(突破 200k 上限的大上下文模型)

‎docs-site/src/content/docs/zh-tw/guides/claude-code.md‎

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -339,7 +339,7 @@ user-agent 會獲得易讀的 CLI 形式,其他用戶端會獲得 Desktop 代
339339
也同樣可解析。已儲存的舊 id 仍會路由,但 Claude Code 對它仍按 200k 計算。把已儲存的 `claude-ocx-`
340340
重新選一次對應的 `ocx-claude-`,跳脫的 `claude-ocx2-` 重新選一次 `ocx-claude2-`,即可同時用上真實上下文
341341
視窗與 compact。
342-
擁有權威 1M 上下文視窗的模型會多出一個 `…[1m]` 選擇器列:選中後 Claude Code 會按完整 1M 上下文
342+
權威上下文視窗為 1M 或不低於預設壓縮閾值(829,800)的模型會多出一個 `…[1m]` 選擇器列:選中後 Claude Code 會按完整 1M 上下文
343343
計算該模型(自動壓縮仍開啟)——代理在路由前會去掉該標記。
344344
選中後會儲存到 Claude Code 的 `settings.json` `model` 欄位;入站請求會將別名解析回路由
345345
模型。在較舊的 Claude Code 版本中,選擇器保持原生——可透過 `ANTHROPIC_MODEL` 設定槽位,或在
@@ -369,8 +369,9 @@ v1 別名按字面解碼(歷史上 model ID 中包含的兩字元序列 `~s` /
369369

370370
### 上下文變體 `[1m]` 標記
371371

372-
權威上下文視窗為 1M 的模型(或者啟用自動上下文時,視窗大於 200k 且至少達到壓縮閾值的模型)
373-
會多出一個帶 `…[1m]` 的選擇器條目。選擇它後,Claude Code 會按完整的 1M 上下文計算。
372+
權威上下文視窗為 1M 或不低於預設壓縮閾值(829,800)的模型會多出一個帶 `…[1m]` 的選擇器條目。
373+
該下限是固定的,修改壓縮值不會降低它;Anthropic 路由上的 Claude 模型必須真正達到 1M;關閉自動上下文後只對 1M 模型生效。
374+
超出真實視窗時會回傳 `prompt is too long` 錯誤,Claude Code 會自動壓縮。選擇它後,Claude Code 會按完整的 1M 上下文計算。
374375
代理會在進行別名解析和路由之前移除不區分大小寫的 `[1m]` 字尾。
375376

376377
## 自動上下文(突破 200k 上限的大上下文模型)

0 commit comments

Comments
 (0)