Codex 安装与使用教程（新手向，从零到跑通）

Codex 安装与使用教程新手向从零到跑通本文面向第一次接触 AI 编程工具的读者。读完之后你应该能根据自己的系统选对安装方式把 Codex 装好、登录成功并跑出第一个示例。一、Codex 的五种使用方式Codex 不是一个单独的软件而是一套能力它可以用多种形态使用。根据你的习惯选一种即可安装方式使用场景推荐程度Codex 应用直接下载桌面/网页应用开箱即用⭐⭐⭐⭐Codex CLI在终端中使用开发者最常用⭐⭐⭐⭐⭐IDE 插件在 VS Code / Cursor 等编辑器中使用⭐⭐⭐⭐Homebrew 安装Mac 用户不想装 Node.js⭐⭐⭐⭐GitHub Release 二进制手动安装无包管理器时使用⭐⭐⭐新手建议如果只是想先体验走「Codex 应用」如果打算长期用来写代码直接装「Codex CLI」。下面逐个介绍。二、方式一Codex 应用最简单这是最省事的方式本质上就是使用 ChatGPT 的客户端需要能正常访问 ChatGPT。打开下载页https://chatgpt.com/zh-Hans-CN/download/下载对应系统的应用并安装用你的 ChatGPT 账号登录登录后在界面中切换到Codex 模式就可以在输入框里直接描述需求比如「帮我写一个 Python 脚本批量重命名当前目录下的图片」。访问有困难怎么办国内也有类似产品可以先用它们熟悉「AI 编程」这件事本身阿里的Qoder、字节跳动的Trae。等条件允许时再回来用 Codex操作逻辑是相通的。三、方式二Codex CLI推荐CLI 是一个运行在终端里的 AI 编程代理它可以阅读你的代码修改代码执行 shell 命令自动修复 bug它在本地运行代码本身不会被上传到云端只有你的提示词和必要的上下文会发送给模型。3.1 安装macOS / Linux 一键安装与更新curl-fsSLhttps://chatgpt.com/codex/install.sh|shWindows 一键安装与更新PowerShellpowershell-ExecutionPolicy ByPass-cirm https://chatgpt.com/codex/install.ps1 | iex使用 npm 安装前提是已装 Node.js见文末附录npminstall-gopenai/codex# 国内网络建议换镜像速度快很多npminstall-gopenai/codex--registryhttps://registry.npmmirror.com安装完成后在终端输入codex能启动就说明装好了。3.2 登录首次运行需要登录有两种方式。方法一ChatGPT 账号登录推荐codex在提示中选择Sign in with ChatGPT浏览器会自动打开登录页登录完成后即可使用。方法二API Key 登录适合有开发者账号、希望按量计费的同学。# macOS / Linux —— 临时设置仅当前终端会话有效exportOPENAI_API_KEYsk-你的API密钥# macOS / Linux —— 永久配置写入 shell 配置文件echoexport OPENAI_API_KEYsk-你的API密钥~/.zshrc# 用 bash 就改成 ~/.bashrcsource~/.zshrc# Windows PowerShell$env:OPENAI_API_KEYsk-你的API密钥配置后可以指定模型启动codex--modelgpt-5-codex方法三使用 auth.json 配置文件适合不想动环境变量、或者需要多套配置切换的场景。# 1. 创建配置目录mkdir-p~/.codex# 2. 写入 API Keycat~/.codex/auth.jsonEOF { OPENAI_API_KEY: sk-你的API密钥 } EOF之后直接运行codex即可。3.3 跑通第一个例子准备一个空目录做实验mkdircodex-runoob-testcdcodex-runoob-test新建test.py内容如下print(Hello Runoob!)在当前目录下启动 Codexcodex第一次进入会问你「是否信任当前目录」用方向键选第一个Yes, continue回车即可。进入交互界面后直接输入自然语言比如分析下当前的项目结构Codex 会自动扫描代码库、分析项目结构并输出一份架构说明。3.4 三种运行模式Codex CLI 提供三种安全模式决定了它对文件的改动权限模式启动参数功能Suggest默认只给出修改建议不落盘Auto Editcodex --auto-edit可自动修改文件Full Autocodex --full-auto自动执行所有操作含运行命令# 自动修改文件codex --auto-edit# 全自动慎用建议在 Git 仓库里用方便回滚codex --full-auto新手建议先用默认的 Suggest 模式跑几次熟悉它的行为再逐步放开权限。四、方式三Homebrew 安装Mac 推荐Mac 用户如果已经装了 Homebrew一行命令搞定brewinstall--caskcodex安装完成后运行codex启动。这种方式适合Mac 开发者、不想额外安装 Node.js 的用户。提示不同版本 Homebrew 上包名可能略有差异若--cask codex找不到包可尝试brew install codex。五、方式四GitHub Release 二进制安装如果不想用 npm也可以直接下载编译好的二进制文件。下载地址https://github.com/openai/codex/releases按平台选择对应文件平台文件MacApple Silicon / M 系列codex-aarch64-apple-darwin.tar.gzMacIntelcodex-x86_64-apple-darwin.tar.gzLinuxcodex-x86_64-unknown-linux-musl.tar.gz解压并放入 PATHtar-xzfcodex-xxx.tar.gzmvcodex-x86_64-unknown-linux-musl codexsudomvcodex /usr/local/bin然后运行codex即可。六、方式五IDE 插件Codex 也提供编辑器插件支持 VS Code、Cursor、Windsurf 以及各类 VS Code 衍生版本。安装步骤打开 IDE 的插件市场Extensions搜索Codex安装插件登录 ChatGPT 账号装好后可以在编辑器里直接自动修复代码、生成函数、重构代码写代码时不用来回切换窗口。七、进阶让 Codex 用上 DeepSeek 等第三方模型CC Switch官方 API 之外我们也可以通过 Coding Plan / Token Plan 套餐接入 DeepSeek、Kimi、GLM、Doubao、MiniMax 等主流大模型无需逐个购买 API。CC Switch 是一款免费开源的跨平台桌面工具可以在 Codex 等 AI 编程助手中一键切换第三方 API 提供商从而以更低的成本使用 AI 编程能力。本文基于 v3.16.0建议安装最新版。7.1 工作原理CC Switch 会在你本机启动一个本地代理服务把 Codex 发出的请求透明转发到你指定的后端比如 DeepSeek再把响应回传给 Codex。对 Codex 来说它以为自己仍在访问 OpenAI 官方接口实际上请求已经被转发到了第三方模型服务。7.2 前置条件条件说明已安装 Codex通过 https://openai.com/zh-Hans-CN/codex/ 下载安装有 API Key例如前往 platform.deepseek.com 注册获取 DeepSeek Key操作系统Windows 10、macOS 12 或主流 Linux 发行版7.3 安装 CC Switch安装包下载页https://github.com/farion1231/cc-switch/releases/latest拉到页面底部有各平台下载链接macOS推荐已公证brewinstall--caskcc-switchWindows下载.msi安装包双击安装。LinuxUbuntu / Debiansudodpkg-iCC-Switch-*.deb其他发行版可参考下表发行版推荐格式安装方式Ubuntu / Debian / Mint / Pop!_OS.debsudo dpkg -i CC-Switch-*.debFedora / RHEL / CentOS / Rocky.rpmsudo rpm -i CC-Switch-*.rpmopenSUSE.rpmsudo zypper install ./CC-Switch-*.rpmArch / Manjaro / 其他.AppImagechmod x CC-Switch-*.AppImage ./CC-Switch-*.AppImage7.4 添加 DeepSeek 提供商打开 CC Switch在顶部应用切换栏选择 Codex点击左侧Providers区域的 Add Provider在预设列表里搜索DeepSeek选中对应预设v3.16.0 已内置 DeepSeek V4 flash 和 pro 两个版本在下方表单中填入你的DeepSeek API Key其余字段保持默认勾选开启本地路由映射然后点击保存7.5 开启路由切换到 DeepSeek 后系统会提示开启路由点击左上角设置按钮进入「路由设置」菜单开启路由选择Codex之后重新打开 Codex就能看到 DeepSeek 的模型标志了。7.6 选 flash 还是 pro模型特点适用场景flash速度快、成本低日常代码补全、简单问答pro能力强支持推理内容复杂架构设计、多步推理在 CC Switch 的提供商编辑界面可以随时切换模型修改后立即生效无需重启 Codex。八、更新与卸载# 更新到最新版本codex--upgrade# 或者用 npm 更新 / 强制重装最新版npmupdate-gopenai/codexnpminstall-gopenai/codexlatest# 查看当前版本codex--version# 卸载npm 安装的npmuninstall-gopenai/codex# 卸载Homebrew 安装的brew uninstall--caskcodex九、平台支持情况系统支持情况macOS完整支持Linux完整支持Windows实验支持建议使用 WSL十、常见问题Q1切换提供商后 Codex 报连接错误确认 CC Switch 的 Local Routing 处于运行状态绿色图标。如果刚安装完可能需要重启终端让环境变量生效。Q2想恢复使用官方 OpenAI 端点在 CC Switch 中关闭 Local Routing 接管或切换回官方 OpenAI 提供商Codex 会自动使用原始配置。Q3CC Switch 会记录我的 API Key 吗CC Switch 是本地应用所有配置都存在本机API Key 不会上传到任何服务器。Q4安装 npm 包很慢或失败换国内镜像--registryhttps://registry.npmmirror.com。附录安装 Node.js仅 npm 方式需要Windows先安装 ChocolateyWindows 包管理工具powershell-cirm https://community.chocolatey.org/install.ps1 | iex重新打开一个终端再安装 Node.jschoco install nodejs--version24.15.0验证node-v npm-vLinux推荐使用 nvm# 安装 nvmNode.js 版本管理工具curl-o- https://raw.githubusercontent.com/nvm-sh/nvm/master/install.sh|bash# 无需重启终端直接加载配置source~/.nvm/nvm.sh# 安装 Node.js 24 并设为默认nvminstall24nvmaliasdefault24验证node-vnpm-v安装成功后你应该能看到类似输出v24.x.x 11.x.x小结只想体验用 Codex 应用下载登录即用长期写代码装 Codex CLI默认 Suggest 模式先试水熟悉后再放开权限Mac 用户怕麻烦brew install --cask codex想省钱用第三方模型CC Switch DeepSeekWindows 用户建议直接上 WSL踩坑最少装好之后最重要的不是配置而是多用。从一个真实的小需求开始比如「帮我给这个脚本加上异常处理」比看十篇教程都管用。