跳到主要内容

Codex 下载与使用手册

本手册介绍基本使用方法。安装命令和功能会随版本更新，请以 Codex Github官方文档1 、 Codex Github官方文档2 为准。

教程基于 Codex Github官方文档1 、 Codex Github官方文档2 和 知乎教程 编写。

一、下载前了解​

  • Codex 是 OpenAI 提供的 AI 编程 Agent。若考虑使用Codex，推荐和同属于 OpenAI 的 ChatGPT 模型一起使用。

  • Codex有多种下载方式，这里只介绍CLI和插件这两种下载方式。Codex还有App，也就是桌面版。因为步骤较为繁琐，这里不进行介绍。

  • 若实在想使用App，可以去B站搜索了解，这里推荐这个 视频 。提醒一下，视频不是我们制作的。

附上 App官方下载地址

二、Codex CLI 版本安装​

系统要求：

  • Windows 10 或 Windows 11
  • Node.js 22+
  • npm 10+

1、安装 Git​

请访问 Git - Downloads 网站，选择 Windows 对应版本安装。

2、安装 Node.js 和 npm​

访问 Node.js 官网，选择上方“Download” 进入下载页面，如下图所示。 Node.js01

  • 红色 1 请点击下拉列表选择最新 LST 版本。

  • 红色2 若有Docker可以在终端窗口中输入所圈命令安装。

  • 红色3 若没有Docker，则可使用安装包msi文件或免安装zip文件。

安装完后可检查版本号是否正确

Win + R 输入 “cmd” 或 “powershell” 打开终端窗口并运行：

#Node.js版本要大于22
node -v

#npm版本要大于10
npm -v

3、安装Codex​

npm install -g @openai/codex

安装完后关闭终端窗口。

在 CC Switch 中进行配置。如何配置请看 CC Switch 配置

4、启动Codex​

打开终端，输入：

#如果想在特定目录里运行 Codex ，在启动 Codex 前可以运行

# CMD 终端窗口
cd /d "你的工作目录具体路径地址"

# PowerShell 终端窗口
cd 你的工作目录具体路径地址

#如果想在启动前检查一下，可以运行
codex doctor

#启动
codex

#打开历史对话记录可使用
codex resume

#或打开最近一次对话
codex resume --last

三、Codex 插件版本安装​

如果更习惯图形界面，可以在 VS Code 的扩展市场中搜索 Codex，注意是 OpenAI 官方发布者提供的，不要错下为其他的 Codex 了。如下图所示。

VSCode01

安装后，在 VS Code 中打开项目文件夹，再从 Codex 面板开始对话。

四、安全注意事项​

  • 不要把 API Key 写进公开代码仓库或截图。
  • AI 生成的命令可能删除、覆盖或上传文件，执行前先阅读命令内容。
  • 不要在包含密码、个人资料或公司机密的目录中盲目授权 AI 操作。