OpenCode

OpenCode 是在终端里运行的开源 AI 编程工具，可以通过 CC Switch 导入或手动编辑配置文件接入 HiAPI，两种方式选一种即可。下面以 deepseek-v4.1-flash 为例，HiAPI 走 OpenAI Chat Completions 协议，本教程已在 Windows 11 的 OpenCode 1.19.4 上验证。开始前准备好 HiAPI API Key；用 CC Switch 导入的，先按 CC Switch 安装与一键导入 装好支持 OpenCode 的版本。

1. 安装 OpenCode

Mac / Linux 在终端运行：

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

已装 Node.js 的（见 Node.js 环境）也可以用 npm 安装。Windows 可以在 WSL 里用上面的安装脚本，或在本机终端运行：

npm install -g opencode-ai

装好后重新打开终端，检查版本：

opencode --version

能看到版本号即可。

2. 配置 HiAPI

方式一：用 CC Switch 一键导入

1. 打开 HiAPI OpenCode 接入页，选择模型和 HiAPI API Key，点 准备导入。

2. 在 CC Switch 的「确认导入供应商配置」窗口核对下面几项，再点 导入：

方式二：手动编辑配置文件

打开全局配置文件 ~/.config/opencode/opencode.json，添加 HiAPI 供应商（OpenAI Chat Completions 协议）。文件不存在就新建；已有其他配置的，只合并下面的 provider.hiapi 和 model 字段。Base URL 填 https://api.hiapi.ai/v1，不要再加 /chat/completions。

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "hiapi": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "HiAPI",
      "options": {
        "baseURL": "https://api.hiapi.ai/v1",
        "apiKey": "{env:HIAPI_API_KEY}"
      },
      "models": {
        "deepseek-v4.1-flash": {
          "name": "DeepSeek V4.1 Flash"
        },
        "claude-opus-5-5": {
          "name": "Claude Opus 5.5"
        }
      }
    }
  },
  "model": "hiapi/deepseek-v4.1-flash"
}

{env:HIAPI_API_KEY} 是 OpenCode 读取环境变量的写法，保持原样。再在终端设置这个变量，把 YOUR_HIAPI_API_KEY 换成你的 HiAPI API Key，保留引号：

export HIAPI_API_KEY="YOUR_HIAPI_API_KEY"

$env:HIAPI_API_KEY = "YOUR_HIAPI_API_KEY"

环境变量只对当前终端有效，设置后在同一个终端启动 OpenCode；重开终端要重新设置，或者写进 Shell 的启动配置（如 ~/.zshrc）长期生效。

示例把 hiapi/deepseek-v4.1-flash 设为默认模型。换模型时，同时改 provider.hiapi.models 里的模型定义和 model 字段。

3. 验证

进入项目目录，在设置过环境变量的终端里启动 OpenCode：

opencode

输入 /models，选 HiAPI 供应商下的模型，例如 deepseek-v4.1-flash。发送「你好，用一句话介绍你自己。」，能正常回复就说明接入成功。

两种方式导入后的供应商名称可能不同，核对当前选的供应商、模型名和 Base URL 即可；也可以在 HiAPI 控制台的 调用记录 里确认请求走的是 HiAPI。

4. 常见问题

下面只列 OpenCode 特有的问题，401、404、429 等通用报错见 通用报错。