📖 前言

Codex 是 OpenAI 推出的 AI 编程助手，能帮你自动写代码、改 Bug、做重构——简单说就是"让 AI 帮你敲代码"。

但目前大部分 Codex 教程，要么只给半截步骤引流，要么关键配置一笔带过，照着做根本跑不起来。所以这篇教程我会把每一步都写清楚，从零开始，装完就能用。

---

📑 目录

1. 安装 Node.js 以及 npm
2. 安装 Codex
3. 配置国内外大模型 API

---

一、安装 Node.js 以及 npm

Codex 基于 Node.js 运行，所以第一步先装好它。

💡 npm 是什么？ Node.js 自带的包管理器，装完 Node.js 就自动有了，不需要单独安装。

1. 先检查是否已安装

打开 CMD（Win + R → 输入 cmd → 回车），输入：

node -v

如果已经显示版本号（如 v22.x.x），说明已安装，直接跳到第二步。

2. 下载安装

1. 打开Node.js官网
2. 下载 LTS 版本（长期支持版，更稳定）的 .msi 安装包
3. 双击运行，安装路径保持默认，一路 Next 即可

3. 验证安装

⚠️ 必须重新打开一个 CMD 窗口（安装后环境变量不会自动刷新，重开才生效），依次输入：

node -v

npm -v

两个都显示版本号 → 安装成功 ✅

🔧 遇到问题？ 如果提示「node 不是内部或外部命令」

先确认是否重新打开了 CMD——这是最常见的原因。

重开仍然报错的话，手动配置环境变量：

1. 右键「此电脑」→ 属性 → 高级系统设置 → 环境变量
2. 在「系统变量」的 Path 中点击编辑 → 新建
3. 填入你的 Node.js 安装路径（如 C:\Program Files\nodejs，以你实际安装路径为准）
4. 确定保存，重新打开 CMD 验证

---

二、安装 Codex

Node.js 装好后，就可以安装 Codex 了。

1. 命令行安装

打开 CMD，输入：

npm install -g @openai/codex

-g 表示全局安装，装完在任何目录都能用。

安装完成后验证：

codex --version

显示版本号 → 安装成功 ✅

2. 安装桌面版（推荐）

以上安装的是命令行版本的codex，除了命令行版本，Codex 还提供了桌面客户端和 VS Code 插件两种使用方式，体验更好。

这里以桌面版为例：

1. 打开 Codex 官网
2. 下载对应系统的桌面版安装包
3. 双击运行安装即可

---

三、配置国内外大模型 API

这一步是重点。 Codex 默认使用 OpenAI 的模型，但 OpenAI 的 API 国内访问需要科学上网，而且价格不便宜。

通过 cc-switch 这个工具，我们可以把 Codex 的后端切换到国内外其他大模型的 API——比如 DeepSeek、硅基流动等，不需要科学上网，价格也更低。

1. 安装 cc-switch

1. github下载cc-switch最新版本的安装包
2. 安装到本地

💡 cc-switch 是什么？ 一个开源的 Codex 模型切换工具，可以让你自由配置 Codex 使用哪个大模型的 API，不局限于 OpenAI。

2. 添加 API 供应商

1. 打开 cc-switch，点击左下角的 「+」 添加供应商
2. 填写你的 API Key 和 API 地址（URL）

4. 启动使用

保存配置后，重启 Codex，它就会默认使用你配置的 API 大模型了。

到这里，整个安装配置就完成了 🎉 打开 Codex 开始用吧！

---

💬 写在最后

如果你跟着教程成功装好了 Codex，点个赞让更多人看到这篇教程，这也算是对我花时间写教程的一点鼓励。

安装过程中遇到任何问题，欢迎评论区留言或私信，我看到都会回复。