10-多模型配置指南

配置 Claude Code 使用多个大模型，包括海外模型如 Claude Opus。

---

一、模型选择策略

1.1 各模型特点对比

模型	适用场景	特点	推荐用途
Claude Opus	复杂架构设计、深度分析	最强推理能力，成本高	架构设计、复杂重构
Claude Sonnet	日常开发、代码生成	平衡性能与成本	主力开发模型
Claude Haiku	快速响应、简单任务	最快，成本低	代码补全、快速问答

1.2 使用策略建议

复杂架构设计 → Claude Opus
日常开发编程 → Claude Sonnet
代码审查分析 → Claude Opus
快速代码补全 → Claude Haiku

---

二、Claude Code 内置模型

2.1 查看可用模型

> /status

输出：
Model: claude-sonnet-4-20250514 (default)
Available models:
- claude-opus-4-20250514
- claude-sonnet-4-20250514  
- claude-haiku-4-20250514

2.2 切换模型

方式1：环境变量

export ANTHROPIC_DEFAULT_MODEL=claude-opus-4-20250514
claude

方式2：配置文件

// ~/.claude/settings.json
{
  "env": {
    "ANTHROPIC_DEFAULT_MODEL": "claude-opus-4-20250514"
  }
}

---

三、配置 Z.AI 访问

Z.AI 提供国内访问海外模型的合规渠道。

步骤1：配置 API 信息

// ~/.claude/settings.json
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "your-zai-api-key",
    "ANTHROPIC_BASE_URL": "https://api.z.ai/api/anthropic",
    "ANTHROPIC_DEFAULT_MODEL": "claude-opus-4-20250514",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-20250514",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-20250514"
  }
}

步骤2：启动 Claude Code

claude

# 验证模型
> /status
# 应显示当前使用的是 z.ai 的模型

---

四、使用 OpenRouter

// ~/.claude/settings.json
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-or-v1-your-openrouter-key",
    "ANTHROPIC_BASE_URL": "https://openrouter.ai/api/anthropic",
    "ANTHROPIC_DEFAULT_MODEL": "claude-opus-4"
  }
}

---

五、自定义模型别名

为常用模型创建别名，快速切换：

# 在 shell 配置文件中添加 (~/.bashrc 或 ~/.zshrc)
alias claude-opus='ANTHROPIC_DEFAULT_MODEL=claude-opus-4-20250514 claude'
alias claude-sonnet='ANTHROPIC_DEFAULT_MODEL=claude-sonnet-4-20250514 claude'
alias claude-haiku='ANTHROPIC_DEFAULT_MODEL=claude-haiku-4-20250514 claude'

使用：

claude-opus /path/to/project

---

六、成本优化策略

6.1 分层使用模型

简单任务 → Haiku（最便宜）
日常开发 → Sonnet（平衡）
复杂任务 → Opus（最强但贵）

6.2 动态切换模型

# 日常开发使用 Sonnet
cd project
claude

# 遇到复杂任务，临时切换到 Opus
> 使用 Opus 模型分析这个项目架构

# Claude 会自动切换到更强的模型

---

七、常见问题

Q1: 配置后不生效

检查：

# 检查环境变量
echo $ANTHROPIC_AUTH_TOKEN
echo $ANTHROPIC_BASE_URL

# 在 Claude Code 中
> /status  # 查看当前配置

Q2: 访问海外模型缓慢

解决：

1. 使用 Z.AI 等国内代理
2. 检查网络连接
3. 使用较轻量的模型（Haiku）

Q3: 费用过高

优化：

1. 日常用 Sonnet，复杂任务再用 Opus
2. 缩短对话历史 (/compact)
3. 减少不必要的 AI 调用

Q4: 模型响应质量差

调整：

1. 尝试切换模型版本
2. 优化提示词（Prompt）
3. 使用 Skills 规范输出

---

八、推荐配置方案

方案1：国内开发者（推荐）

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "your-zai-key",
    "ANTHROPIC_BASE_URL": "https://api.z.ai/api/anthropic",
    "ANTHROPIC_DEFAULT_MODEL": "claude-sonnet-4-20250514",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-20250514",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-20250514"
  }
}

方案2：海外 API 直连

{
  "env": {
    "ANTHROPIC_API_KEY": "sk-ant-api03-...",
    "ANTHROPIC_DEFAULT_MODEL": "claude-opus-4-20250514"
  }
}

---

九、下一步

配置好多模型后，你可以：

1. 根据任务复杂度选择合适的模型
2. 平衡开发效率与成本
3. 在需要时使用最强的 Opus 模型

接下来学习 11-项目规划测试代码审查实战。

---