跳转到内容
opencodex

提供商

提供商（provider） 是一个上游 LLM 端点，加上访问它的方式：一个 adapter、一个基础 URL、一种认证模式，以及一个可选的模型列表。提供商配置位于 ~/.opencodex/config.json 的 providers 下。

OpenAI 账户模式

Section titled “OpenAI 账户模式”
Provider id用途凭证/账户规则
openaiCodex 登录Pool（默认）选择主账户和添加账户；Direct 只使用当前 caller/主登录。
openai-apikeyOpenAI API只使用配置的 API key/key pool；不读取 Codex 账户。

bare gpt-5.6-sol 遵循 Providers 页面中的 Pool/Direct 选项， openai-apikey/gpt-5.6-sol 选择 API。凭证路径之间不会 fallback。API 元数据为 1,050,000 context / 922,000 max input；*-pro virtual id 保留在公开状态中，线上改写为 base 模型加 reasoning.mode: "pro"。

若内置 openai 提供商缺失或已禁用，可在仪表盘 Accounts 选择器或 Codex Auth 页面恢复：缺失行会从规范预设创建，已禁用的规范行会在不替换已保存模式/模型设置的情况下重新启用，非规范的 openai 行不会提供该恢复路径。

shipped v1 配置自动迁移到 marker 2 的单一选项行。原配置只保留一次到 ~/.opencodex/config.json.pre-openai-tiers-v2.bak；恢复命令： cp ~/.opencodex/config.json.pre-openai-tiers-v2.bak ~/.opencodex/config.json。

认证模式

Section titled “认证模式”

提供商配置支持三种 authMode，默认值为 key。内置注册表还会单独标记本地预设；这类预设通常会 同时省略 authMode 和 apiKey。

authMode如何进行认证使用方
key发送你的 API 密钥（Authorization: Bearer …，或按 adapter 使用 x-api-key / api-key）。密钥可以是字面值，也可以是 ${ENV_VAR} 引用。大多数提供商。
forward将你传入的 Codex 认证请求头原样转发给提供商——不存储任何密钥。这就是 ChatGPT 登录的透传方式。OpenAI（openai-responses adapter）。
oauth读取已存储的 OAuth 访问令牌（过期前自动刷新），并将其用作 bearer 密钥。xAI、Anthropic、Kimi、Kiro、Google Antigravity、Cursor。

1. ChatGPT 登录（forward / 透传）

Section titled “1. ChatGPT 登录（forward / 透传）”

默认提供商不需要 API 密钥。它将你现有 codex login 的凭据直接转发到 OpenAI Responses 后端：

{
  "openai": {
    "adapter": "openai-responses",
    "baseUrl": "https://chatgpt.com/backend-api/codex",
    "authMode": "forward"
  }
}

只有一组精选的请求头会被转发（FORWARD_HEADERS：authorization、ChatGPT account id、OpenAI beta/originator/session——参见 Adapters）。这条路径也为 web-search 和 vision sidecar 提供支持。

ChatGPT 透传目录也会加入 GPT-5.6 Sol/Terra/Luna 的裸 slug（gpt-5.6-sol、 gpt-5.6-terra、gpt-5.6-luna）；账号具备相应权限时才能实际调用。

2. 账号登录（OAuth）

Section titled “2. 账号登录（OAuth）”

有六个提供商预设使用 OAuth 登录。opencodex 会把凭据存入 ~/.opencodex/auth.json 并自动刷新。 登录 CLI 也接受 chatgpt：它会获取一份 ChatGPT 凭据，并创建一个 forward 模式的提供商条目。

Terminal window
ocx login xai          # xAI Grok
ocx login anthropic    # Anthropic Claude (Pro/Max)
ocx login kimi         # Moonshot Kimi
ocx login kiro         # 导入 kiro-cli 凭据（支持令牌回退）
ocx login google-antigravity
ocx login cursor       # 独立的 Cursor PKCE 登录
ocx login chatgpt      # 独立的 ChatGPT OAuth 登录
ocx logout <provider>
提供商Adapter基础 URL备注
xaiopenai-chathttps://api.x.ai/v1优先使用实时 Grok 目录；回退默认模型为 grok-4.5。
anthropicanthropichttps://api.anthropic.comClaude 模型；实时模型列表从 /v1/models 获取。
kimiopenai-chathttps://api.kimi.com/coding/v1Kimi K2.7/K2.6/K2.5 编程模型。
kirokirohttps://runtime.us-east-1.kiro.dev首次登录会导入已安装并已登录的 Kiro CLI 会话（使用 `curl -fsSL https://cli.kiro.dev/install
google-antigravitygooglehttps://daily-cloudcode-pa.googleapis.com通过 Cloud Code Assist 协议使用 Google OAuth。
cursorcursorhttps://api2.cursor.sh实验性 PKCE 登录、HTTP/2 传输和按账号筛选的模型发现。

