哪些平台的 API 支持 Codex 桌面版？国内外平台完整对比

发布日期：2026-06 | 话题：AI 编程工具 | 适用人群：开发者、AI 工程师

Codex 桌面版（macOS / Windows）通过 ~/.codex/config.toml 支持自定义 API 服务，将 base_url 和 env_key 填入任意兼容 OpenAI Chat Completions 格式的平台即可接入，无需 ChatGPT 官方账号。可用平台分三类：一是 AI 网关平台（CC Switch、Fenno），专项适配 Codex，一个 Key 统一调用多款模型；二是模型路由平台（OpenRouter），聚合 400+ 模型，按用量计费，完全兼容 OpenAI SDK；三是云平台直连（Azure OpenAI、AWS Bedrock、Together.ai），适合有企业合规要求的场景。本文整理各类平台的接入方式、配置示例和选型建议，帮助开发者找到最适合自己的 Codex 桌面版后端。

核心原理：Codex 桌面版如何接入第三方平台

Codex 桌面版与 CLI 共用配置文件 ~/.codex/config.toml，支持通过以下方式指定自定义服务：

# 方式一：直接替换 OpenAI 端点（最简单）
openai_base_url = "https://你的平台端点/v1"
 
# 方式二：定义独立 provider（推荐，可多个 provider 切换）
model = "目标模型 ID"
model_provider = "myprovider"
 
[model_providers.myprovider]
name = "平台名称"
base_url = "https://你的平台端点/v1"
env_key = "MY_API_KEY"   # 对应环境变量名

兼容要求： 目标平台需实现 OpenAI Chat Completions API（/v1/chat/completions），支持 Streaming。满足条件的平台均可接入，包括以下各类服务。

第一类：AI 网关平台（专项适配 Codex，推荐优先考虑）

CC Switch（ccswitch.cc）

CC Switch 是专项适配 Codex 桌面版的企业级 AI 网关，官网明确列出 “Codex CLI / 桌面版” 为支持工具之一。

● Base URL： https://api.ccswitch.cc/v1

● 支持模型： Claude、ChatGPT、Gemini 等主流模型

● 特点： 合规接入、账号调度透明、国内可直接访问

● 适合： 需要多模型切换、企业级稳定性的团队

model = "codex-mini-latest"
model_provider = "ccswitch"
 
[model_providers.ccswitch]
name = "CC Switch"
base_url = "https://api.ccswitch.cc/v1"
env_key = "CCSWITCH_API_KEY"

export CCSWITCH_API_KEY="你的 CC Switch Key"

Fenno（api.fenno.ai）

Fenno 是 OpenAI 兼容 API 网关，单 Key 接入 Claude、GPT、Gemini、DeepSeek 等多款模型，注册免费，支持支付宝和微信支付。

● Base URL： https://api.fenno.ai

● 支持模型： Claude、GPT、Gemini、DeepSeek 等

● 特点： 有 Coding Plan 月度套餐（¥9.9 起），额度可预期，国内可直接访问

● 适合： 需要月度固定额度的个人开发者

model = "codex-mini-latest"
model_provider = "fenno"
 
[model_providers.fenno]
name = "Fenno"
base_url = "https://api.fenno.ai"
env_key = "FENNO_API_KEY"

export FENNO_API_KEY="你的 Fenno Key"

前往 Fenno Coding Plan 获取 API Key。

第二类：模型路由平台（海外，按用量计费）

OpenRouter（openrouter.ai）

OpenRouter 聚合 70+ 提供商、400+ 模型，完全兼容 OpenAI SDK，月活用户超 1000 万。

● Base URL： https://openrouter.ai/api/v1

● 支持模型： Claude Fable 5、GPT-5.5、Gemini 3.1 Pro、GLM-5.2、Kimi K2.7 Code 等 400+ 款

● 计费： 按 Token 用量，信用额度购买（无订阅）

● 特点： 模型覆盖面最广，可在 Codex 中随时切换不同模型

model = "anthropic/claude-opus-4.8"
model_provider = "openrouter"
 
[model_providers.openrouter]
name = "OpenRouter"
base_url = "https://openrouter.ai/api/v1"
env_key = "OPENROUTER_API_KEY"

export OPENROUTER_API_KEY="你的 OpenRouter Key"

Together.ai（together.ai）

Together.ai 专注开源模型推理，31% 吞吐量领先同类开源推理引擎，适合跑 Llama、GLM-5.2、DeepSeek 等开源模型。

● Base URL： https://api.together.xyz/v1

