全部教程 /
在 OpenCode 中使用 XHuoAPI
OpenCode 是开源的编程 agent，有终端界面、桌面版和 IDE 插件，可以接入任何 OpenAI Chat Completions 兼容的接口。XHuoAPI 提供这个接口，所以在配置文件里加一个 provider 就能用。我们用 OpenCode 2.1.2 实际让它新建了一个文件，下面的配置就是测试时用的那份。
开始之前
先验证一下
curl https://api.xhuoapi.ai/v1/chat/completions \
-H "Authorization: Bearer sk-..." \
-H "Content-Type: application/json" \
-d '{"model":"deepseek-v3.2","messages":[{"role":"user","content":"ping"}]}'
配置步骤
1
安装 OpenCode 2。OpenCode 1 和 2 都用 opencode 这个命令，不能同时安装；1 的配置写法不同，见下方提示。
npm install -g @opencode/cli opencode --version
2
把 API Key 放进环境变量。变量名可以自己定，下一步配置里的 env 写同一个名字。
export XHUOAPI_API_KEY=YOUR_XHUOAPI_KEY
3
在项目目录新建 opencode.jsonc，写入下面的 provider。package 用 OpenAI 兼容的那个；baseURL 写到 /v1 为止；models 里的键就是模型 ID，用定价页上的写法。
{
"$schema": "https://opencode.ai/config.json",
"providers": {
"xhuoapi": {
"name": "XHuoAPI",
"env": ["XHUOAPI_API_KEY"],
"package": "@opencode/ai/providers/openai-compatible",
"settings": { "baseURL": "https://api.xhuoapi.ai/v1" },
"models": {
"glm-5.3": { "name": "GLM-5.3" },
"deepseek-v4.1-flash-none": { "name": "DeepSeek V4.1 Flash" },
"qwen3.8-max": { "name": "Qwen3.8-Max" }
}
}
}
}
4
模型写成 provider/模型 ID。在项目目录里运行 opencode 进入交互界面，或者用 opencode run 跑一次性任务。
opencode run -m xhuoapi/glm-5.3 "Create hello.py that prints hello" opencode
注意事项
实测结果（2026-10-22，OpenCode 2.1.2，让它新建 hello.py）：glm-5.3（20 秒）、deepseek-v4.1-flash-none（8 秒）、qwen3.8-max（8 秒）、deepseek-v4-flash（18 秒）、deepseek-v3.2（22 秒）都一次通过；kimi-k3 3 次里 2 次通过，失败那次回复说文件已建好，实际没有调用写文件工具。
OpenCode 1 的写法：顶层键是 provider（单数），用 "npm": "@ai-sdk/openai-compatible"，地址写在 options.baseURL；Key 可以用 /connect 选 Other 保存，或在 options 里写 "apiKey": "{env:XHUOAPI_API_KEY}"。我们只实测了 OpenCode 2。
在脚本里用 opencode run 时，加 --auto 会自动批准没有被明确禁止的权限请求，否则写文件、执行命令会停下来等确认。--auto 不是沙箱，只在你信任的目录里用。
OpenCode 2 默认连接本机的后台服务。如果改了配置却没生效，或后台服务出问题，加 --standalone 用独立的私有服务运行（我们测试时就是这样跑的）。
模型名必须与定价页里的 ID 完全一致（例如 deepseek-v4-pro，不是 DeepSeek V4 Pro）。大小写、连字符都算。