模型配置

​

可用模型

• 一個模型別名
• 一個模型名稱
  • Anthropic API：完整的**模型名稱**
  • Bedrock：推論設定檔 ARN
  • Foundry：部署名稱
  • Vertex：版本名稱

​

模型別名

​

使用 Fable 5

• 描述結果，而不是步驟：給它您想要的結果，讓它規劃路徑。若要讓它持續工作直到該結果成立，設定目標。
• 交給它模糊的問題：根本原因調查、中斷除錯和架構決策是額外調查和驗證發揮作用的地方。
• 跳過驗證提醒：它以較少的提示驗證自己的工作，所以測試或檢查的提醒通常是不必要的。
• 規劃更大的任務：給它您通常會分成多個部分的工作。它能維持長時間的會話而不失去思路。

​

設定您的模型

1. 在會話期間：使用 /model <alias|name> 立即切換，或執行 /model 不帶任何引數以開啟選擇器。當會話有先前的輸出時，選擇器會要求確認，因為下一個回應會重新讀取完整歷史記錄而不使用快取的 context
2. 在啟動時：使用 claude --model <alias|name> 啟動
3. 環境變數：設定 ANTHROPIC_MODEL=<alias|name>
4. 設定：在設定檔中使用 model 欄位永久配置

• Enter：切換模型並儲存為您的預設值
• s：僅針對此會話切換模型

# 使用 Opus 啟動
claude --model opus

# 在會話期間切換到 Sonnet
/model sonnet

{
    "permissions": {
        ...
    },
    "model": "opus"
}

​

限制模型選擇

• 主要會話模型：/model、--model 旗標、ANTHROPIC_MODEL 環境變數、model 設定，以及恢復會話時還原的模型
• 別名解析：ANTHROPIC_DEFAULT_OPUS_MODEL、ANTHROPIC_DEFAULT_SONNET_MODEL、ANTHROPIC_DEFAULT_HAIKU_MODEL 和 ANTHROPIC_DEFAULT_FABLE_MODEL 環境變數無法將允許的別名重新導向到清單外的模型
• 快速模式：/fast 在隱含切換到清單外的 Opus 模型時拒絕切換，並顯示訊息「不在您組織的允許模型中」
• 子代理模型：子代理 frontmatter 中的 model 欄位、Agent 工具的 model 參數、/agents 中的模型選擇器，以及 CLAUDE_CODE_SUBAGENT_MODEL
• 技能和命令模型：技能和命令中的 model frontmatter
• 顧問模型：已設定的 advisorModel 設定和 --advisor 旗標
• 背景代理模型：在分派選擇器中選擇的模型

{
  "availableModels": ["sonnet", "haiku"]
}

​

表面覆蓋

• 雲端會話在網路上的 Claude Code 或桌面應用程式中執行，在 Anthropic 管理的 VM 上執行：部署到您的裝置的設定無法到達它們，因此請透過伺服器管理設定傳遞允許清單。雲端會話中的中途會話模型切換在要求的模型被允許清單排除時被拒絕。會話建立時的伺服器端拒絕適用於組織模型限制，而不是 availableModels 設定鍵。
• Cowork 是 Claude 桌面應用程式中的代理工作標籤，不是 Claude Code 表面，根據設計不接收伺服器管理設定。受管理設定檔在會話執行的位置存在時適用於 Cowork 會話；遠端 Cowork 會話在 Anthropic 管理的 VM 上執行，其中不存在裝置部署的檔案。
• 第三方提供者（例如 Bedrock、Vertex AI、Foundry 和 AWS 上的 Claude Platform）上的會話不接收伺服器管理設定，因此請在那裡透過 MDM 或受管理設定檔傳遞允許清單。
• 伺服器管理傳遞也需要會話使用組織登入或直接設定的 API 金鑰進行驗證。只透過 apiKeyHelper 指令碼產生金鑰的艦隊應透過 MDM 或受管理設定檔傳遞允許清單。
• 桌面代碼標籤也裝載 SSH 會話，它們從執行所在的遠端主機讀取受管理設定檔。請參閱桌面受管理設定。
• claude.ai 和桌面應用程式中的模型選擇器會隱藏或灰顯您組織的允許清單排除的模型。選擇器狀態是使用者的便利；強制執行發生在會話中。

​

預設模型行為

​

對「預設」模型強制執行允許清單

{
  "availableModels": ["sonnet", "haiku"],
  "enforceAvailableModels": true
}

​

控制使用者執行的模型

• availableModels：限制使用者可以切換到的具名模型
• enforceAvailableModels：將 availableModels 允許清單擴展到「預設」選項，因此「預設」無法解析為清單外的模型
• model：設定會話啟動時的初始模型選擇
• ANTHROPIC_DEFAULT_SONNET_MODEL / ANTHROPIC_DEFAULT_OPUS_MODEL / ANTHROPIC_DEFAULT_HAIKU_MODEL / ANTHROPIC_DEFAULT_FABLE_MODEL：控制「預設」選項以及 sonnet、opus、haiku 和 fable 別名解析為什麼

{
  "model": "claude-sonnet-4-5",
  "availableModels": ["claude-sonnet-4-5", "haiku"],
  "enforceAvailableModels": true,
  "env": {
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-5"
  }
}

​

合併行為

​

Mantle 模型 ID

​

組織模型限制

​

特殊模型行為

​

default 模型設定

• Max、Team Premium、Enterprise 隨用隨付和 Anthropic API：預設為 Opus 4.8
• AWS 上的 Claude Platform：預設為 Opus 4.7
• Pro、Team Standard 和 Enterprise 訂閱席位：預設為 Sonnet 5
• Bedrock、Vertex 和 Foundry：預設為 Sonnet 4.5