对于规范的 Kimi Coding Plan 预设（kimi 账号登录和 kimi-code API key），opencodex 只会把调用方提供的稳定 prompt_cache_key 转发到 Chat Completions 请求，绝不自行生成。Kimi 文档要求使用稳定的会话/任务 key 来提高 Code Plan 缓存命中率；没有 key 的请求仍保持不带 key。 若已 opt-in 的上游拒绝该字段，opencodex 不会删除字段后重试，也不会改动已保存配置；其他 provider 仍保持 deny-by-default。

你也可以从 web 仪表盘 启动 OAuth。

多个 OAuth 账号

Section titled “多个 OAuth 账号”

OAuth 凭据中带有稳定账号 id 或邮箱的提供商可以保存多个登录。Providers 页面会在下拉列表中显示这些 账号，允许继续添加，并在不登出其他账号的情况下切换当前账号。只有没有身份信息的 Kimi 凭据会替换 当前 active slot；Kiro 账户以配置文件 ARN 为键。chatgpt 始终只有一个 slot，因为 Codex 账号池使用独立存储。令牌仍保存在 ~/.opencodex/auth.json 中；/api/oauth/accounts 只返回脱敏后的 metadata。

Kiro 凭据导入

Section titled “Kiro 凭据导入”

Kiro 登录需要 Kiro CLI：使用 curl -fsSL https://cli.kiro.dev/install | bash 安装，并先运行 kiro-cli login。如果没有 kiro-cli 会话，ocx login kiro 会回退到粘贴的访问令牌或 KIRO_ACCESS_TOKEN 环境变量。

普通的 ocx login kiro 导入会以只读方式打开 CLI SQLite 数据库，不修改数据库、WAL 或 SHM。

  • KIROCLI_DB_PATH 用于选择非标准位置的 Kiro CLI SQLite 数据库；指定的数据库必须已经存在。
  • KIROCLI_TOKEN_KEY 在存在多个含糊的令牌行时选择确切的 auth_kv 行键。缺少选择值时，登录会失败而不会猜测。

导入的凭据会保存到 ~/.opencodex/auth.json。添加账户的回滚是独立流程：恢复之前的快照时会替换数据库，并删除当前的 WAL、SHM 和 journal 边车文件。

由于回滚依赖快照，当会话存储已存在但无法捕获时（文件不可读、架构不匹配、令牌选择有歧义），当 KIROCLI_DB_PATH / KIRO_CLI_DB_FILE 将导入路径指向与活动 CLI 存储不同的位置时，或当主 CLI 数据库没有可识别的令牌行时，添加账户会拒绝将 kiro-cli 登出。请修复或删除常规 kiro-cli 数据路径下的损坏数据库，并取消仅用于导入的选择器后重试。对于完全没有现有 kiro-cli 会话的机器，不受影响。

3. API 密钥目录

Section titled “3. API 密钥目录”

opencodex v2.7.1 内置 50 个预设：40 个密钥预设、6 个 OAuth 预设、3 个本地预设，以及默认的 ChatGPT 转发预设。仪表盘的 Add provider 选择器会打开密钥提供商的控制台，验证并保存密钥。 主要条目包括：

提供商基础 URL
OpenAI (API key)https://api.openai.com/v1
Anthropic (API key)https://api.anthropic.com
OpenRouterhttps://openrouter.ai/api/v1
Ollama Cloudhttps://ollama.com/v1
Google Gemini · Google Vertex AIhttps://generativelanguage.googleapis.com · https://aiplatform.googleapis.com
Azure OpenAIhttps://{resource}.openai.azure.com/openai
Umans AI · Neuralwatthttps://api.code.umans.ai · https://api.neuralwatt.com/v1
Mistralhttps://api.mistral.ai/v1
MiniMax · MiniMax (CN)https://api.minimax.io/v1 · https://api.minimaxi.com/v1
DeepSeekhttps://api.deepseek.com
Cerebrashttps://api.cerebras.ai/v1
Togetherhttps://api.together.xyz/v1
Fireworkshttps://api.fireworks.ai/inference/v1
Moonshot (Kimi API) · Kimi (coding)https://api.moonshot.ai/v1 · https://api.kimi.com/coding/v1
Hugging Facehttps://router.huggingface.co/v1
NVIDIA NIMhttps://integrate.api.nvidia.com/v1
Z.AI (GLM Coding)https://api.z.ai/api/coding/paas/v4
智谱 AI (BigModel)https://open.bigmodel.cn/api/paas/v4
Qwen CloudToken plan（默认）: https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1 · 按量付费: https://dashscope.aliyuncs.com/compatible-mode/v1 · 或自定义
腾讯云 Coding Planhttps://api.lkeap.cloud.tencent.com/coding/v3
SiliconFlowhttps://api.siliconflow.cn/v1
Xiaomi MiMohttps://api.xiaomimimo.com/anthropic
Kilohttps://api.kilo.ai/api/gateway
GitHub Copilot · GitLab Duohttps://api.githubcopilot.com · https://cloud.gitlab.com/ai/v1/proxy/openai/v1
Cloudflare AI Gatewayhttps://gateway.ai.cloudflare.com/v1/{account-id}/{gateway}/anthropic
……以及更多opencode zen、Vercel AI Gateway、Venice、NanoGPT、Synthetic、Qianfan、Alibaba、Parallel、ZenMux、LiteLLM

