Claude Code 模型配置详解：参数、环境与实战

2. 代码中直接配置（Python SDK 示例）

先安装依赖：

pip install anthropic

完整配置与调用示例，这里我们优先读环境变量，兜底设默认值：

import os
from anthropic import Anthropic

# 1. 定义模型参数
ANTHROPIC_MODEL = os.getenv("ANTHROPIC_MODEL", "claude-3-5-sonnet-20240620")
ANTHROPIC_DEFAULT_OPUS_MODEL = os.getenv("ANTHROPIC_DEFAULT_OPUS_MODEL", "claude-3-5-opus-20240620")
ANTHROPIC_DEFAULT_SONNET_MODEL = os.getenv("ANTHROPIC_DEFAULT_SONNET_MODEL", "claude-3-5-sonnet-20240620")
ANTHROPIC_DEFAULT_HAIKU_MODEL = os.getenv("ANTHROPIC_DEFAULT_HAIKU_MODEL", "claude-3-haiku-20240307")
CLAUDE_CODE_SUBAGENT_MODEL = os.getenv("CLAUDE_CODE_SUBAGENT_MODEL", ANTHROPIC_DEFAULT_HAIKU_MODEL)

# 2. 初始化 Anthropic 客户端（API Key 从环境变量读取）
client = Anthropic(api_key=os.getenv("ANTHROPIC_API_KEY"))

# 3. 不同场景的调用示例
# 示例 1：常规代码任务（用通用模型）
def regular_code_task(prompt):
    response = client.messages.create(
        model=ANTHROPIC_MODEL,
        max_tokens=1024,
        temperature=0.2, # 代码任务建议低温度，保证准确性
        messages=[{"role": "user", "content": prompt}]
    )
    return response.content[0].text

# 示例 2：复杂代码任务（专用 Opus 模型）
def complex_code_task(prompt):
    response = client.messages.create(
        model=ANTHROPIC_DEFAULT_OPUS_MODEL,
        max_tokens=2048,
        temperature=0.1,
        messages=[{"role": "user", "content": prompt}]
    )
    return response.content[0].text

# 示例 3：代码子代理任务（轻量 Haiku 模型）
def code_subagent_task(prompt):
    response = client.messages.create(
        model=CLAUDE_CODE_SUBAGENT_MODEL,
        max_tokens=512,
        temperature=0.0,
        messages=[{"role": "user", "content": prompt}]
    )
    return response.content[0].text

# 测试调用
if __name__ == "__main__":
    # 常规任务：生成 FastAPI 接口
    print("=== 常规代码任务 ===")
    print(regular_code_task("写一个 FastAPI 的用户登录接口，包含手机号 + 密码校验"))
    
    # 复杂任务：设计分布式锁
    print("\n=== 复杂代码任务 ===")
    print(complex_code_task("设计基于 Redis 的 Python 分布式锁，处理并发和超时问题"))
    
    # 子代理任务：语法检查
    print("\n=== 代码子代理任务 ===")
    print(code_subagent_task("检查这段代码的语法错误：\n def add(a,b): return a + b \n print(add(1))"))

3. settings.json 配置

如果你使用的是 Claude 代码工具或集成在 IDE 中的插件，claude/settings.json 是核心配置文件，用于持久化存储模型参数和 API 密钥。

找到存放路径

不同场景下的默认路径如下：

若找不到，可在工具的「设置」界面查找配置文件路径，或直接新建该文件。

配置规范

JSON 格式要求键名必须用双引号，值为字符串或数字，末尾无多余逗号。

基础配置结构示例：

{
  "env": {
    "ANTHROPIC_API_KEY": "sk-ant-api03-xxxxxxxxxxxx-xxxxxxxxxxxx",
    "ANTHROPIC_MODEL": "claude-3-5-sonnet-20240620",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-3-5-opus-20240620",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-3-5-sonnet-20240620",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-3-haiku-20240307",
    "CLAUDE_CODE_SUBAGENT_MODEL": "claude-3-haiku-20240307"
  },
  "code_inference": {
    "temperature": 0.1,
    "max_tokens": 2048
  }
}

如果使用了代理，则需调整字段：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-e5575d689a844514bc4fd03a2700eff6",
    "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
    "ANTHROPIC_MODEL": "claude-3-5-sonnet-20240620"
  }
}

避坑要点：

1. 大小写敏感：ANTHROPIC_MODEL 等参数名必须大写，这是官方工具的解析逻辑。
2. 节点层级：所有环境相关配置（密钥、模型）需放在 env 根节点下，否则工具无法读取。
3. 敏感信息保护：不要将 settings.json 提交到代码仓库，在 .gitignore 中添加：

   # 忽略 Claude 配置文件
   claude/settings.json
   .claude/settings.json
   

配置生效与验证

修改 settings.json 后，通常需要重启 Claude 代码工具或 IDE 插件才能生效。部分工具支持手动刷新配置。验证方法包括查看日志（通常在 ~/.claude/logs/），确认日志中显示的 model 字段与配置一致。

三、默认模型说明

当你不在配置文件中指定 MODEL 相关参数时，默认值由你使用的工具版本决定。Anthropic 官方通常会将「通用性、性价比最优」的模型设为默认。

1. 常用工具默认值

对于大多数开发者使用的 VS Code 插件 和 Claude Code 桌面端，核心默认值如下：

如果是纯 Anthropic SDK 调用（无配置文件），SDK 原生不存默认值，必须显式指定 model 参数，否则会报错。

2. 优先级规则

如果只配置了部分 MODEL 参数，工具会按「自定义配置 > 官方默认」的逻辑生效：

1. 若配置了 ANTHROPIC_MODEL（全局），但未配置 CLAUDE_CODE_SUBAGENT_MODEL → 子代理仍用默认的 Haiku。
2. 若未配置任何 MODEL 参数 → 所有参数均使用上表的官方默认值。
3. 若配置了 ANTHROPIC_DEFAULT_SONNET_MODEL，但未配置 ANTHROPIC_MODEL → 全局默认仍为官方的 Sonnet 3.5（不会自动复用你配置的 Sonnet 自定义值）。

3. 如何确认当前工具的默认值

最可靠的方式是查看工具设置页或日志。

• VS Code 插件：打开「设置」→ 搜索「Claude Model」，会显示「Default Model」的默认值。
• 命令行验证：执行任意代码任务后，查看工具日志，通常会显示类似 [INFO] Using default model: claude-3-5-sonnet-20240620 的信息。

四、配置注意事项

1. 模型 ID 时效性：模型 ID 需使用 Anthropic 官方最新版本，旧 ID 可能被停用。建议参考 Anthropic 官方文档。
2. API Key 安全：绝对不要硬编码到代码中，务必通过环境变量配置，避免泄露。
3. 温度（Temperature）建议：代码任务建议设 0.0~0.2（保证结果稳定），创意类代码可设 0.5~0.7。
4. 清理无关内容：确保配置文件中不包含任何平台引流、作者推广或与主题无关的社区运营话术。