难度：入门约 8 分钟
准备条件
先确认 CLI 和账户要求。
- OpenCode 1.18.3 或更高版本
- Moonshot 平台 API Key
- 已从终端打开的代码仓库
- 允许 Agent 修改前，Git 工作区应干净或状态明确
配置 OpenCode
先完成鉴权，再分别选择模型和推理变体。
- 1
启动 Provider 鉴权
在 OpenCode 的终端流程中运行登录命令。
终端opencode auth login - 2
选择 Moonshot AI（中国）
选择 Moonshot 官方 OpenCode 指南指定的 Provider，并在提示时粘贴 API Key。
- 3
选择 Kimi K3
打开模型选择器，在已经鉴权的 Moonshot Provider 下选择 Kimi K3。
OpenCode 命令/models - 4
选择 max 变体
打开变体选择器并选择 max，与 Kimi K3 当前文档支持的推理强度保持一致。
OpenCode 命令/variants
修改代码前先验证
检查当前会话，不要只确认凭证已经保存。
- 状态栏显示 Kimi K3
- Provider 显示 Moonshot AI（中国）
- 所选变体显示 max
- 允许修改前已经确认 Git 状态
故障排查
从源头修复 Provider、模型和变体不匹配。
| 现象 | 可能原因 | 直接修复 |
|---|---|---|
| /models 中找不到 Kimi K3 | Moonshot 未鉴权或 CLI 版本过旧 | 升级 OpenCode，重新执行 auth login，并选择 Moonshot AI（中国） |
| 会话没有使用 max | 选择模型后没有切换变体 | 运行 /variants 并选择 max |
官方参考
Provider 行为可能随 CLI 版本变化，请根据这些实时文档核对。
OpenCode 常见问题
第一次编程会话前需要知道的事项。