#OpenCode 接入 汇飞智能 官方教程

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

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

#一、接入前准备

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

#二、安装 OpenCode

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

NPM 全局安装（推荐）：

npm install -g opencode-ai

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

#三、配置汇飞智能核心文件

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

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

• Windows 路径：C:\Users\你的用户名\.config\opencode\opencode.json
• macOS / Linux 路径：~/.config/opencode/opencode.json

将以下内容粘贴进去。注意：汇飞智能是第三方中转，不在 OpenCode 内置的 provider 列表里，因此需要自定义一个 provider，并用 npm 字段指定 @ai-sdk/openai-compatible（走 /v1/chat/completions）；不要使用内置的 openai（它走 /v1/responses，会连不上）：

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "sapis": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "汇飞智能",
      "options": {
        "baseURL": "https://api.sapis.cn/v1"
      },
      "models": {
        "Qwen3.7-Plus": {
          "name": "通义千问 Qwen3.7-Plus"
        }
      }
    }
  }
}

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

• Windows 路径：C:\Users\你的用户名\.local\share\opencode\auth.json
• macOS / Linux 路径：~/.local/share/opencode/auth.json

将以下内容粘贴进去，并替换为你自己的 API Key（键名 sapis 必须与上面 provider 的名字一致）：

{
  "sapis": {
    "type": "api",
    "key": "sk-你的汇飞智能令牌"
  }
}

#四、启动与使用

#1. 快速启动

在终端输入以下命令直接指定模型进入对话（--model 需要 provider/model 格式）：

opencode --model sapis/Qwen3.7-Plus

不确定准确 ID 时，可先运行 opencode models 查看（输出格式即 provider/model）。

#2. 常用操作指令

• /models：在交互界面中手动切换已注册的模型。
• /clear：清空当前对话上下文，解决卡顿或报错。
• Ctrl + C：终止当前生成任务。

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

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

• 上下文干扰：OpenCode 会读取你当前打开的所有文件。请务必关闭编辑器中打开的图片、PDF 等非文本文件。
• 清理缓存：在对话框输入 /clear 重置会话。

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

• 在该自定义 provider（sapis）的 models 字段中添加汇飞支持的纯模型名即可（如 deepseek-v4.1-flash、Kimi-K3），名称必须与控制台一字不差。

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

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