跳到主要内容

OpenCode

OpenCode 接入 菜ai 教程

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

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

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

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

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

二、安装 OpenCode​

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

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

NPM 全局安装（Windows 推荐）：

npm install -g opencode-ai

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

curl -fsSL https://opencode.ai/install | bash

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

三、配置 菜ai 并启动​

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

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

  1. 找到或创建配置文件：

    • Windows 路径：C:\Users\你的用户名\.config\opencode\opencode.json
    • macOS / Linux 路径：~/.config/opencode/opencode.json (如果没有对应文件夹，请手动新建)

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

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

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

  1. 找到或创建密钥文件：

    • Windows 路径：C:\Users\你的用户名\.local\share\opencode\auth.json
    • macOS / Linux 路径：~/.local/share/opencode/auth.json (如果没有对应文件夹，同样请手动新建)

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

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

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

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

  1. 唤出模型列表：在输入框中敲入 /models 并回车，在列表中选择你想要使用的模型（例如选了 Claude 模型，它就会自动走我们在上面配置的 Anthropic 渠道）。
  2. 开始对话：输入你的第一个指令，例如： 写一段 Python 的冒泡排序

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

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

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

  • 检查 auth.json 中的 API Key 是否复制完整，确保没有多余的空格。
  • 检查文件格式是否为标准的 JSON（标点符号必须是英文半角）。

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

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

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

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