2.2 AI 模型配置

安装完成后，必须完成模型源配置才能使用补全与对话功能。根据团队使用的版本不同，分为「官方云服务」和「私有化/本地部署」两种模式。

1. 打开配置入口

Visual Studio Code

• 点击底部状态栏左侧的 OpenCode 图标（或按 Ctrl+Shift+P / Cmd+Shift+P，输入 OpenCode: Configure）。
• 也可以进入 文件 → 首选项 → 设置，搜索 OpenCode 找到相关配置项。

JetBrains 系列

• 进入 File → Settings（macOS 为 Preferences）→ Tools → OpenCode。
• 或点击 IDE 右下角状态栏的 OpenCode 图标，选择「配置」。

2. 官方云服务模式（推荐个人及中小团队）

若团队未搭建私有模型，直接使用官方服务即可：

1. 在配置面板中选择「云端服务」。
2. 点击「登录」，IDE 会自动唤起系统默认浏览器，跳转至授权页面。
3. 使用企业微信、飞书、GitHub 或邮箱完成登录（具体选项以管理员开启的登录方式为准）。
4. 授权成功后返回 IDE，状态栏图标变为蓝色（或显示已登录用户名），即表示配置完成。

注意：若浏览器授权后 IDE 未自动跳转，可在浏览器页面手动复制 Token，粘贴回 IDE 的「手动输入 Token」框中完成绑定。

3. 私有化/本地模型模式（推荐大型企业与涉密环境）

若代码不能外传，需连接团队内部部署的模型：

1. 在配置面板中切换为「私有化部署」或「自定义模型」。
2. 填写以下信息：

• API Endpoint：管理员提供的接口地址，格式通常为 http://<服务器IP>:<端口>/v1/chat/completions（或团队自定义路径）。
• API Key / Token：访问私有模型所需的鉴权密钥。
• 模型名称（如可选项中有）：根据实际部署选择，例如 deepseek-coder-33b、qwen-coder 等；若不确定可留空或咨询管理员。

1. 点击「连接测试」，若返回「连接成功」则保存配置。

提示：私有化环境下若需通过 HTTP 代理访问模型服务器，可在同一配置页的「网络代理」栏填入代理地址（如 http://proxy.company.com:8080）。

4. 切换模型或工作区

• 部分版本支持在配置面板中切换「代码补全模型」与「对话模型」。若团队同时部署了轻量级补全模型和大型对话模型，可按需分别指定。
• 如账号同时归属多个团队/企业，登录后可在「工作区」下拉菜单中选择当前项目对应的组织，确保计费与权限正确。

5. 验证配置

保存配置后，新建一个代码文件输入简单注释，例如：

# 计算两个日期的天数差

稍等片刻，若出现灰色补全提示，即说明模型连接正常。若长时间无响应，请检查网络、API 地址及 Token 是否正确。

常见问题

• 状态栏显示红色感叹号：通常是 Token 过期或网络不通，点击图标重新登录或检查 Endpoint 可达性。
• 私有化环境提示 403/401：API Key 错误或权限不足，请联系管理员重新分配密钥。
• 补全延迟较高：云端用户可检查本地网络；私有化用户可确认服务器 GPU 负载，或尝试在设置中调大「请求超时时间」。