10-多模型配置指南

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

---

一、模型选择策略

1.1 各模型特点对比

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

1.2 使用策略建议

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

---

二、OpenCode 内置模型

2.1 查看可用模型

# 列出所有可用模型
opencode models

# 列出指定 provider 的模型
opencode models anthropic

2.2 切换模型

方式1：命令行参数

opencode --model anthropic/claude-opus-4-20250514
# 或简写
opencode -m anthropic/claude-opus-4-20250514

方式2：退出后重新启动

# 退出当前会话
> /exit

# 使用指定模型重新启动
$ opencode --model anthropic/claude-opus-4-20250514

---

三、配置自定义 Provider

通过 opencode providers 命令管理 AI 提供商和凭据。

步骤1：配置 Provider

# 查看当前配置的 providers
opencode providers

# 添加自定义 provider（如 Z.AI 代理）
# 编辑 ~/.opencode/config.json 添加 provider 配置

步骤2：使用自定义 Provider 的模型

# 使用自定义 provider 的模型
opencode --model myprovider/claude-sonnet-4-20250514

# 查看该 provider 可用的模型
opencode models myprovider

---

四、使用 OpenRouter

OpenRouter 提供统一接口访问多个模型。通过 opencode providers 配置 OpenRouter 凭据后，可以使用其模型。

使用 OpenRouter 模型：

# 使用 OpenRouter 的模型
opencode --model openrouter/anthropic/claude-opus-4
opencode --model openrouter/anthropic/claude-sonnet-4
opencode --model openrouter/openai/gpt-4o

# 查看 OpenRouter 可用模型
opencode models openrouter

常见 OpenRouter 模型 ID 格式：

openrouter/anthropic/claude-opus-4
openrouter/anthropic/claude-sonnet-4
openrouter/openai/gpt-4o

---

五、自定义 Shell 别名

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

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

使用：

opencode-opus /path/to/project

---

六、模型选择建议

根据不同任务场景手动选择合适的模型：

# 简单任务使用轻量模型
opencode --model anthropic/claude-haiku-4-20250514

# 日常开发使用平衡模型
opencode --model anthropic/claude-sonnet-4-20250514

# 复杂架构分析使用最强模型
opencode --model anthropic/claude-opus-4-20250514

在对话中也可以根据任务复杂度，退出后用不同模型重新启动继续工作。

---

七、成本优化策略

7.1 分层使用模型

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

7.2 模型配置策略

# 日常开发使用默认模型（Sonnet）
cd project
opencode

# 对于复杂任务，退出后用指定模型重新启动
> /exit
$ opencode --model claude-opus-4
> 分析这个项目架构

# 完成后切换回默认模型
> /exit
$ opencode --model claude-sonnet-4

7.3 成本控制建议

模型选择策略：

任务类型	推荐模型	预估成本
简单问答、文档查找	Haiku	低
代码生成、重构	Sonnet	中
复杂架构分析	Opus	高

节省成本技巧：

# 1. 压缩历史减少 Token 消耗
> /compact

# 2. 明确任务范围，避免无效迭代
> 仅修改 app/models/ 目录，不要修改其他文件

---

八、常见问题

Q1: 配置后不生效

检查：

# 检查 provider 配置
opencode providers

# 查看可用模型
opencode models

# 检查配置文件
cat ~/.opencode/config.json

Q2: 访问海外模型缓慢

解决：

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

Q3: 费用过高

优化：

1. 日常用 Sonnet，复杂任务再用 Opus
2. 缩短对话历史

> /compact

3. 减少不必要的 AI 调用

Q4: 模型响应质量差

调整：

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

---

九、Provider 管理

9.1 查看和管理 Provider

# 查看所有已配置的 provider
opencode providers

# 添加或更新 provider 凭据
# 编辑 ~/.opencode/config.json

9.2 查看可用模型

# 查看所有 provider 的模型
opencode models

# 查看特定 provider 的模型
opencode models anthropic
opencode models openrouter

9.3 使用模型

# 使用默认 provider 的模型
opencode --model anthropic/claude-sonnet-4-20250514

# 使用简写 -m
opencode -m anthropic/claude-opus-4-20250514

9.4 配置文件位置

配置文件位于 ~/.opencode/config.json，通过 opencode providers 命令管理 provider 凭据。

---

十、下一步

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

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

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

---