大多数使用带 bearer 密钥的 openai-chat adapter；少数仅暴露 Anthropic 兼容端点的提供商（例如 Xiaomi MiMo）使用 anthropic adapter（x-api-key）。

**腾讯云 Coding Plan 使用限制：**腾讯将此订阅限定为交互式编程工具使用。禁止通用 API 自动化、自定义应用后端和非交互式批量调用；违规使用可能导致套餐密钥被停用。

两条 GLM 线路：zai 是 Z.AI 的国际 coding plan 订阅，zhipu-bigmodel 是智谱国内 BigModel 的按量付费端点。二者主机、密钥与计费均不同，为其中一方签发的密钥无法在另一方通过鉴权。

多个 API 密钥

Section titled “多个 API 密钥”

基于密钥的提供商也可以保存多个 key。通过 Providers 页面添加密钥时，它会存入 provider.apiKeyPool、被设为 active，并同步到 provider.apiKey，这样路由和 adapter 仍读取原来的 字段。同一个下拉列表可以切换或移除密钥；管理 API 是 /api/providers/keys，并且只返回脱敏后的密钥。

从终端切换账号

Section titled “从终端切换账号”

无需打开仪表盘，即可使用 ocx account list、ocx account current 和 ocx account use 查看或 切换同一组 Codex、OAuth 和 API-key pool。完整命令、JSON 输出和新 session 生效规则请参阅 CLI 参考。

GPT-5.6 预览路径

Section titled “GPT-5.6 预览路径”

GPT-5.6 Sol/Terra/Luna 会预置在提供商的回退列表中，因此即使实时模型目录暂时滞后，ocx sync 也能继续显示这些模型。

Codex 路由预置模型 idCodex 中显示的上下文
Codex 登录（Pool 或 Direct）gpt-5.6-*372,000
OpenAI (API key)openai-apikey/gpt-5.6-* 和 *-pro1,050,000（max input 922,000）
OpenRouteropenrouter/openai/gpt-5.6-sol、openrouter/openai/gpt-5.6-terra、openrouter/openai/gpt-5.6-luna1,050,000
Cursorcursor/gpt-5.6-sol、cursor/gpt-5.6-terra、cursor/gpt-5.6-luna1,000,000

原生 GPT-5.6 条目保留固定的上游 reasoning 档位，例如 Luna 有 max，但没有 ultra。路由条目 则使用各提供商的元数据和 reasoning 映射。四条路径最终都受上游账号权限限制；Cursor 还会根据实时 发现结果，仅保留当前账号可用的模型。

Ollama Cloud

Section titled “Ollama Cloud”

Ollama Cloud 是托管（而非本地）的 Ollama，在 https://ollama.com/v1 上兼容 OpenAI，密钥来自 ollama.com/settings/keys。opencodex 按视觉能力对其云端阵容进行分类，使 vision sidecar 仅对纯文本模型生效。纯文本模型（例如 glm-5.2、deepseek-v4-pro、gpt-oss、qwen3-coder、minimax-m2.x、nemotron-3-*）列在 noVisionModels 中；原生支持视觉的模型（例如 kimi-k2.6、minimax-m3、gemma4、qwen3.5、gemini-3-flash-preview）则不在其中。匹配能容忍 Ollama 的 :size 标签，因此 gpt-oss 涵盖 gpt-oss:120b 和 gpt-oss:20b。

4. 本地提供商

Section titled “4. 本地提供商”

让 opencodex 指向本地的 OpenAI 兼容服务器——通常使用空密钥：

提供商基础 URL
Ollama (local)http://localhost:11434/v1
vLLMhttp://localhost:8000/v1
LM Studiohttp://localhost:1234/v1

任意 OpenAI 兼容端点

Section titled “任意 OpenAI 兼容端点”

如果某个提供商使用 Chat Completions，openai-chat adapter 即可处理它——在仪表盘中选择 Custom，或在 ocx init 中选择 custom 并输入基础 URL。每个提供商字段（headers、noReasoningModels、noVisionModels、models……）请参见 配置参考。