Skip to content

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")

OpenCode 当前官方文档采用 providers、package、settings 结构;旧版采用 provider、npm、options。两种结构不要混写,按所装客户端版本选择。

2. 当前官方配置结构 ​

用户级配置文件:%USERPROFILE%\.config\opencode\opencode.json。PowerShell 中从 $env:USERPROFILE 拼接。

如果设置了 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、配置。

本站提供 FQHX 接入说明;模型能力与审核规则以上游平台最新规定为准。