外观
OpenCode 配置
本站默认示例使用 GPT Responses。default 和正价池的 Codex 类型渠道不直接支持 Chat;需使用 Chat 时先确认兼容渠道权限。
1. 确认客户端版本与令牌
推荐先把 FQHX_API_KEY 保存为 Windows 用户环境变量,然后重开终端和客户端。步骤见用户环境变量配置。
已配置用户变量、但当前终端尚未刷新时执行:
powershell
opencode --version
$env:FQHX_API_KEY = [Environment]::GetEnvironmentVariable("FQHX_API_KEY", "User")bash
opencode --version
export FQHX_API_KEY="sk-替换为你的令牌"OpenCode 当前官方文档采用 providers、package、settings 结构;旧版采用 provider、npm、options。两种结构不要混写,按所装客户端版本选择。
2. 当前官方配置结构
用户级配置文件:%USERPROFILE%\.config\opencode\opencode.json。PowerShell 中从 $env:USERPROFILE 拼接。
用户级配置文件:~/.config/opencode/opencode.json。
如果设置了 XDG_CONFIG_HOME,使用其 opencode/opencode.json;设置 OPENCODE_CONFIG 时使用指定文件。两类系统的 JSON 内容相同,以下使用显式 Responses runtime:
json
{
"$schema": "https://opencode.ai/config.json",
"model": "fq-hx-responses/gpt-6.1-sol",
"providers": {
"fq-hx-responses": {
"name": "FQHX Responses",
"env": ["FQHX_API_KEY"],
"package": "@opencode/ai/providers/openai-compatible/responses",
"settings": {"baseURL": "https://newapi.fq-hx.com/v1"},
"models": {
"gpt-6.1-sol": {"name": "gpt-6.1-sol"},
"gpt-6.1-terra": {"name": "gpt-6.1-terra"}
}
}
}
}先通过自己的令牌确认模型可见。该配置按当前官方说明编写,本轮未运行 OpenCode 工具调用测试。
3. 旧版客户端配置
展开旧版配置
仅当你的客户端仍采用旧版结构时使用下面配置,不与上方配置合并:
json
{
"$schema": "https://opencode.ai/config.json",
"model": "fq-hx-responses/gpt-6.1-sol",
"provider": {
"fq-hx-responses": {
"npm": "@ai-sdk/openai",
"name": "FQHX Responses",
"options": {
"baseURL": "https://newapi.fq-hx.com/v1",
"apiKey": "{env:FQHX_API_KEY}"
},
"models": {
"gpt-6.1-sol": {"name": "gpt-6.1-sol"},
"gpt-6.1-terra": {"name": "gpt-6.1-terra"}
}
}
}
}Chat 与受限模型
当前官方结构中,Chat 使用 @opencode/ai/providers/openai-compatible;旧版对应 @ai-sdk/openai-compatible。只有确认执行渠道支持 Chat 后才新增独立 provider。
正价纯pro号池 仅使用 Responses;plus池 可以使用 Responses 和 Chat Completions。分别选择 provider 和当前模型 ID,不能只改模型名而保留错误协议。
使用与排查
在 OpenCode 中运行 /models 选择 provider/model,然后发送消息开始使用。需要排查接口时,统一参考首页 HTTP 验证模块中对应协议的标签。small_model 是可选项,不能预设账号可以跨分组调用。
遇到问题时展开
| 现象 | 优先检查 |
|---|---|
| 配置键无效 | 当前客户端使用哪一种配置结构 |
| 找不到模型 | provider 前缀、模型 ID 和当前令牌权限 |
| 协议错误 | runtime 是否显式选择 Responses,实际渠道是否支持 |
返回 401 | 进程是否可读取令牌环境变量 |
| 文本正常但工具失败 | 渠道和模型的工具调用、流式事件及客户端兼容性 |
官方资料:OpenCode Providers、配置。