• 通过截图和我一起配置文档一坨但富可敌国的转发站作为 Provider
• 一起看懂模型接口，Opencode，AI-SDK 官方文档
• 了解并动手设置 Claude 和 OAI 不同模型和接口的参数配置（如思考预算）

• 本教程不含有自定义 Agents 和 Skills 教学
• 在完成本教程后，如还有兴趣，可以继续探索或和各位佬友帖子交流
• 其他资源：全面教程 ------- 官方文档 ----- 官方文档 (中文站)

如果你没有安装 opencode：
请参考此链接安装 opencode TUI 版 Opencode|Github

如果你有 opencode：
查看在 C:\Users <你的用户名>.config\opencode 目录下是否存在 opencode.json
如果没有，请不要手动创建。经过第二节的 Provider 配置，它会自动产生在这个目录下。

打开 opencode，输入 /connect

注意：只需要重新走一遍此流程就能覆盖之前的认证
Provider auth 的文件在这里：C:\Users <你的用户名>.local\share\opencode
如果对此流程具体涉及的文件感兴趣，拓展阅读在 2.2 节 action4 提供

1. 官方文档 Providers | OpenCode
2. 翻译版 提供商 (Providers) - OpenCode 中文文档

如果使用 action3，最好也看一下 action4
以便于理解后续 Models 配置部分对.json 的自定义修改。

Opencode 的逻辑是由开发者来列出所有合法的 provider 供连接，非常全。但 Right Code 这样的转发站理论上确实不受 opencode 支持。

大部分佬友遇到的困难集中在使用 opencode 命令打开 TUI (Terminal UI) 界面后，/connect 的 provider 中没有 "other" 或者 "custom" 选项。我们可以看到 Other 选项是个标题，确实不能选 Other 选项，而且经过搜索 Other 里面也没有 Right Code 这样的转发站。

不过，我们仍然可以通过配置 opencode.json 来解决这个问题。
@coulsontl
使用佬友的项目 AI-toolbox 可视化配置 opencode.json 和 auth：

• step 1：下载并安装 releases.

  

• step 2：填写你想自定义的供应商名和显示名

  

• step 3：按照图片填写 NPM 包和 BaseURL 即可

  

• step 4: 点击 “获取模型”，在列表中添加想用的模型

  
  
  
  
  
  
  

• step 5：已经可以使用了。Oh-My-Opencode 也可以配置此种模式导入的模型。

  
  
  
  

非常好用！感谢 coulsontl 佬友！

不支持自定义 Options/Variants 配置，导入新 Provider 会覆写旧文件

也许后续我会提 PR？

如想知道如何填写 NPM 包和 BaseURL，请参考 document-reading 1！

Opencode 的逻辑是由开发者来列出所有合法的 provider 供连接，非常全。但 Right Code 这样的转发站理论上确实不受 opencode 支持。大部分佬友遇到的困难集中在使用 opencode 命令打开 TUI (Terminal UI) 界面后，/connect 的 provider 中没有 "other" 或者 "custom" 选项。我们可以看到 Other 选项是个标题，确实不能选 Other 选项，而且经过搜索 Other 里面也没有 Right Code 这样的转发站。

TUI 中 /connect 选项设置基于默认的合法 auth。不过，我们只需要随意在没有连接的选项中选一个然后改成我们的 auth 就可以了。

Provider auth 的文件在这里：C:\Users <你的用户名>.local\share\opencode
如果你之前连接过其他的方案，例如 github copilot，也会在这里显示。同时，你可以删除这里面的配置，TUI 里会同步更新，相信可能会有佬友配错了想 disconnected 但找不到路子的，请修改这个文件，删除对应部分即可。

然后，修改 provider name 为一个你喜欢的名字，我这里修改为 RC Codex，key 填写为你的 apikey。需要修改，否则自动识别，勿与 opencode 的内置 provider（例如刚才的 privatemode AI）同名。

（我这里填写 666 是为了占位，请在转发站生成 api key 并填写。下图为获取 api-key 的界面）

那么 auth 就配置完成了！
接下来请转到 C:\Users <你的用户名>.config\opencode
查看是否有 opencode.json 或.jsonc
我这里就没有。如果没有，创建一个。

此处 jsonc 和 json 的区别是 jsonc 可以写批注。c 是 comment 的意思。其他没有区别。

