Claude Code ANTHROPIC_BASE_URL 更新:9 月 29 日起 1M 上下文與許可權預設值的 4 項變化
2026 年 9 月 29 日釋出的 Claude Code 2.1.285 改了與 ANTHROPIC_BASE_URL 有關的幾件事:透過自定義介面地址連線的會話,會使用模型自帶的 1M 上下文視窗;新增 allowedProviders 託管設定;第三方提供方上的 -p 與 SDK 會話,在沒有配置許可權模式時按 auto mode 啟動。10 月 16 日的 2.1.302 又把後一項在特定條件下改回了 default。下面按官方 changelog 梳理,並給出自查步驟。
9 月 29 日的 2.1.285 改了什麼?
據官方 changelog,2.1.285(2026 年 9 月 29 日)有四條相關改動:
- 新增
allowedProviders託管設定,用來限定一臺機器可以使用的 API 提供方,範圍包括 Anthropic API、自定義端點、Bedrock、Mantle、Vertex AI、Foundry、Claude Platform on AWS 和 Cloud gateway。 - 在自定義
ANTHROPIC_BASE_URL之後的會話,會使用有 1M 視窗的模型的 1M 上下文(changelog 列出 Opus 4.7+、Sonnet 5+、Fable)。如果你的閘道器只支援到 200K,官方建議執行/autocompact 200k。 - 把“將 auto mode 設為預設許可權模式”的一次性提示,也擴充套件到第三方提供方和關閉遙測的情況。
claude -p和 Python Agent SDK 會話在第三方提供方或關閉遙測時,若沒有配置許可權模式,按 auto mode 啟動,與互動會話一致;--permission-mode仍可覆蓋。
之後還有哪些相關變化?
| 版本 | 日期 | 與本文相關的內容 |
|---|---|---|
| 2.1.287 | 10 月 1 日 | Opus 4.7+ 與 Fable 在 Bedrock、Vertex、Foundry 和 Claude apps gateway 上預設 1M 上下文,不需要 [1m] 字尾;設 CLAUDE_CODE_DISABLE_1M_CONTEXT=1 可保持 200K |
| 2.1.295 | 10 月 8 日 | apps gateway 的每個上游可配可選的 models 列表;timeouts.upstream_ttfb_ms 可限制流開始前的等待;閘道器或雲廠商拒絕 context-1m beta 時,Claude Code 會去掉它重發 |
| 2.1.302 | 10 月 16 日 | 第三方提供方上,claude -p 與 Agent SDK 會話在沒有許可權模式、且遙測關閉或全新安裝時,以 default 模式啟動;--permission-mode auto 仍保持 auto |
注意 2.1.302 的原文帶有條件(第三方提供方、遙測關閉或全新安裝),具體行為以官方文件和你實際版本為準。
我現在用的是哪個介面地址和許可權模式?
- 看環境變數:
echo $ANTHROPIC_BASE_URL。有值就說明請求不走官方預設地址。也檢查~/.claude/settings.json的env欄位是否寫了它。 - 看版本:
claude --version。低於 2.1.285 不會有上述 1M 行為,高於 2.1.302 的行為以最新 changelog 為準。 - 看許可權模式:在會話裡檢視當前模式,或在指令碼呼叫時顯式寫
claude -p --permission-mode default。不想依賴版本預設值,就顯式指定。 - 企業環境檢查託管設定裡是否有
allowedProviders,它限定的是允許使用的提供方,不是模型。
1M 上下文到底生效了沒有?
介面地址換了,視窗不一定跟著變,因為閘道器要真的支援。可以這樣判斷:
- 先確認你用的模型屬於 changelog 列出的、本身有 1M 視窗的那類。
- 長會話裡如果過早觸發壓縮或報上下文超限,說明閘道器可能只到 200K,按官方建議執行
/autocompact 200k。 - 2.1.295 之後,閘道器拒絕 context-1m beta 時不再讓每個請求失敗,會自動去掉後重發,因此“能用但視窗小”比以前更常見。具體支援範圍問你的閘道器提供方。
怎麼測介面延遲?
自定義地址多一跳,首字時間可能變長。可以在 cdnping 首頁 測各 API 入口的首次連線與往返,用 Anthropic 狀態頁 看官方入口的探測記錄,對比你的閘道器。遇到整體不可用,可看 Claude Code 掛了嗎。延遲偏高的常見原因見 Claude Code 慢怎麼辦。
接 AGI Plan 要注意什麼?
AGI Plan 是 cdnping 的商業合作方,它相容 Anthropic 介面格式,使用 Claude Code 只需改一個介面地址,不需要 Claude 賬號。站方明確說明自己不是官方授權渠道;部分模型僅境外可用,具體以 https://agiplan.dev/models 為準。上線前建議先讀 Claude API 中轉靠譜嗎,按其中方法自查。基礎配置見 Claude Code 自定義 API 與 Codex、OpenCode 介面地址配置。
許可權模式相關還可以讀什麼?
auto mode 的判斷與排查見 Claude Code 預設進入 auto mode。
以上內容截至 2026 年 10 月,版本行為可能繼續調整,請以官方 changelog 為準。
參考來源
- Claude Code Changelog(官方),2.1.285、2.1.287、2.1.295、2.1.302 條目