Codex配置第三方API教程｜Codex CLI使用、接入API、VSCode联动

Codex配置第三方API教程｜Codex CLI使用、接入API、VSCode联动

标签：Codex教程、Codex CLI配置、AI编程助手、接入第三方API、VSCode Codex、gpt-5 codex 使用

Trae内测版下载 win/mac安装包 支持自定义BaseURL的配置教程：2分钟实现阿里云百炼/第三方自定义api模型接入

我最近在折腾AI 自动改代码这件事。
真实感受是：现在写新功能的时间，真的已经没有「理解旧代码 + 改动 + 验证」花得多。

直到我把Codex CLI跑起来之后，开发体验发生了明显变化。

这篇文章把Codex + 第三方API完整配置流程全部整理出来，从安装到实战使用，一步不省。

一、Codex 是什么？为什么值得装

在现代软件开发中：

• 项目体量越来越大
• 技术栈越来越复杂
• 花时间最多的不是写代码，而是理解代码

Codex CLI 的定位不是聊天机器人，而是：

一个在终端运行、可以直接读写项目源码的 AI 编程搭档

它能做的事包括：

• 读取项目结构
• 理解代码依赖
• 修改文件并生成 patch
• 执行终端命令
• 分步骤完成开发任务

简单理解：

二、安装前准备

所有系统通用：

• Node.js ≥ 22
• npm ≥ 10
• 稳定网络

Windows 建议使用WSL 环境，稳定性更好。

三、安装 Codex CLI

Windows / macOS

npminstall-g@openai/codex codex--version

macOS 若权限报错：

sudonpminstall-g@openai/codex

Homebrew 也可安装：

brewinstallcodex

Linux

sudonpminstall-g@openai/codex codex--version

四、接入第三方API（重点）

Codex CLI 会读取本地配置文件：

~/.codex/

需要创建两个文件：

1）Windows 配置路径

C:\Users\用户名\.codex

注意：这是隐藏目录，需要开启“显示隐藏文件”。

创建：

auth.json config.toml

2）auth.json

{"OPENAI_API_KEY":"sk-xxx"}

替换为你的第三方 API Key。

3）config.toml（核心）

model_provider = "whatai" model = "gpt-5-codex" model_reasoning_effort = "high" disable_response_storage = true preferred_auth_method = "apikey" [model_providers.whatai] name = "whatai" base_url = "https://api.whatai.cc/v1" wire_api = "responses"

关键点：

⚠️provider 名字必须一致

model_provider = "whatai" [model_providers.whatai]

否则配置不会生效。

macOS / Linux 创建命令

mkdir-p~/.codextouch~/.codex/auth.jsontouch~/.codex/config.toml

配置完成必须重启终端

这是很多人失败的原因。

五、启动 Codex

进入项目目录：

cdyour-project codex

直接给任务：

codex"Explain this codebase to me"

六、推荐使用方式（非常关键）

实践下来最有效的工作流：

1）先让它扫描项目

示例：

先扫描项目结构，给出修改计划，不要直接动代码

2）小步任务

不要一次性给大需求：

❌ 帮我重构整个项目
✔ 修复登录接口 bug

3）配合 Git 使用

官方建议：

gitcommit-m"checkpoint"

让 Codex 前后都有回滚点。

七、Slash 命令（隐藏高效技巧）

在交互界面输入/

常用命令：

终端命令直接执行

很多版本支持：

!git status!ls

减少来回切换。

八、VS Code 插件使用

完成.codex配置后：

1. 打开 VSCode 扩展市场
2. 搜索codex
3. 安装插件

安装后会出现在侧边栏。

终端 + IDE 双端联动。

九、常见问题排查

1）codex 找不到命令

codex--versionnpminstall-g@openai/codex

通常是 PATH 问题。

2）Linux/macOS 权限错误

sudonpminstall-g@openai/codex

3）配置了 key 仍 401

检查：

{"OPENAI_API_KEY":"sk-xxx"}

然后重启终端

4）模型不存在

优先尝试：

gpt-5-codex

模型名必须与服务商提供一致。

5）config.toml 无效

最常见：

model_provider 名字不一致

6）如何升级 Codex

npmi-g@openai/codex@latest

十、总结

Codex CLI 本质是：

终端里的 AI 编程搭档

完整能力：

• 理解项目
• 自动改代码
• 执行命令
• 分步完成开发任务

当你把第三方 API 接入后，它才真正进入可日常使用状态。

如果你日常写代码时间 > 6 小时，强烈建议配置一次。