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

npm install -g @openai/codex
codex --version

macOS 若权限报错：

sudo npm install -g @openai/codex

Homebrew 也可安装：

brew install codex

Linux

sudo npm install -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（核心）

进入 https://api.shenfengwl.fun/?ref=BAE3A5D64396E0F6注册

model_provider = "mycodex"
model = "gpt-5.4"
review_model = "gpt-5.4"
model_reasoning_effort = "xhigh"
disable_response_storage = true
network_access = "enabled"
windows_wsl_setup_acknowledged = true
model_context_window = 1000000
model_auto_compact_token_limit = 900000

[model_providers.mycodex]
name = "mycodex"
base_url = "https://api.shenfengwl.fun"
wire_api = "responses"
requires_openai_auth = true

关键点：

⚠️ provider 名字必须一致

model_provider = "whatai"
[model_providers.whatai]

否则配置不会生效。

macOS / Linux 创建命令

mkdir -p ~/.codex
touch ~/.codex/auth.json
touch ~/.codex/config.toml

配置完成必须重启终端

这是很多人失败的原因。

五、启动 Codex

进入项目目录：

cd your-project
codex

直接给任务：

codex "Explain this codebase to me"

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

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

1）先让它扫描项目

示例：

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

2）小步任务

不要一次性给大需求：

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

3）配合 Git 使用

官方建议：

git commit -m "checkpoint"

让 Codex 前后都有回滚点。

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

在交互界面输入 /

常用命令：

终端命令直接执行

很多版本支持：

!git status
!ls

减少来回切换。

八、VS Code 插件使用

完成 .codex 配置后：

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

安装后会出现在侧边栏。

终端 + IDE 双端联动。

九、常见问题排查

1）codex 找不到命令

codex --version
npm install -g @openai/codex

通常是 PATH 问题。

2）Linux/macOS 权限错误

sudo npm install -g @openai/codex

3）配置了 key 仍 401

检查：

{"OPENAI_API_KEY": "sk-xxx"}

然后 重启终端

4）模型不存在

优先尝试：

gpt-5-codex

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

5）config.toml 无效

最常见：

model_provider 名字不一致

6）如何升级 Codex

npm i -g @openai/codex@latest

十、总结

Codex CLI 本质是：

终端里的 AI 编程搭档

完整能力：

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

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

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