在 AI 编程进入“智能体时代”的今天，Codex 已经不再只是一个代码补全工具，而是一个可以理解项目、修改代码、自动执行任务的 AI 编程助手。

随着 GPT-5.4 的发布，Codex 的能力也完成了一次关键跃迁：

从“写代码” → “做工程”

本文将带你从 0 到 1，完整掌握：

• 国内如何安装 Codex
• 如何接入 GPT-5.4
• 如何通过 cc-switch 实现稳定中转
• Codex 的核心使用方式
• 实战开发流程

👉 适合作为：官方说明文档 / 教程文章 / 视频脚本

---

一、Codex 是什么（官方说明）

Codex 是由 OpenAI 提供的 AI 编程模型与工具体系，基于 GPT-5 系列模型构建，能够理解自然语言并生成、修改和执行代码。

它不仅支持代码生成，还具备：

• 项目级代码理解
• 自动修改与重构
• Shell 命令执行
• Bug 自动修复
• 自动化任务编排

👉 可以理解为：

Codex = AI 编程模型（GPT-5.x） + 本地执行代理 + 开发工具链

常见使用形态：

• CLI（命令行，最强）
• IDE 插件（Cursor / VS Code）
• 桌面应用
• 云端模式

---

二、为什么选择 GPT-5.4

GPT-5.4 是目前 Codex 体系中的最强通用模型，适合复杂工程任务。

核心优势：

• 更强代码理解能力
• 支持复杂项目推理
• 上下文更大（适合大型代码库）
• 自动化能力更强

推荐使用策略：

场景	模型
日常开发	GPT-5.3
复杂任务	GPT-5.4（推荐）

---

三、国内使用 Codex 的核心思路

在国内使用 Codex，本质就是解决三个问题：

1️⃣ 安装 Codex

2️⃣ 配置 API Key

3️⃣ 配置中转（关键）

👉 其中第三点最重要：

是否稳定，取决于中转配置

---

四、Codex 安装教程（CLI 方式）

1. 环境准备

Node.js >= 22
npm >= 10

---

2. 安装 Codex

npm install -g @openai/codex

国内建议：

npm install -g @openai/codex --registry=https://registry.npmmirror.com

验证：

codex --version

---

3. 登录方式

✅ ChatGPT 登录（推荐）

codex

浏览器授权即可

---

✅ API Key 登录

export OPENAI_API_KEY="sk-xxx"
codex

---

4. 指定 GPT-5.4

codex --model gpt-5.4

或写入配置：

model = "gpt-5.4"

---

五、国内中转方案（推荐：cc-switch）

教程： https://kazjsfecs3y.feishu.cn/wiki/JNXAwxqeOiI3Hxky3BXcYdkrnYb

在国内使用 Codex（尤其 GPT-5.4），强烈建议配置中转，否则体验极差甚至不可用。

---

1. cc-switch 是什么

cc-switch 是一个 AI 接口管理工具，可用于：

• API Key 管理
• Base URL 转发（中转）
• 多模型切换
• 本地统一入口

👉 本质：

AI 网关 + 配置管理器

---

2. 安装 cc-switch

wget https://github.com/farion1231/cc-switch/releases/download/v3.12.2/CC-Switch-v3.12.2-Linux-x86_64.AppImage

chmod +x CC-Switch-v3.12.2-Linux-x86_64.AppImage

./CC-Switch-v3.12.2-Linux-x86_64.AppImage

---

3. 配置中转

填写：

参数	示例
Base URL	https://你的中转地址/v1
API Key	sk-xxx
Model	gpt-5.4

---

4. 导出给 Codex

export OPENAI_API_KEY=sk-xxx
export OPENAI_BASE_URL=https://你的中转地址/v1

或：

base_url = "https://你的中转地址/v1"
model = "gpt-5.4"

---

5. 验证

codex

输入：

写一个 hello world

成功即配置完成 ✅

---

6. 进阶用法

多模型策略

• GPT-5.3 → 日常
• GPT-5.4 → 复杂任务

---

搭配 Cursor

{
  "openai_base_url": "http://localhost:xxxx",
  "openai_api_key": "sk-xxx"
}

👉 实现：

Codex + Cursor + cc-switch 联动开发

---

六、Codex 核心使用方式

1. 启动

cd your-project
codex

---

2. 常见指令

分析项目

分析这个项目结构

修复 Bug

修复当前项目的报错

重构

优化这个模块，降低耦合

生成功能

实现一个用户登录系统（Go）

---

3. 自动模式

codex --auto-edit

模式说明：

模式	说明
Suggest	建议
Auto Edit	自动改
Full Auto	全自动

---

七、IDE 中使用 Codex

支持：

• VS Code
• Cursor
• Windsurf

步骤：

1. 安装插件
2. 登录
3. 选择 GPT-5.4

优势：

• 实时代码生成
• 项目上下文理解
• 边写边改

---

八、Codex 自动化能力（核心价值）

Codex 最大的价值不是“写代码”，而是：

自动完成开发任务

示例：

创建一个 Golang 支付系统

Codex 会自动：

1. 创建项目结构
2. 编写代码
3. 安装依赖
4. 执行测试

---

九、实战开发流程

一个标准流程：

Step 1：初始化

创建一个 Go 微服务项目（Redis + MySQL）

Step 2：模块开发

实现用户系统 + 登录接口

Step 3：调试

修复所有接口错误

Step 4：优化

提升性能

👉 最终效果：

一个人 + Codex = 一个开发团队

---

十、常见问题

❓ 连接失败

原因：

• 网络问题
• 未配置中转

解决：

👉 使用 cc-switch

---

❓ 额度问题

建议：

• 混用 5.3 / 5.4
• 控制上下文

---

❓ Linux 无界面

直接：

codex

---

十一、总结

Codex + GPT-5.4 正在改变软件开发方式：

• 从“写代码” → “描述需求”
• 从“工具” → “执行代理”
• 从“开发” → “自动化”

未来的开发模式：

人类负责思考，AI 负责实现