Claude Code 模型配置完全指南（二）：模型选择与高级配置

本文是 Claude Code 模型配置系列教程的第二篇，带你深入了解模型选择与高级配置技巧。

了解 Claude 模型家族

Anthropic 提供了多个 Claude 模型，每个模型有不同的特点和适用场景。

📊 模型对比表

选择适合你的模型

🎯 推荐配置

日常开发（推荐）

{
  "model": "claude-sonnet-4-20250514",
  "reason": "性价比最高，响应快，代码质量优秀"
}

复杂项目

{
  "model": "claude-opus-4-20250514",
  "reason": "最强推理能力，适合架构设计、复杂调试"
}

快速查询

{
  "model": "claude-haiku-4-20250514",
  "reason": "速度最快，成本最低，适合简单问答"
}

高级配置选项

1. 配置文件位置

# Linux/macOS
~/.claude/config.json

# Windows
%USERPROFILE%\.claude\config.json

2. 完整配置示例

{
  "apiKey": "sk-ant-api03-xxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "model": "claude-sonnet-4-20250514",
  "temperature": 0.7,
  "maxTokens": 8192,
  "timeout": 60000,
  "retryAttempts": 3,
  "streaming": true,
  "contextWindow": 200000,
  "systemPrompt": "你是一个专业的编程助手，擅长代码编写和调试。",
  "allowedTools": ["file_read", "file_write", "shell_exec", "web_search"],
  "blockedTools": ["sudo_exec"],
  "workspace": {
    "defaultPath": "~/projects",
    "allowedPaths": ["~/projects", "~/documents/code"],
    "blockedPaths": ["~/.ssh", "/etc"]
  }
}

3. 配置项详解

temperature（温度）

• 范围：0.0 – 1.0
• 默认：0.7
• 说明：控制输出的随机性
  • 0.0-0.3：确定性高，适合代码生成
  • 0.5-0.7：平衡创造性和准确性
  • 0.8-1.0：更具创造性，适合头脑风暴

maxTokens（最大令牌数）

• 范围：1 – 模型上限
• 默认：8192
• 说明：单次响应的最大长度
  • 代码片段：2048-4092
  • 完整文件：8192
  • 长文档分析：16384+

timeout（超时时间）

• 单位：毫秒
• 默认：60000（60 秒）
• 建议：复杂任务可设为 120000-300000

streaming（流式输出）

• true：实时显示生成过程（推荐）
• false：等待完整响应后显示

环境变量配置

完整环境变量列表

# 必需
export ANTHROPIC_API_KEY="sk-ant-api03-xxxxx"

# 可选配置
export ANTHROPIC_MODEL="claude-sonnet-4-20250514"
export ANTHROPIC_TEMPERATURE="0.7"
export ANTHROPIC_MAX_TOKENS="8192"
export ANTHROPIC_TIMEOUT="60000"
export ANTHROPIC_BASE_URL="https://api.anthropic.com"

# 代理配置（如需要）
export HTTP_PROXY="http://proxy.example.com:8080"
export HTTPS_PROXY="http://proxy.example.com:8080"

永久生效（Linux/macOS）

# 编辑 shell 配置文件
nano ~/.bashrc  # 或 ~/.zshrc

# 添加配置
export ANTHROPIC_API_KEY="你的密钥"
export ANTHROPIC_MODEL="claude-sonnet-4-20250514"

# 保存后生效
source ~/.bashrc

Windows 永久配置

# PowerShell - 用户级别
[System.Environment]::SetEnvironmentVariable(
  "ANTHROPIC_API_KEY", 
  "你的密钥", 
  "User"
)

# 使配置生效
$env:ANTHROPIC_API_KEY = "你的密钥"

安全最佳实践

🔐 密钥安全

1. 永远不要将密钥提交到 Git

   # 添加到 .gitignore
   echo ".claude/config.json" >> .gitignore
   echo "*.env" >> .gitignore

2. 使用密钥管理工具

   # 使用 pass（Linux）
   pass insert anthropic/api_key
   
   # 使用 1Password CLI
   op item create --title="Anthropic API" --category=API_Credential

3. 定期轮换密钥
   • 每 3-6 个月更新一次
   • 怀疑泄露时立即撤销

🛡️ 权限控制

{
  "allowedTools": [
    "file_read",
    "file_write"
  ],
  "blockedTools": [
    "shell_exec",
    "sudo_exec",
    "network_request"
  ]
}

常见问题 FAQ

Q1: 如何切换模型？

# 临时切换
ANTHROPIC_MODEL=claude-opus-4-20250514 claude "任务描述"

# 永久切换
claude config --model claude-opus-4-20250514

Q2: 超出配额怎么办？

• 检查控制台使用情况
• 升级到更高配额计划
• 使用 Haiku 模型降低成本
• 优化提示词减少 token 消耗

Q3: 响应太慢如何优化？

• 降低 maxTokens
• 使用 Haiku 模型
• 检查网络连接
• 增加 timeout 值

下一篇

下一篇：Claude Code 模型配置完全指南（三）：实战操作与技巧

在第三篇中，我们将讲解：

• 💻 常用命令与操作技巧
• 📁 文件管理与项目操作
• 🔍 调试与错误排查

本文由 AI 助手自动生成并发布 | 最后更新：2026-03-29