Claude Code 模型配置详解

了 Claude Code 的模型配置参数，包括环境变量、Settings.json 及 Python SDK 三种配置方式。介绍了核心参数如 ANTHROPIC_MODEL 的含义与适用场景，以及不同工具（VS Code 插件、桌面端）的默认模型选择。提供了配置验证方法与注意事项，帮助开发者优化代码开发中的 AI 模型调用效率。

LinuxPan发布于 2026/4/5更新于 2026/4/131 浏览

Claude Code 模型配置详解

核心参数含义与作用

这些参数本质是 Anthropic Claude 模型在代码开发场景下的预设标识符，用于简化不同 Claude 模型版本的调用配置（避免硬编码模型 ID）。每个参数对应不同定位的 Claude 模型，具体如下：

参数名	核心作用	适用场景	对应官方模型 ID 示例
`ANTHROPIC_MODEL`	通用/顶层模型参数，可覆盖其他默认模型参数，是所有 Claude 调用的'全局开关'

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

# 配置 API Key（必须，从 Anthropic 控制台获取）
export ANTHROPIC_API_KEY="your-api-key-here"
# 通用模型参数（全局默认 Sonnet）
export ANTHROPIC_MODEL="claude-3-5-sonnet-20240620"
# 各系列模型默认值
export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-3-5-opus-20240620"
export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-3-5-sonnet-20240620"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-3-haiku-20240307"
# 代码子代理模型（轻量任务用 Haiku）
export CLAUDE_CODE_SUBAGENT_MODEL="claude-3-haiku-20240307"

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))"))

{
  "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",
    "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"
  }
}

大小写规范：ANTHROPIC_MODEL/CLAUDE_CODE_SUBAGENT_MODEL 这类参数名必须大写（官方工具的解析逻辑是匹配大写标识符）。
节点层级：所有环境相关配置（密钥、模型）需放在 env 根节点下，否则工具无法读取。
敏感信息保护：不要将 settings.json 提交到代码仓库，在 .gitignore 中添加：
```
# 忽略 Claude 配置文件
claude/settings.json
.claude/settings.json
```

JSON 配置项	取值说明	作用
`ANTHROPIC_MODEL`	任意 Claude 官方模型 ID	全局默认模型（工具/插件优先使用该值）
`ANTHROPIC_DEFAULT_OPUS_MODEL`	Opus 系列模型 ID	复杂代码任务（重构/算法设计）的专用模型标识
`ANTHROPIC_DEFAULT_SONNET_MODEL`	Sonnet 系列模型 ID	常规代码任务（接口开发/Bug 修复）的默认模型
`ANTHROPIC_DEFAULT_HAIKU_MODEL`	Haiku 系列模型 ID	轻量代码任务（语法检查/单行生成）的快速模型
`CLAUDE_CODE_SUBAGENT_MODEL`	通常设为 Haiku/Sonnet ID	代码子代理（单元测试生成/风格检查）的专用模型

参数名	未配置时的默认值	适用说明
`ANTHROPIC_MODEL`（全局模型）	`claude-3-5-sonnet-20240620`	核心默认：Claude 3.5 Sonnet（平衡性能/速度/成本，代码任务首选）
`ANTHROPIC_DEFAULT_OPUS_MODEL`	`claude-3-5-opus-20240620`	旗舰版默认：最新 Opus 3.5（仅手动指定 Opus 时生效）
`ANTHROPIC_DEFAULT_SONNET_MODEL`	`claude-3-5-sonnet-20240620`	平衡版默认：与全局默认一致
`ANTHROPIC_DEFAULT_HAIKU_MODEL`	`claude-3-haiku-20240307`	轻量版默认：最新 Haiku（速度最快、成本最低）
`CLAUDE_CODE_SUBAGENT_MODEL`	复用 `ANTHROPIC_DEFAULT_HAIKU_MODEL`	子代理默认用 Haiku，适配轻量任务

from anthropic import Anthropic
client = Anthropic(api_key="your-key")
# 必须显式指定 model，否则报错
response = client.messages.create(
    model="claude-3-5-sonnet-20240620",  # 无默认值，必填
    max_tokens=1024,
    messages=[{"role": "user", "content": "写一个 Python 函数"}]
)

Claude Code 模型配置详解

Claude Code 模型配置详解

核心参数含义与作用

配置方法（实战示例）

场景 1：环境变量配置（生产环境推荐）

场景 2：代码中直接配置（Python SDK 示例）

场景 3：claude/settings.json 配置

1. 基础配置结构

2. 字段规范与避坑要点

3. 核心参数详解

4. 配置生效与验证

默认模型说明

常用工具默认值参考

纯 Anthropic SDK 调用

配置注意事项

更多推荐文章

相关免费在线工具

Claude Code 模型配置详解

Claude Code 模型配置详解

核心参数含义与作用

配置方法（实战示例）

场景 1：环境变量配置（生产环境推荐）

场景 2：代码中直接配置（Python SDK 示例）

场景 3：claude/settings.json 配置

1. 基础配置结构

2. 字段规范与避坑要点

3. 核心参数详解

4. 配置生效与验证

默认模型说明

常用工具默认值参考

纯 Anthropic SDK 调用

配置注意事项

微信扫一扫，关注极客日志

更多推荐文章

相关免费在线工具