​

opusplan 模型設定

• 在 Plan Mode 中：使用 opus 進行複雜推理和架構決策
• 在執行模式中：自動切換到 sonnet 進行程式碼生成和實現

​

回退模型鏈

claude --fallback-model sonnet,haiku

{
  "fallbackModel": ["claude-sonnet-5", "claude-haiku-4-5"]
}

• 不可用的模型：無法到達的模型，例如在設定中固定的已停用模型，會被跳過，Claude Code 會繼續到下一個元素。
• 超出允許清單：不被 availableModels 允許的元素在讀取鏈時會被刪除，永遠不會被嘗試。

​

自動模型回退

​

檢查觸發回退的原因

​

在切換前詢問

• 如果兩個模型都標記相同的請求，您可以編輯提示並重試，或啟動新會話。
• 在行動裝置 Claude Code on the web 會話上，不支援編輯和重試。切換模型，或從桌面瀏覽器或桌面應用程式繼續會話。
• 在 non-interactive mode 和無法顯示提示的 SDK 整合中，標記的請求以拒絕結束輪次。
• 當回退目標被 availableModels 阻止時，不會顯示提示。標記的請求以拒絕結束，與目標被阻止時的自動回退相同。

​

在 Bedrock、Vertex AI 和 Foundry 上啟用回退

• Claude Code 必須將目前模型識別為 Fable 5：模型 ID 包含 claude-fable-5、符合 ANTHROPIC_DEFAULT_FABLE_MODEL 的值，或使用 modelOverrides 對應。
• 回退目標必須解析為 Opus 模型：ANTHROPIC_DEFAULT_OPUS_MODEL 的值（如果設定），否則提供者模型清單中的 Opus 4.8 項目。

​

安全研究和生物學工作負載

​

調整努力等級

​

選擇努力等級

​

使用 ultrathink 進行一次性深入推理

​

設定努力等級

• /effort：執行 /effort 不帶引數以開啟互動式滑塊，執行 /effort 後跟等級名稱以直接設定，或執行 /effort auto 以重設為模型預設值
• 在 /model 中：選擇模型時使用左/右箭頭鍵調整努力滑塊
• --effort 旗標：在啟動 Claude Code 時傳遞等級名稱以為單一會話設定
• 環境變數：設定 CLAUDE_CODE_EFFORT_LEVEL 為等級名稱或 auto
• 設定：在設定檔中設定 effortLevel 為 low、medium、high 或 xhigh。max 和 ultracode 是僅限會話，此處不接受
• Skill 和 subagent frontmatter：在 skill 或 subagent markdown 檔案中設定 effort 以在該 skill 或 subagent 執行時覆蓋努力等級

​

自適應推理和固定思考預算

​

擴展思考

​

擴展 context

# 使用 opus[1m] 或 sonnet[1m] 別名
/model opus[1m]
/model sonnet[1m]

# 或將 [1m] 附加到完整模型名稱
/model claude-opus-4-8[1m]

​

Sonnet 5 的 context window

• LLM 閘道：當 ANTHROPIC_BASE_URL 指向閘道時，Claude Code 無法驗證 1M 支援。若要使用完整的 window，請在模型選擇器中選擇 Sonnet 5 (1M context)，它會對應到 sonnet[1m]。
• CLAUDE_CODE_DISABLE_1M_CONTEXT=1：將 Sonnet 5 會話視為具有 200K window，適用於需要限制 context 的部署。

​

檢查您目前的模型

• 在狀態行中（如果已配置）
• 在 /status 中，它也會顯示您的帳戶資訊

​

新增自訂模型選項

export ANTHROPIC_CUSTOM_MODEL_OPTION="my-gateway/claude-opus-4-8"
export ANTHROPIC_CUSTOM_MODEL_OPTION_NAME="Opus via Gateway"
export ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION="Custom deployment routed through the internal LLM gateway"

​

環境變數

​

為第三方部署固定模型

export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-8[1m]'

• Claude Code 在將模型 ID 發送到您的提供者之前會移除該後綴。
• 只有當基礎模型支援 1M context 時，才附加 [1m]。
• 後綴是按變數讀取的，而不是按模型讀取的。在 Bedrock、Vertex 和 Foundry 上，一個變數中沒有 [1m] 的模型 ID 會使用 200K context，即使另一個變數設定相同的模型並帶有後綴。Sonnet 5 在這些提供者上始終以 1M window 執行，永遠不需要後綴。

​

自訂固定模型顯示和能力

export ANTHROPIC_DEFAULT_OPUS_MODEL='arn:aws:bedrock:us-east-1:123456789012:custom-model/abc'
export ANTHROPIC_DEFAULT_OPUS_MODEL_NAME='Opus via Bedrock'
export ANTHROPIC_DEFAULT_OPUS_MODEL_DESCRIPTION='Opus 4.7 routed through a Bedrock custom endpoint'
export ANTHROPIC_DEFAULT_OPUS_MODEL_SUPPORTED_CAPABILITIES='effort,xhigh_effort,max_effort,thinking,adaptive_thinking,interleaved_thinking'

​

按版本覆蓋模型 ID

{
  "modelOverrides": {
    "claude-opus-4-7": "arn:aws:bedrock:us-east-2:123456789012:application-inference-profile/opus-prod",
    "claude-opus-4-6": "arn:aws:bedrock:us-east-2:123456789012:application-inference-profile/opus-46-prod",
    "claude-sonnet-4-6": "arn:aws:bedrock:us-east-2:123456789012:application-inference-profile/sonnet-prod"
  }
}

​

Prompt caching 配置