Claude Code 的模型配置与默认值说明

场景 2：在代码中读取配置

先装依赖：

pip install anthropic

Python 示例：

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__":
    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：claude/settings.json 配置

如果你用的是 Claude Code、集成 Claude 的 IDE 插件，或者桌面端，claude/settings.json 往往就是那层真正生效的持久化配置。它的用处很朴素：把模型 ID、密钥和一些默认参数固定下来，工具启动后直接读取。

先确认文件位置。不同工具放得不太一样，常见路径如下：

如果找不到，先去工具设置里看配置文件路径。很多时候比手动翻目录快。

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","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 下。真要混着写，后面排查起来很麻烦。

敏感信息别提交到仓库，.gitignore 里至少要加上：

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

下面这张表把几个常见字段再捋一遍：

配置生效和验证

改完 settings.json 之后，先重启工具或插件。大多数情况下，没重启就是没读新配置。部分工具会提供'刷新配置'，可以替代重启，但别指望每次都能自动热更新。

要确认是否生效，最直接的方法还是看日志。执行一条简单任务，日志里通常能看到实际使用的模型名，比如 model: claude-3-5-sonnet-20240620。如果日志目录里还是旧值，那说明配置还没被加载。

默认模型

不配置这些参数时，默认值由工具版本决定。这个地方最容易踩坑，因为不同工具的默认策略大致一致，但细节会跟着版本走。

常见工具的默认值

Claude 官方 VS Code 插件

这是最常见的场景。默认值通常是 Anthropic 推荐的平衡模型，下面这组是常见配置：

Claude Code 桌面端

默认逻辑和 VS Code 插件基本一致。一般也是先给 Sonnet，只有在快速模式或低功耗模式下才会切到 Haiku。这个行为对代码体验影响挺明显，速度和质量会有取舍。

纯 Anthropic SDK 调用

如果你直接用 SDK，而不是通过工具封装，那这些 ANTHROPIC_* 参数不会自动帮你兜底。model 仍然是必填项，不写就会报错。

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函数"}]
)

默认值的优先级

实际生效顺序很简单：你自己配的值优先，工具内置默认值兜底。

• 配了 ANTHROPIC_MODEL，但没配 CLAUDE_CODE_SUBAGENT_MODEL，子代理还是会用默认的 Haiku。
• 一个都没配，工具就走官方默认值。
• 只配了 ANTHROPIC_DEFAULT_SONNET_MODEL，但没配 ANTHROPIC_MODEL，全局默认不会自动跳到你自定义的 Sonnet 值，还是按工具自己的默认来。

怎么确认当前默认值

最稳妥的办法还是看工具设置页或者日志。设置页能直接看到默认选项，日志能看到实际请求时用了哪个模型。两边对不上时，通常是配置没刷新，或者路径指错了。

[INFO] Using default model: claude-3-5-sonnet-20240620

关于 2026 年默认模型的说法

原文里有一段把 2026 年的默认模型写得很具体，还带了 claude-4-* 的命名。这个问题我建议保留成'以工具当前版本为准'，不要把版本号说死。模型命名和默认策略会跟着官方工具更新，硬写成固定结论，过一阵子就容易过期。

真正可操作的做法就两条：看工具当前的配置输出，或者直接在设置页确认默认项。需要手动改的时候，再用命令把全局默认和 Opus 默认切过去。

# 1. 设置全局默认为Claude 4 Sonnet
anthropic config set model claude-4-sonnet-20260201
# 2. 设置Opus默认为4.6
anthropic config set opus_model claude-4-opus-20260201
# 3. 验证更新结果
anthropic config get model

如果你的工具还停在 3.5 系列，先升级客户端，再看默认值。很多'默认模型没变'的问题，其实只是工具没更新。

最后怎么选

如果只是日常代码任务，我会先用 Sonnet 做全局默认；子代理用 Haiku，省时间，也够用。只有在重构范围大、上下文复杂、或者需要更稳的推理时，再把 Opus 拉出来。一直默认上旗舰模型，通常不是更稳，只是更贵。