Claude Code 模型配置详解
在开发中,合理配置 Anthropic Claude 模型的参数能显著提升代码生成的效率与准确性。这些参数本质上是不同版本模型的预设标识符,用于简化调用配置,避免硬编码。下面咱们直接拆解核心参数含义、配置方法以及默认值逻辑。
一、核心参数含义与作用
每个参数对应不同定位的 Claude 模型,具体映射关系如下:
| 参数名 | 核心作用 | 适用场景 | 对应官方模型 ID 示例 |
|---|---|---|---|
ANTHROPIC_MODEL | 通用/顶层模型参数,可覆盖其他默认模型参数,是所有 Claude 调用的'全局开关' | 统一指定所有代码任务的模型(如全局切换为 Sonnet) | 可设为任意 Claude 模型 ID(如 claude-3-5-sonnet-20240620) |
ANTHROPIC_DEFAULT_OPUS_MODEL | 预设 Claude Opus(旗舰版)模型的标识符,Opus 是推理能力最强的模型 | 复杂代码任务(大型项目重构、算法设计、多语言代码整合、核心逻辑开发) | claude-3-5-opus-20240620 |
ANTHROPIC_DEFAULT_SONNET_MODEL | 预设 Claude Sonnet(平衡版)模型的标识符,性能/速度/成本最优平衡 | 常规代码任务(接口开发、Bug 修复、代码注释/重构、逻辑验证)→ 代码开发默认首选 | claude-3-5-sonnet-20240620 |
ANTHROPIC_DEFAULT_HAIKU_MODEL | 预设 Claude Haiku(轻量版)模型的标识符,速度最快、成本最低 | 轻量代码任务(单行代码生成、语法检查、简单函数编写、快速代码解释) | claude-3-haiku-20240307 |
CLAUDE_CODE_SUBAGENT_MODEL | 指定'代码子代理'的模型,子代理是处理细分代码任务的模块 | 代码子任务(可单独指定模型,如主模型用 Sonnet,子代理用 Haiku 提升速度) | 通常设为 Haiku/Sonnet,复杂子任务可设为 Opus |
二、配置方法(实战示例)
配置的核心是将这些参数映射到 Anthropic 官方模型 ID。推荐两种方式:优先环境变量配置以解耦代码与配置,或者直接在 IDE 插件中设置。
1. 环境变量配置(生产环境推荐)
通过系统或项目环境变量定义参数,代码中直接读取,无需修改代码即可切换模型。
Windows CMD 终端:
set ANTHROPIC_API_KEY=your-api-key-here
set ANTHROPIC_MODEL=claude-3-5-sonnet-20240620
set ANTHROPIC_DEFAULT_OPUS_MODEL=claude-3-5-opus-20240620
set ANTHROPIC_DEFAULT_SONNET_MODEL=claude-3-5-sonnet-20240620
set ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-3-haiku-20240307
set CLAUDE_CODE_SUBAGENT_MODEL=claude-3-haiku-20240307
Linux/macOS 终端:
ANTHROPIC_API_KEY=
ANTHROPIC_MODEL=
ANTHROPIC_DEFAULT_OPUS_MODEL=
ANTHROPIC_DEFAULT_SONNET_MODEL=
ANTHROPIC_DEFAULT_HAIKU_MODEL=
CLAUDE_CODE_SUBAGENT_MODEL=

