配置
模型配置
了解 Claude Code 模型配置,包括像 opusplan
這樣的模型別名
可用模型
對於 Claude Code 中的 model
設定,您可以配置:
- 一個模型別名
- 一個完整的**模型名稱**
- 對於 Bedrock,一個 ARN
模型別名
模型別名提供了一種便利的方式來選擇模型設定,而無需記住確切的版本號:
模型別名 | 行為 |
---|---|
default | 推薦的模型設定,取決於您的帳戶類型 |
sonnet | 使用最新的 Sonnet 模型(目前是 Sonnet 4)進行日常編碼任務 |
opus | 使用最強大的 Opus 模型(目前是 Opus 4.1)進行複雜推理 |
haiku | 使用快速高效的 Haiku 模型進行簡單任務 |
sonnet[1m] | 使用具有100萬個令牌上下文視窗的 Sonnet 進行長時間會話 |
opusplan | 特殊模式,在計劃模式期間使用 opus ,然後切換到 sonnet 進行執行 |
設定您的模型
您可以通過多種方式配置您的模型,按優先級順序列出:
- 會話期間 - 使用
/model <alias|name>
在會話中途切換模型 - 啟動時 - 使用
claude --model <alias|name>
啟動 - 環境變數 - 設定
ANTHROPIC_MODEL=<alias|name>
- 設定 - 使用
model
欄位在您的設定檔案中永久配置。
使用範例:
設定檔案範例:
特殊模型行為
default
模型設定
default
的行為取決於您的帳戶類型。
對於某些 Max 用戶,如果您使用 Opus 達到使用閾值,Claude Code 將自動回退到 Sonnet。
opusplan
模型設定
opusplan
模型別名提供了一種自動化的混合方法:
- 在計劃模式中 - 使用
opus
進行複雜推理和架構決策 - 在執行模式中 - 自動切換到
sonnet
進行代碼生成和實現
這為您提供了兩全其美的效果:Opus 在計劃方面的卓越推理能力,以及 Sonnet 在執行方面的效率。
使用 [1m] 擴展上下文
對於 Console/API 用戶,可以在完整模型名稱後添加 [1m]
後綴以啟用100萬個令牌上下文視窗。
注意:擴展上下文模型有不同的定價。
檢查您當前的模型
您可以通過多種方式查看您當前使用的模型:
- 在狀態列中(如果已配置)
- 在
/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
。