Open code

---

一、产品简介

OpenCode 是一款开源 AI 编程助手，支持 75+ 模型与本地部署。通过 NXCLOUD Api，可在 OpenCode 中统一使用各类主流与最新模型（如 GPT、Claude、Gemini 等），并支持自定义提供商与模型配置。

下载地址：opencode.ai

二、快速配置

1. 获取 API 密钥

在 NXCLOUD 控制台 创建并复制 API 密钥。

2. 在 OpenCode 中配置自定义提供商[windows图形界面]

1. 打开 OpenCode，进入 服务器 / 提供商 设置。
2. 添加 自定义提供商（Configure an OpenAI compatible provider）。
3. 填写：
   • 提供商 ID：如 NXCLOUD（小写、数字、连字符或下划线）
   • 显示名称：如 NXCLOUD Api
   • 基础 URL：https://api.nxtoken.com/v1（必须以 /v1 结尾）
   • API 密钥：粘贴 NXCLOUD Api 密钥
4. 在 模型 中添加需要使用的模型（如 gpt-5.4）。
5. 保存后，在模型选择中使用 提供商ID/模型ID（如 NXCLOUD/gpt-5.4）。

具体配置信息

• 基础 URL：hhttps://api.nxtoken.com/v1
• API 密钥：在 NXCLOUD 控制台获取
• 模型：填入计划使用的模型ID

3. 切换模型

在对话或设置中选择已配置的提供商与模型（如 NXCLOUD/gpt-5.4）即可切换。

三、macOS非图形化界面配置

创建名为opencode.json的文件，并填入以下示例

四、部分模型需使用 Responses API（重要）

部分模型的访问接口与常规 Chat Completions 不同，需使用 Responses API。若在 OpenCode 中选用这类模型时出现类似错误：

部分 Azure/OpenAI 新模型仅支持 Responses API，不支持传统的 Chat Completions 接口。错误示例：

The chatCompletion operation does not work with the specified model, gpt-5.1-codex. Please choose different model and try again.

4.1 需要走 Responses API 的模型（典型）

模型 ID / 系列	说明
gpt-5.1-codex	GPT 5.1 Codex，编程/代码场景，仅支持 Responses API
gpt-5.2-codex	GPT 5.2 Codex，同上
o3 / o3-pro	推理模型，部分部署仅提供 Responses API
o4-mini 等 o4 系列	同上，以实际部署与官方文档为准
computer-use-preview	与 Responses API 的 computer-use 工具配合使用的实验模型

完整列表及更新以 Azure / 厂商官方文档 为准，例如：

• Azure OpenAI Responses API
• 错误提示中的链接：查看各模型支持的操作类型

4.2 小结

场景	做法
使用 gpt-5.1-codex / gpt-5.2-codex 等仅支持 Responses 的模型	在 opencode.json 中，于对应自定义提供商的 models 里为该模型添加 "apiCompatibility": "responses"。
使用 gpt-4o、claude-sonnet 等常规模型	无需添加 apiCompatibility，通过「快速配置」使用 NXCLOUD提供商即可。

五、当前支持模型

平台	型号
claude	claude-sonnet-4-6, claude-opus-4-6
openai	gpt-5.4, gpt-5.3-codex, gpt-5.4-pro, gpt-5.2-codex, gpt-5.2-pro, gpt-4o
gemini	gemini-2.5-flash, gemini-2.5-pro, gemini-2.5-flash-lite

配置成功示例

下图为使用 NXCLOUD Api 在 OpenCode 中正常对话的示例。

六、参考链接

• OpenCode 官网与下载：opencode.ai
• OpenCode 配置与模型说明：Models、Providers