OpenCode 接入数眼智能官方教程

OpenCode 是一款强大的终端 AI 编程工具，能够通过自然语言直接在终端中完成代码生成、项目分析和文件操作。

本文将引导你将 OpenCode 的底层接口替换为 数眼智能，推荐使用 Qwen (通义千问) 系列模型，以获得最稳定的极速编程辅助体验。

一、接入前准备

请先登录数眼智能控制台获取你的专属调用信息：

配置项	推荐填写内容	注意事项
API Key	`sk-xxxxxxxxxxxxxxxx`	请填写你在控制台生成的专属令牌
Base URL	`https://platform.shuyanai.com/v1`	必须包含 `/v1` 后缀
推荐模型	`qwen3.6-plus`	兼容性最强，支持超长上下文与复杂代码生成

二、安装 OpenCode

请确保你的电脑已安装 Node.js (18+)。在终端运行以下命令：

NPM 全局安装（推荐）：

安装完成后，运行 opencode --version，输出版本号即代表安装成功。

三、配置数眼智能核心文件

OpenCode 采用本地文件鉴权，请按以下步骤配置（建议使用 VS Code 打开对应路径进行编辑）。

第 1 步：配置请求节点 (opencode.json)

Windows 路径：C:\Users\你的用户名\.config\opencode\opencode.json

macOS / Linux 路径：~/.config/opencode/opencode.json

将以下内容粘贴进去。注意： 即使我们使用 Qwen 模型，provider 字段也必须写 openai（这代表使用 OpenAI 兼容协议）：

{
  "$schema": "[https://opencode.ai/config.json](https://opencode.ai/config.json)",
  "provider": {
    "openai": {
      "options": {
        "baseURL": "https://platform.shuyanai.com/v1"
      },
      "models": {
        "qwen3.6-plus": {
          "name": "通义千问 Qwen"
        }
      }
    }
  }
}

第 2 步：配置身份密钥 (auth.json)

Windows 路径：C:\Users\你的用户名\.local\share\opencode\auth.json

macOS / Linux 路径：~/.local/share/opencode/auth.json

将以下内容粘贴进去，并替换为你自己的 API Key：

{
  "openai": {
    "type": "api",
    "key": "sk-你的数眼智能令牌"
  }
}

四、启动与使用

1. 快速启动

在终端输入以下命令直接指定模型进入对话：

opencode --model qwen3.6-plus

2. 常用操作指令

/models：在交互界面中手动切换已注册的模型。

/clear：清空当前对话上下文，解决卡顿或报错。

Ctrl + C：终止当前生成任务。

五、常见问题与排查 (FAQ)

Q1：为什么一直显示 QUEUED 或没有响应？

上下文干扰：OpenCode 会读取你当前打开的所有文件。请务必关闭编辑器中打开的图片、PDF 等非文本文件。

清理缓存：在对话框输入 /clear 重置会话。

Q2：如何使用其他国产模型（如 DeepSeek, Kimi）？

只需在 opencode.json 的 models 字段中添加对应 ID 即可。但由于部分客户端对流式传输的解析差异，建议首选 Qwen 系列模型以获得最佳稳定性。

Q3：提示连接超时 (Fetch Failed)？

请检查你的网络环境。由于数眼智能提供国内加速节点，通常无需开启代理（VPN）即可直连，若开启了代理请尝试切换为“直连模式”。

OpenCode

OpenCode 接入 数眼智能 官方教程#

一、接入前准备#

二、安装 OpenCode#

三、配置数眼智能核心文件#

第 1 步：配置请求节点 (opencode.json)#

第 2 步：配置身份密钥 (auth.json)#

四、启动与使用#

1. 快速启动#

2. 常用操作指令#

五、常见问题与排查 (FAQ)#