创建完毕后，写入对应于 provider auth 的 model 内容，参考示例如下。具体需要配置的部分都进行了注释，将由 document-reading 1 来详细讲解，以便大家知道为什么这么配置，进而配置不同的转发站。

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "RC-Codex": {  // 和auth中修改的名称一致 "npm": "@ai-sdk/openai", // 兼容的SDK，将于后续document-reading 1详细讲解 "name": "RingCode-CodeX",  // 在 TUI 中显示的名称 "options": {
        "baseURL": "https://www.right.codes/codex/v1",  // 中转站 API 地址（必须以 /v1 结尾或符合 OpenAI 格式），将于document-reading 1中详细讲解 "apiKey": "666"// 明文填写你的api-key，懂得引用的佬友可以用引用形式 // 如果中转站需要自定义 headers，可添加： // "headers": { //   "X-Custom-Header": "your-value" // }
      },
      "models": {
        "gpt-5.1-codex-max": {  // 中转站支持的模型ID，例如 gpt-4o、claude-3-5-sonnet 等，将于document-reading 1中详细讲解 "name": "Codex-5.1-max(RC-Codex)" //自定义显示名称
        },
        "gpt-5.1": {
          "name": "Gpt-5.1(RC-Codex)"
        }
        // 添加更多模型...
      }
    }
  }
}

此 opencode-config.json 参考来源

- document-reading 1
- 官方文档：https://opencode.ai/docs/models/
- 站内轮子：https://linux.do/t/topic/1329050 

配置完成后，我们就可以愉快地重启 opencode，选择 codex 模型了。

什么…? 你用的不是 Right Code 不知道注释的地方填什么？你需要阅读官方文档！

请在document-reading 1和我一起阅读文档！
来看看我是怎么在Right Code文档完全一坨的前提下填写这些字段的。
（声明：Right Code是我最喜欢的转发站之一，codex量大管饱，没有不喜欢的意思，但是文档和网站确实需要改进）

通过在 powershell 中输入 opencode auth login 配置
TUI 的打开命令是 opencode，那么其实 opencode 是一个程序，TUI 其实就是无参运行这个程序。可以想象，其实带参运行这个程序是才是触发程序中内置的功能比较常见的途径。那么 /connect 对应的带参运行其实就是 opencode auth login.

RightCode 的文档和网站是最草率的那一批，但我们仍然可以获得足够的信息。

