Codex CLI 支持自定义第三方兼容接口，不用局限 OpenAI 原生服务，修改配置文件、填入第三方 API 地址和密钥就能完成接入，同时 VSCode Codex 扩展可以直接读取这套 CLI 配置，实现终端命令行和编辑器内共用一套第三方 API，写代码、重构、调试、执行脚本都能走第三方模型。Codex 本身默认对接 OpenAI 官方接口，但是很多开发者想用国内兼容接口、中转网关、私有模型，所以 Codex 设计了自定义 provider 配置项，只要第三方 API 遵循 OpenAI Responses 接口规范，就可以直接接入，不用修改 CLI 源码。整套操作流程是先安装 Node.js 环境，全局安装 Codex CLI，新建.codex配置目录，写好config.toml和auth.json配置第三方服务商地址、模型、密钥，在终端测试 CLI 调用，VSCode 安装 Codex 扩展，从同一个终端启动 VSCode，读取配置完成联动，最后调试权限、网络、接口版本，排查报错。
Codex CLI 基础安装清单
- 前置依赖：Node.js 20 + 版本，npm 包管理器
- 安装命令：npm install -g @openai/codex
- 版本校验：codex --version，输出版本号代表安装成功
- 配置目录：macOS/Linux ~/.codex；Windows C:\Users\用户名\.codex（隐藏文件夹）
- 核心配置文件：config.toml（服务商、模型、接口地址）、auth.json（密钥）
- 测试命令：codex "写一段Python读取csv文件代码"，用来验证 API 连通
第三方 API 接入配置说明
- 准备第三方 API 信息：BaseURL、API Key、模型名称，确认接口支持 Responses 协议（不是老的 chat.completions）
- config.toml 基础模板
model_provider = "my-provider"
model = "模型名称"
[model_providers.my-provider]
name = "第三方服务商"
base_url = "shturl.cc/qf06Sbq2lZSL"
wire_api = "responses"
env_key = "MY_API_KEY"
- auth.json 写入密钥
{"MY_API_KEY":"sk-xxxx"}
- 环境变量方式备选：也可以直接在终端 export 密钥，不写 auth.json，适合临时切换密钥
- 多服务商切换：在 config.toml 里写多个 provider 块，修改model_provider字段切换服务商
VSCode 联动操作步骤
- VSCode 扩展市场搜索 Codex – OpenAI's coding agent，安装官方扩展
- 配置文件复用：VSCode 扩展直接读取和 CLI 同一个.codex配置，不用重复配置
- 关键启动方式：必须在已经加载好环境变量的终端里输入code .启动 VSCode；直接点图标打开会丢失环境变量，密钥读取失败
- 权限模式选择：
- Read Only：只能读代码，不能自动修改文件
- Review：改动先预览，需要手动确认
- Agent (Full Access)：允许自动编辑、执行终端命令，风险最高
- 联动验证：打开项目文件，侧边栏打开 Codex 面板，输入指令，看是否调用第三方 API 返回结果
三种使用方式对比表
| 使用方式 | 配置复用 | 优势 | 短板 | 适合人群 |
|---|---|---|---|---|
| Codex CLI 命令行 | 独立配置文件 | 自由度最高，可集成脚本、CI 流程 | 需要敲命令 | 后端、运维、喜欢终端的开发者 |
| VSCode Codex 扩展 | 和 CLI 共用一套配置 | 编码时直接选中代码提问，上下文自动读取 | 受编辑器权限限制 | 日常写代码的前端、后端开发 |
| Codex 桌面客户端 | 读取同样的～/.codex 配置 | 图形化界面，不用敲终端 | 自动化能力弱 | 不想熟悉命令行的使用者 |
常见接入踩坑清单
- 接口协议不匹配：老的 chat.completions 接口大概率无法使用，Codex 新版优先 Responses 接口
- 路径错误：base_url 不要重复加 /v1，部分服务商网关地址容易写错
- VSCode 密钥失效：从桌面图标启动 VSCode，环境变量丢失，必须终端启动
- 网络问题：第三方 API 在内网，需要配置代理，在 config.toml 中补充网络代理参数
- 模型名称写错：第三方平台模型标识和 OpenAI 不一样，要严格复制平台给的模型 ID
- 权限风险：Agent 全权限模式会自动执行 shell 命令，第三方 API 接入后同样要谨慎使用
【常见问题】
问题 1：Codex 配置第三方 API，Codex CLI 和 VSCode 联动是不是两套独立配置？
回答 1：Codex 配置第三方 API，Codex CLI 和 VSCode 的 Codex 扩展读取同一个.codex目录下的 config.toml 和 auth.json，一套配置两边共用，不用重复填写第三方 API 信息。
问题 2：Codex 配置第三方 API，第三方 API 必须兼容 OpenAI 的什么接口才能给 Codex CLI 使用？
回答 2：Codex 配置第三方 API，Codex CLI 默认依赖 Responses 接口规范，如果第三方 API 只支持 chat.completions 接口，会出现连通但是无法正常调用的问题，接入前确认服务商支持 Responses 协议。
问题 3：Codex 配置第三方 API，VSCode 里面 Codex 扩展调用失败，但是 Codex CLI 命令行正常，是什么原因？
回答 3：Codex 配置第三方 API，这种情况大多是 VSCode 不是从加载密钥的终端启动，环境变量没有传递到编辑器，需要在终端设置好密钥后，用 code . 命令启动 VSCode，才能正常读取第三方 API 密钥。
问题 4：Codex 配置第三方 API，Codex CLI 可以同时保存多个第三方服务商配置吗？
回答 4：Codex 配置第三方 API，可以在 config.toml 里面写多个 model_providers 区块，修改 model_provider 字段，随时切换不同第三方 API 服务商，不用反复改密钥。
【参考资料】
[2026-11-13]（Codex 配置第三方 API 教程｜Codex CLI 使用、接入 API、VSCode 联动）阿里云开发者社区
[2026-11-06]（Codex IDE 扩展实战：VSCode、Cursor 配置与权限模式）掘金
[2026-10-08]（VS Code Codex 扩展接入第三方兼容 API 实操）掘金
[2026-09-24]（Use Codex in Visual Studio Code Azure OpenAI）Microsoft Learn
[2026-07-09]（Codex CLI 自定义 API 网关配置文档）WanAPIs 官方文档
【免责声明】
本文仅为 Codex CLI、第三方 API 接入、VSCode 联动技术教程整理，第三方 API 服务商的稳定性、合规性、接口兼容性、计费规则由对应服务商负责；Codex Agent 全权限模式具备文件修改、命令执行能力，使用第三方 API 时请做好权限管控，不要在生产环境无限制开启全权限模式，教程操作风险由使用者自行承担。