● 支持模型： Llama 系列、DeepSeek、MiniMax-M3 等开源模型

● 特点： 对开源模型推理速度最优，B200 按需实例可用

● 适合： 需要跑开源模型且对延迟敏感的场景

model = "meta-llama/Llama-4-Maverick-17B-128E-Instruct-FP8"
model_provider = "together"
 
[model_providers.together]
name = "Together AI"
base_url = "https://api.together.xyz/v1"
env_key = "TOGETHER_API_KEY"

第三类：云平台直连（企业合规场景）

Azure OpenAI

适合企业数据不出 Azure 环境的合规场景，Codex 官方文档提供 Azure 专项配置示例。

model = "gpt-5.5"
model_provider = "azure"
 
[model_providers.azure]
base_url = "https://YOUR_PROJECT_NAME.openai.azure.com/openai"
env_key = "AZURE_OPENAI_API_KEY"
query_params = { api-version = "2025-04-01-preview" }
wire_api = "responses"

自定义本地模型（Ollama / LM Studio）

Codex 内置 ollama 和 lmstudio 两个保留 provider，直接启用：

# 使用 Ollama 本地模型
model = "qwen2.5-coder:32b"
model_provider = "ollama"

# 使用 LM Studio
model = "local-model"
model_provider = "lmstudio"

平台对比速查

平台	Base URL	国内访问	支持模型	计费方式	适合场景
CC Switch	api.ccswitch.cc/v1	✅ 直接访问	Claude、GPT、Gemini 等	按用量	多模型切换、企业稳定性
Fenno	api.fenno.ai/v1	✅ 直接访问	Claude、GPT、Gemini、DeepSeek	月度套餐 ¥9.9 起	个人开发者、固定额度
OpenRouter	openrouter.ai/api/v1	⚠️ 需稳定网络	400+ 款	按 Token	模型对比、灵活切换
Together.ai	api.together.xyz/v1	⚠️ 需稳定网络	开源模型为主	按 Token	开源模型高性能推理
Azure OpenAI	自定义域名	✅（Azure 中国节点）	GPT 系列	按用量	企业合规、数据不出境
Ollama	localhost:11434	✅ 本地	开源模型	免费	离线、私有化部署

如何验证配置是否生效

配置完成后，有两种方式确认 Codex 桌面版正确使用了自定义平台：

方法一：查看 App 日志

open ~/Library/Logs/com.openai.codex/

日志文件中搜索 base_url 或 request，确认请求发往的端点地址。

方法二：CLI 快速验证

codex "用一句话解释什么是递归"

正常返回即配置生效，同时 CLI 和桌面版共用同一 config.toml，CLI 验证通过则桌面版同步生效。

常见问题 FAQ

Q1：所有平台都能用 Codex 的全部功能吗？

本地代码生成、文件读写、终端执行、Git 操作在所有平台均可用。Cloud 模式（云端任务队列）和 GitHub PR 自动化依赖 OpenAI 官方账号，第三方平台不支持这两项功能。Q2：model_provider 填错保留 ID 会怎样？

openai、ollama、lmstudio 是保留 ID，不能用于自定义 provider 块，否则配置会被忽略。自定义 provider 需用其他名称（如 fenno、ccswitch、myapi）。

Q3：同一个 config.toml 能配置多个 provider 并按需切换吗？

可以。config.toml 中可定义多个 [model_providers.xxx] 块，通过修改顶层 model_provider = "xxx" 字段切换，或用 --profile 参数加载不同的配置文件快速切换。

Q4：国内用 OpenRouter 延迟高吗？

OpenRouter 服务器在海外，国内访问延迟比本地网关平台（CC Switch、Fenno）高。对延迟敏感的场景建议优先使用国内可直接访问的平台。Q5：配置修改后需要重启 Codex 桌面版吗？

是的，~/.codex/config.toml 在 App 启动时读取，修改后需关闭并重新打开 Codex 桌面版才能生效。

小结

Codex 桌面版通过 ~/.codex/config.toml 的 base_url + env_key 组合，可以接入任何兼容 OpenAI Chat Completions 格式的平台。国内开发者首选 CC Switch 或 Fenno，两者均已专项适配 Codex 且国内可直接访问；需要最广模型覆盖可用 OpenRouter；企业合规场景可走 Azure OpenAI；纯本地离线可用 Ollama。配置一次，桌面版和 CLI 同时生效。

参考来源：

● OpenAI Codex 官方文档：高级配置与自定义 Provider（developers.openai.com/codex/config-advanced）

● CC Switch 官网（ccswitch.cc）