• step1：获得转发站 baseurl 以填写 baseurl 字段
  在 RightCode 官方文档中没有提到 Opencode 如何配置，也没写 BaseUrl。
  在模型列表可用端口处点击复制按钮，
  分别得到 https://www.right.codes/claude-aws
  和 https://www.right.codes/codex，那么加上 v1，这就是两个模型池分别的 BaseUrl。
  
  
  
  为什么加上 v1：
  RightCode 文档里也加了。v1 是通用的接口规范，如果接口请求不对，没有 v1 就加上 v1
  
  
  
  通过以上信息可以填写如下的 baseurl 和 apikey 部分（apikey 获取此处省略）

 "options": { "baseURL": "https://www.right.codes/codex/v1", // 中转站 API 地址（必须以 /v1 结尾或符合 OpenAI 格式），将于document-reading 1中详细讲解 "apiKey": "666"// 明文填写你的api-key，懂得引用的佬友可以用引用形式 // 如果中转站需要自定义 headers，可添加： // "headers": { //   "X-Custom-Header": "your-value" // } }, 

• step2：填写 models
  在模型广场里找到了如下的模型
  
  
  
  在使用文档也里找到了如下的 models 可以填写。
  
  
  
  因此可以填写 config 文件中对应的这几行。（注意：实际支持 5.2codex，以模型广场为准。这文档不全）

 "models": { "gpt-5.1-codex-max": { // 中转站支持的模型ID，例如 gpt-4o、claude-3-5-sonnet 等，将于document-reading 1中详细讲解 "name": "Codex-5.1-max(RC-Codex)" //自定义显示名称 }, "gpt-5.1": { "name": "Gpt-5.1(RC-Codex)" } 

• step3：获得转发站支持的接口以填写 npm 字段
  我们可以看到 Right Code 支持了 Openai 新版 responses 和老版 chat/completions 接口，也支持了 Antropic 新版 messages 接口。
  
  
  
  那么知道了支持的接口该怎么填写 npm 字段呢？这个字段好像也不是接口。

不知道什么意思的时候就请查看 Opencode 官方文档。

根据 Models | OpenCode opencode 是基于 Vercel 的 AI SDK 项目（实际上大部分 AI 工具都基于 AI-SDK 转发请求）和 models.dev 项目的。所以去查看这两个项目的官方文档。models.dev 看了之后和我们的需求没什么关系，opencode.json 的实现是依赖于 AI-SDK 的。AI-SDK 表示接口的实现依赖于对应的 npm 包。也就是说一个包对应一个接口。

查 AI SDK 的文档 Foundations: Providers and Models

进去之后发现左上角 navigator 有一个 Providers，那么层级应该是 Provider/Model，所以应该要从这里进去了。

点进去以后来到了这个页面

AI SDK Providers

分别查看 openai,openai-compatible-providers 和 claude 的接口标准

AI SDK Providers: OpenAI
AI SDK Providers: Anthropic
OpenAI Compatible Providers

能看到文档中说明 openai Provider 包含有 /responses 请求接口的实现，openai-compatible-providers 包含 /chat/completions 接口的实现，claude 包含有 /messages 接口的实现。这就对应上了。（反过来怎么找到这的：在官方文档中使用搜索，搜索对应接口去找对应 Provider.）

因此我们可以配置接口部分：
"npm": "@ai-sdk/openai", // responses接口对应的SDK
由于官方文档中提到，Right Code 也支持了老版的 /chat/completions 接口，所以这个地方的 SDK 也可以配置为 openai-compatible.
`“npm”: “@ai-sdk/openai-compatible”, // 兼容的 SDK

完整的初步配置文件：

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "RC-Codex": {  // 和auth中修改的名称一致 "npm": "@ai-sdk/openai", // /responses接口对应的SDK "name": "RingCode-CodeX",  // 在 TUI 中显示的名称 "options": {
        "baseURL": "https://www.right.codes/codex/v1", 
        "apiKey": "666"

      },
      "models": {
        "gpt-5.1-codex-max": {  // 中转站支持的模型ID "name": "Codex-5.1-max(RC-Codex)" //自定义显示名称
        },
        "gpt-5.1": {
          "name": "Gpt-5.1(RC-Codex)"
        }
      }
    }
  }
}

现在就可以用了。在后续 Options 中将提及如何优化模型体验，包括设置思考预算。

有很多佬友开发了可视化 / 后端插件

• AI-toolbox：这款软件支持插件的装载和取消装载，对于我这种不想每次都用 Oh-My-Opencode 的人来说非常好。我非常喜欢这款软件！谢谢佬友！
• OCCM ：非常好用的一款小软件
• CLIProxyAPI： 教程帖；
• CC Switch 将于近日发布的 3.10 版本支持 Opencode！ commit 记录
• 其他我没有关注到的链接非常抱歉！请留言！

1. 官方文档 Providers | OpenCode
2. 翻译版 提供商 (Providers) - OpenCode 中文文档

@coulsontl 佬友的 AI-toolbox 很好！！但也有一些还没实现的部分：
①不含 Skills 设置
②目前只能设置 Oh-My-Opencode 插件中 Agents 的开关，不含 Custom Agents 的设置

其实我感觉 OMO 太重了，而且大多数项目其实并不完全适合 OMO 的 Agents 分配方式。要是 OMO 能完全嵌入 Opencode 的原生 Agents 流程就好了！

目前只是偶尔用用 OMO，日常开发更喜欢在 Opencode 中使用各种自定义 Agents，后续或许写一个 PR 来实现不同 custom agents 的开关，以及更上一层不同 Agents 组合配置的切换功能。

在例图 1 时，我的 opencode.json 配置对应片段如下：

"RightCodes-OAI": {
      "npm": "@ai-sdk/openai",
      "name": "Rightcodes-OAI",
      "options": {
        "baseURL": "https://www.right.codes/codex/v1",
        "apiKey": "用你的api-key代替",
      },
      "models": {
        "gpt-5.1-codex-max": {
          "name": "gpt-5.1-codex-max",
        }
      }
    }

在例图 2 时，我的 opencode.json 配置对应片段如下：

"RightCodes-OAI": {
      "npm": "@ai-sdk/openai",
      "name": "Rightcodes-OAI",
      "options": {
        "baseURL": "https://www.right.codes/codex/v1",
        "apiKey": "用你的api-key代替",
      },
      "models": {
        "gpt-5.1-codex-max": {
          "name": "gpt-5.1-codex-max",
          "options":{
            "reasoningEffort": "high",
            "textVerbosity": "medium",
            "reasoningSummary": "auto"
	        }
        },
      }
    }

reasoningEffort 代表模型的推理预算，从 low 到 Xhigh（一般推荐设置为 high，因为 Xhigh 可能并没有太明显的帮助，而且有些模型没有 Xhigh 选项）

textVerbosity 控制模型的输出长度，medium 代表中等；

reasoningSummary 代表模型是否输出 thinking 的总结（即 example2 中黄色的 thinking：xxx 部分），auto 代表自动控制思考总结的长度。

这种时候我们要寻求 Opencode 官方文档的帮助。

• step1：
  首先根据 Models | OpenCode opencode 是基于 Vercel 的 AI SDK 项目和 models.dev 项目的，所以去查看这两个项目的官方文档。

  

• step2：
  查 AI SDK 的文档 Foundations: Providers and Models
  进去之后发现左上角 navigator 有一个 Providers，那么层级应该是 Provider/Model/Options，所以应该要从这里进去了。如果你没注意到 navigator，其实也可以从左边目录的 Provider and Models 进去。如果 “官方文档里没有”，那你可能要从更高层级上找一找。这是看大部分组织良好的官方文档的小技巧。

  

• step3：
  点进去以后来到了这个页面
  AI SDK Providers
  分别查看 openai 和 claude 的接口标准
  （为什么查看这两个接口请参考 notification 1&2）：
  AI SDK Providers: OpenAI
  AI SDK Providers: Anthropic
  能看到文档中已经详细说明了每个 options 有什么含义及如何填写。

  
  
  
  

options 配置隶属于 models 配置，不同 Provider 提供的请求接口不同，options 的设置也因此完全不同，例如 codex 系列模型通过 OPENAI 的 /responses 接口请求，claude 系列模型则通过 ANTROPIC 的 /messages 接口请求，因此，一个中转站的不同 Provider 模型应该遵循不同的 options 设置。

进一步地，同一个 Provider（厂商），相同接口的不同模型也可能支持不同的 options 设置，例如 codex 的部分模型虽然也使用 openai/responses 接口，但却不支持思考预算为 xhigh 的设置；gemini 的生图模型和推理模型显然不能遵循同样的 options 设置。

因此，最好的方式是为每个常用模型分别设置 options。

具体请参考 document-reading 1 中 AI-SDK 不同 Providers 页面下的相关接口实现。
分辨你的常用模型使用哪个接口，并确定其是否满足接口的所有 options 参数。
设置无效的 options 不会引发报错，但可能毫无作用，进而可能导致 example 1 中模型不能发挥出应有实力的表现。

AI-SDK 的文档当然已经非常够用了，不过如果你想更深程度的了解究竟有哪些 options，那么 AI-SDK 的文档里还是没有写的完全清楚，例如在 include 这里，AI-SDK 只写了两个支持的值，实际上这里不止两个值可以填。

其实我们还可以去检查 OPENAI 和 ANTROPIC 的官方文档来确认究竟有哪些 options。

这里以 OPENAI 为例：我们查找官方文档中关于 Reponses API 的部分（善用文档库自带的搜索框）可以看到 include 列表一共有七个可选的值。

有任何关于你想要的模型自主设置也可以继续在 responses api 里探索。responses api 是许多模型共用的接口，你使用的模型可能并不支持该接口的所有功能。
https://platform.openai.com/docs/api-reference/responses/create

本文以配置 Right Code 家的 codex 和 claude 为例。在 RightCode 官方文档 中，codex 实现的接口为 OPENAI 官方的 responses 接口，因此应该遵循 responses 接口的 options 设置。claude 实现的接口为 ANTROPIC 官方的 messages 接口，因此应该遵循 messages 接口的 options 设置。

题目：

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "RCS-Claude": {
      "npm": "@ai-sdk/anthropic",
      "name": "RC中转站Claude端点(awsq)",
      "options": {
        "baseURL": "https://www.right.codes/claude-aws/v1",
        "apiKey": "666"
      },
      "models": {
        "claude-opus-4-5-20251101": {
          "name": "claude-opus-4-5-20251101"
        }
      }
    }
  },
  "model": "RCS-Codex/gpt-5.1",
  "small_model": "opencode/grok-code"
}

答案供参考：

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "RCS-Claude": {
      "npm": "@ai-sdk/anthropic",
      "name": "RC中转站Claude端点(awsq)",
      "options": {
        "baseURL": "https://www.right.codes/claude-aws/v1",
        "apiKey": "666"
      },
      "models": {
        "claude-opus-4-5-20251101": {
          "name": "claude-opus-4-5-20251101",
           "variants":{ 
              "very-lazy": {
                "effort": "low" 
              },
              "think-2000":{
                "thinking": { "type": "enabled", "budgetTokens": 2000 },
              },
              "think-1w6":{
                "thinking": { "type": "enabled", "budgetTokens": 16000 },
              },
            }
        }
      }
    }
  },
  "model": "RCS-Codex/gpt-5.1",
  "small_model": "opencode/grok-code"
}

参考文档：
AI-SDK Provider:Antropic

不兼容的 options 不会生效，但问题在于也不会报错。它们只是影响你的模型 "智力".