Codex 安装指南：从零到跑通的全流程

一、先搞清楚我们在干什么

Codex 是 OpenAI 推出的一款命令行 AI 编程助手。它本身不做推理，而是作为一个终端侧的 Agent，把你在命令行里的指令发给后端的大模型（比如 GPT、Claude、DeepSeek、千问等），拿到结果后帮你写代码、改代码、操作文件、运行命令等等。

你可以把它理解为：把 ChatGPT/Claude 那种对话能力，直接嵌入到了你的终端里，不用来回切窗口。

但 Codex 开箱只是一个"壳"，想让它能用，还需要配两样东西：

一个 API Key（让大模型认你是谁）
一个后端模型（告诉它该调用哪个模型干活）

这篇文章就是带你从头到尾，一步一步把这些东西都配好，中间不走弯路。

工具下载说明

本文涉及的所有软件（Node.js、CC-Switch 等），提供两种获取方式：

方案一（推荐） ：从我整理好的仓库直接下载，已经挑选好稳定版本，开箱即用：

https://gitee.com/getabear/tools
方案二：去各工具官网自行下载最新版。步骤中会标注对应的官网地址，你选哪个都行。

二、我们需要哪些工具？

整个过程需要 4 样东西，我一个个解释：

工具	它是干什么的	为什么需要它
Node.js / npm	软件运行环境和包管理工具	Codex 是用 Node.js 写的，需要先装它才能安装 Codex
Codex CLI	命令行 AI 编程助手（核心）	这就是我们要用的主角
Close AI（大模型代理商）	提供各大模型的 API 接口	帮你解决"买哪个模型、怎么付费、怎么访问"的问题
CC-Switch	模型配置切换工具	让你轻松在不同模型之间切换，不用每次重新配置

接下来我们一步一步来。

三、第一步：安装 Node.js（npm 会一起装上）

3.1 简单科普：Node.js 和 npm

Codex 是用 JavaScript 写的，而 JavaScript 要想在命令行里跑，需要一个运行时------这就是 Node.js。

npm 是 Node.js 自带的包管理工具。你可以把它理解为命令行软件的分发平台------通过一条命令，就能把网上的工具下载安装到本地。我们要的 Codex，就是通过 npm 来安装的。

如果你以前没接触过这些，不用担心。你只需要知道：装 Node.js 是为了让 Codex 能在电脑上跑起来。

3.2 安装步骤

两种方式任选其一：

方式一：从工具仓库下载（推荐）

访问 https://gitee.com/getabear/tools，找到 Node.js 安装包下载。

方式二：官网下载

去 Node.js 官网 https://nodejs.org，下载 LTS（长期支持版）安装包。

下载后双击安装包，一路点"下一步"就行，不用改任何设置。

安装完成后，验证一下是否成功：
- 按 Win + R，输入 cmd，回车，打开命令行窗口
- 输入以下命令，回车：
  bash 复制代码
```
node -v
npm -v
```
- 如果显示出版本号（比如 v20.x.x），说明安装成功 ✅

四、第二步：换国内源（让 npm 下载更快）

为什么要换源？

npm 默认从国外的服务器下载软件，速度很慢，有时候还会失败。我们把下载地址换成国内镜像，速度会快很多。

操作步骤

在命令行窗口里，依次输入以下命令（每行输入完按回车）：

bash 复制代码

# 查看当前下载地址（可以看到默认是国外的）
npm config get registry

# 换成国内淘宝镜像（下载速度飞起）
npm config set registry https://registry.npmmirror.com

💡 小提示 ：npmmirror.com 是淘宝团队维护的国内 npm 镜像，安全可靠，国内访问速度很快。

五、第三步：安装 Codex CLI

现在环境准备好了，正式安装 Codex：

在命令行窗口输入：

bash 复制代码

npm install -g @openai/codex

install = 安装
-g = 全局安装（ anywhere 都能用）
@openai/codex = Codex 的包名

等待安装完成（可能需要 1~3 分钟，取决于网速）。

安装完成后，输入以下命令验证：

bash 复制代码

codex --version

如果显示版本号，说明 Codex 安装成功 🎉

六、第四步：获取大模型 API（通过 Close AI）

6.1 为什么要用"代理商"？

你可能会问：为什么不直接用 OpenAI 或 DeepSeek 官方的 API？

原因有这几个：

一站搞定：Close AI 同时对接了 GPT、Claude、DeepSeek、千问等主流大模型，一个账号全搞定，不用到处注册。
国内访问方便：不需要翻墙，国内网络直接能用。
价格更便宜：平台有折扣，尤其是国内模型，比官方直接买划算。
切换方便：今天想用 DeepSeek，明天想试千问，在平台上点几下就切换了，不用重新申请。

类比：Close AI 就像一个"模型超市"，进去之后想用哪个模型拿哪个，统一结账，非常方便。

6.2 注册并获取 API Key

访问 Close AI 的注册链接：
复制代码
```
https://referer.shadowai.xyz/r/1051812
```
注册账号并登录后，在控制台里找到 API Keys 或密钥管理页面。
点击创建新密钥 ，复制生成的 API Key（一串类似 sk-xxxx... 的字符串）。

⚠️ 注意：API Key 不能泄露给其他人，一定要复制保存好！
这里是平台界面的模型展示