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. 初始化客户端
client = Anthropic(api_key=os.getenv("ANTHROPIC_API_KEY"))

# 3. 不同场景的调用示例
# 常规代码任务（用通用模型）
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

# 复杂代码任务（专用 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

# 测试调用
if __name__ == "__main__":
    print(regular_code_task("写一个 FastAPI 的用户登录接口，包含手机号 + 密码校验"))

3. settings.json 配置文件

对于 Claude 桌面端或 IDE 插件，claude/settings.json 是核心配置文件，用于持久化存储密钥和模型参数。

文件路径

• 桌面版：~/.claude/settings.json (macOS/Linux) 或 C:\Users\用户名\.claude\settings.json (Windows)
• VS Code 插件：通常在扩展目录内，具体可在插件设置中查看

配置规范

JSON 格式要求键名双引号，无多余逗号。敏感信息如 API Key 不要提交到代码仓库，记得在 .gitignore 中添加：

.claude/settings.json
claude/settings.json

基础结构示例

{
  "env": {
    "ANTHROPIC_API_KEY": "sk-ant-api03-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
  }
}

注意：如果使用了代理，需将 ANTHROPIC_AUTH_TOKEN 和 ANTHROPIC_BASE_URL 放入 env 节点下。字段名大小写需严格匹配，工具通常解析大写标识符。

默认模型与验证

当未在配置文件中指定 MODEL 相关参数时，工具会使用内置默认值。目前主流版本（如 VS Code 插件、CLI）的默认策略如下：

如何确认当前默认值

1. 查看日志：执行代码任务后，查看工具日志（如 ~/.claude/logs/），通常会显示 model: claude-3-5-sonnet-20240620。
2. 命令行查询：使用 CLI 工具查看配置。

   anthropic config get model
   anthropic config list
   

3. 设置页检查：在 VS Code 插件或桌面端的设置界面搜索 "Model"，查看默认选中项。

注意事项

1. 模型版本：建议使用 Anthropic 官方最新稳定版 ID，旧 ID 可能停用。
2. 安全性：API Key 务必通过环境变量传递，严禁硬编码在代码中。
3. 温度设置：代码任务建议设为 0.0~0.2 以保证结果稳定；创意类代码可适当调高至 0.5~0.7。
4. 优先级规则：若只配置了部分参数，未配置项仍会沿用官方默认值。例如配置了 ANTHROPIC_MODEL 但未配子代理模型，子代理仍会用默认的 Haiku。