OpenCode 接入 DataEyesAI 教程

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

本文将引导你将 OpenCode 的底层模型替换为 DataEyesAI 的聚合接口，从而获得更稳定、高性价比的编程辅助体验（同时支持 GPT 和 Claude 系列模型）。

一、接入前准备（核心 3 要素）

请先登录 DataEyesAI 控制台获取你的专属调用信息：

配置项	推荐填写内容	注意事项
API Key	`sk-xxxxxxxxxxxxxxxx`	请直接填写你在 DataEyesAI 控制台生成的 Key
Base URL	`https://cloud.dataeyes.ai/v1`	必须包含 `/v1` 后缀
模型名称	例如 `gpt-5` 或 `claude-opus-4-6`	填写 DataEyesAI 实际支持且你账号有权限调用的模型

二、安装 OpenCode

请确保你的电脑已安装 Node.js (18 或更高版本)。
如果环境没有 Node.js ，点击此处跳转下载

打开终端（Windows 推荐使用 PowerShell，macOS/Linux 使用终端），运行以下命令：

NPM 全局安装（Windows 推荐）：

官方一键安装脚本（macOS / Linux 推荐）：

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

三、配置 DataEyesAI 并启动

为了让你能同时无缝使用 GPT 和 Claude 模型，推荐直接修改 OpenCode 的本地配置文件。

第 1 步：配置网络节点 (Provider)

找到或创建配置文件：

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

macOS / Linux 路径：~/.config/opencode/opencode.json
(如果没有对应文件夹，请手动新建)

将以下 JSON 内容粘贴进去并保存（这会同时覆盖 OpenAI 和 Anthropic 的默认地址）：

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "openai": {
      "options": {
        "baseURL": "https://cloud.dataeyes.ai/v1"
      }
    },
    "anthropic": {
      "options": {
        "baseURL": "https://cloud.dataeyes.ai/v1"
      }
    }
  }
}

第 2 步：配置鉴权密钥 (Auth)

找到或创建密钥文件：

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

macOS / Linux 路径：~/.local/share/opencode/auth.json
(如果没有对应文件夹，同样请手动新建)

将以下 JSON 内容粘贴进去并保存（记得将 sk-... 替换为你实际的 DataEyesAI API Key）：

{
  "openai": {
    "type": "api",
    "key": "sk-你的DataEyes密钥"
  },
  "anthropic": {
    "type": "api",
    "key": "sk-你的DataEyes密钥"
  }
}

四、开始使用与模型切换

配置完成后，重新打开你的终端，即可开始使用。

唤出模型列表：在输入框中敲入 /models 并回车，在列表中选择你想要使用的模型（例如选了 Claude 模型，它就会自动走我们在上面配置的 Anthropic 渠道）。

开始对话：输入你的第一个指令，例如：
写一段 Python 的冒泡排序

如果模型能正常读取要求并流式输出代码，恭喜你，DataEyesAI 已成功接入！

五、常见问题排查 (FAQ)

Q1：为什么提示认证失败 / Invalid API Key？

检查 auth.json 中的 API Key 是否复制完整，确保没有多余的空格。

检查文件格式是否为标准的 JSON（标点符号必须是英文半角）。

Q2：为什么提示连接超时或 Fetch Failed？

请务必检查 opencode.json 中的 baseURL 是否正确包含了 /v1 后缀（即 https://cloud.dataeyes.ai/v1）。

Q3：为什么提示模型不存在 (Model not found)？

你可以在对话框中输入 /models 查看工具当前支持的模型列表。只要是你选中的模型，并且 DataEyesAI 后台支持该模型映射，即可正常调用。

OpenCode

OpenCode 接入 DataEyesAI 教程#

一、接入前准备（核心 3 要素）#

二、安装 OpenCode#

三、配置 DataEyesAI 并启动#

第 1 步：配置网络节点 (Provider)#

第 2 步：配置鉴权密钥 (Auth)#

四、开始使用与模型切换#

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