跳轉到主要內容

​
可用的模型

對於 Claude Code 中的 model 設定，您可以配置：
  • 一個模型別名
  • 一個完整的**模型名稱**
  • 對於 Bedrock，一個 ARN

​
模型別名

模型別名提供了一種便捷的方式來選擇模型設定，無需記住確切的版本號：
模型別名行為
default推薦的模型設定，取決於您的帳戶類型
sonnet使用最新的 Sonnet 模型（目前為 Sonnet 4.5）進行日常編碼任務
opus使用 Opus 模型（目前為 Opus 4.1）進行專門的複雜推理任務
haiku使用快速且高效的 Haiku 模型進行簡單任務
sonnet[1m]使用 Sonnet 搭配100 萬個 token 上下文視窗進行長時間會話
opusplan特殊模式，在計畫模式中使用 opus，然後在執行時切換到 sonnet

​
設定您的模型

您可以透過多種方式配置模型，按優先順序列出：
  1. 在會話期間 - 使用 /model <alias|name> 在會話中途切換模型
  2. 在啟動時 - 使用 claude --model <alias|name> 啟動
  3. 環境變數 - 設定 ANTHROPIC_MODEL=<alias|name>
  4. 設定 - 使用 model 欄位在您的設定檔中永久配置。
使用範例： 
# 使用 Opus 啟動
claude --model opus

# 在會話期間切換到 Sonnet
/model sonnet
設定檔範例： 
{
    "permissions": {
        ...
    },
    "model": "opus"
}

​
特殊模型行為

​
default 模型設定

default 的行為取決於您的帳戶類型。 對於某些 Max 用戶，如果您達到 Opus 的使用閾值，Claude Code 將自動回退到 Sonnet。

​
opusplan 模型設定

opusplan 模型別名提供了一種自動化的混合方法：
  • 在計畫模式中 - 使用 opus 進行複雜推理和架構決策
  • 在執行模式中 - 自動切換到 sonnet 進行程式碼生成和實現
這為您提供了兩全其美的方案：Opus 的優越推理能力用於計畫，Sonnet 的效率用於執行。

​
使用 [1m] 擴展上下文

對於 Console/API 用戶，可以將 [1m] 後綴添加到完整模型名稱以啟用100 萬個 token 上下文視窗。 
# 使用帶有 [1m] 後綴的完整模型名稱的範例
/model anthropic.claude-sonnet-4-5-20250929-v1:0[1m]
注意：擴展上下文模型具有不同的定價。

​
檢查您目前的模型

您可以透過多種方式查看您目前使用的模型：
  1. 在狀態行中（如果已配置）
  2. 在 /status 中，它也會顯示您的帳戶資訊。

​
環境變數

您可以使用以下環境變數（必須是完整的模型名稱）來控制別名對應的模型名稱。
環境變數描述
ANTHROPIC_DEFAULT_OPUS_MODEL用於 opus 的模型，或在計畫模式啟用時用於 opusplan 的模型。
ANTHROPIC_DEFAULT_SONNET_MODEL用於 sonnet 的模型，或在計畫模式未啟用時用於 opusplan 的模型。
ANTHROPIC_DEFAULT_HAIKU_MODEL用於 haiku 的模型，或背景功能
CLAUDE_CODE_SUBAGENT_MODEL用於子代理的模型
注意：ANTHROPIC_SMALL_FAST_MODEL 已棄用，改用 ANTHROPIC_DEFAULT_HAIKU_MODEL。

​
提示快取配置

Claude Code 自動使用提示快取來優化效能並降低成本。您可以全域禁用提示快取或針對特定模型層禁用：
環境變數描述
DISABLE_PROMPT_CACHING設定為 1 以禁用所有模型的提示快取（優先於各模型設定）
DISABLE_PROMPT_CACHING_HAIKU設定為 1 以僅禁用 Haiku 模型的提示快取
DISABLE_PROMPT_CACHING_SONNET設定為 1 以僅禁用 Sonnet 模型的提示快取
DISABLE_PROMPT_CACHING_OPUS設定為 1 以僅禁用 Opus 模型的提示快取
這些環境變數為您提供了對提示快取行為的細粒度控制。全域 DISABLE_PROMPT_CACHING 設定優先於模型特定設定，允許您在需要時快速禁用所有快取。各模型設定對於選擇性控制很有用，例如在調試特定模型或使用可能具有不同快取實現的雲端提供商時。