Codex CLI 保姆级安装与配置教程（Windows / Mac / Linux 全平台 + VSCode 集成）

Codex CLI 保姆级安装与配置教程Windows / Mac / Linux 全平台 VSCode 集成一篇搞定 OpenAI 推出的命令行 AI 编程助手 Codex CLI 的全流程,从装环境到跑起来,再到接入 VSCode 插件。前言最近 OpenAI 把Codex CLI开源后,直接在终端里用自然语言改代码、跑命令、查文档,体验比 IDE 插件更自由,被不少开发者称为命令行里的 Cursor。但 Codex CLI 默认绑定的是 OpenAI 官方的 ChatGPT Plus / Pro / Team / Enterprise 订阅账号,国内直连也有门槛。这篇教程会带你从零搞定三件事:在Windows / Mac / Linux任意平台装好 Codex CLI配好 API,跑通第一个任务把它接到 VSCode 里,像插件一样用读完本文你能…三平台全流程安装 Codex CLI用 API Key(非订阅账号)驱动 Codex把 Codex 集成到 VSCode自己排查常见的报错一、准备工作Codex CLI 本质上是一个 Node.js 包,所以系统得先有Node.js 18。系统额外依赖WindowsGit Bash(推荐,后面脚本/路径更友好)MacHomebrew(可选,装 Node.js 更方便)Linuxcurl / wget(系统基本都自带)二、Windows 平台安装1. 安装 Git Bash(前置步骤)去 Git 官网 下载对应你系统的版本,一路「下一步」装完即可。2. 安装 Node.js去 Node.js 官网 下载最新的 LTS 版本,默认安装。装完打开 CMD,跑一下验证:node-vnpm-v3. 安装 Codex CLI打开 CMD 或 PowerShell,执行:npminstall-gopenai/codex4. 配置 API(重点)Codex CLI 默认是连 OpenAI 官方的 ChatGPT 订阅账号。如果你没买 Plus / Pro 订阅,或者想要更灵活、不挑节点的接入方式,可以用API Key 兼容 OpenAI 接口的中转服务来跑,效果一致,门槛低很多。4.1 获取 API Key操作步骤:注册并登录进入「令牌」页面分组一定要选「codex 专属」(Windows 用户的专属分组,选错会调不通)额度选择「无限额度」,不要限制模型点创建,把生成的sk-xxx复制下来4.2 创建配置文件进入C:\Users\你的用户名\.codex目录(没有就手动建一个,记得在文件资源管理器里打开「显示隐藏的项目」),新建两个文件:auth.json{OPENAI_API_KEY:sk-xxx}config.tomlmodel_provider api111 model gpt-5-codex model_reasoning_effort high disable_response_storage true preferred_auth_method apikey [model_providers.api111] name api111 base_url https://selltoken.top/v1 wire_api responses把sk-xxx替换成你自己生成的 keymodel_reasoning_effort可选high/medium/low,代表模型的思考强度wire_api responses这一行不能漏,Codex CLI 走的是 OpenAI Responses 接口,不是 chat/completions5. 启动 Codex重启终端!重启终端!重启终端!(重要的事说三遍)然后进入你的工程目录,运行:codex第一次会提示确认,敲回车即可。顺利的话就能看到 Codex 的欢迎界面,接下来用自然语言跟它交互就行。6. 装 VSCode 插件打开 VSCode → 扩展商店,搜索codex安装。装完后会出现在侧边栏,点和终端里的 Codex 用同一份配置,所以能跑通就都能跑通。三、Mac 平台安装1. 安装 Node.js方式一:官网下载安装包方式二(推荐):Homebrew# 装 Homebrew(已装可跳过)/bin/bash-c$(curl-fsSLhttps://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)# 装 Node.jsbrewinstallnode2. 安装 Codex CLInpminstall-gopenai/codex3. 配置 API3.1 获取 API Key去 selltoken.top 注册并登录,令牌分组选择「codex 特供」(Mac 用户的专属分组)。3.2 创建配置文件mkdir-p~/.codextouch~/.codex/auth.jsontouch~/.codex/config.toml编辑auth.json(用vim或你习惯的编辑器,按i进入插入模式,粘完按Esc:wq保存):{OPENAI_API_KEY:sk-xxx}编辑config.toml:model_provider api111 model gpt-5-codex model_reasoning_effort high disable_response_storage true preferred_auth_method apikey [model_providers.api111] name api111 base_url https://selltoken.top/v1 wire_api responses4. 启动 装 VSCode 插件重启终端!然后:codexVSCode 插件同 Windows,扩展商店搜codex装上即可。四、Linux 平台安装1. 安装 Node.jsUbuntu / Debiansudoaptupdatecurl-fsSLhttps://deb.nodesource.com/setup_lts.x|sudo-Ebash-sudoapt-getinstall-ynodejsCentOS / RHEL / Fedorasudodnfinstallnodejsnpm# 或sudoyuminstallnodejsnpmArch Linuxsudopacman-Snodejsnpm2. 安装 Codex CLIsudonpminstall-gopenai/codex3. 配置 API3.1 获取 API Key去 selltoken.top,分组选「codex 渠道-gpt」(Linux 用户专属)。3.2 创建配置文件mkdir-p~/.codextouch~/.codex/auth.jsontouch~/.codex/config.tomlauth.json{OPENAI_API_KEY:sk-xxx}config.tomlmodel_provider api111 model gpt-5-codex model_reasoning_effort high disable_response_storage true preferred_auth_method apikey [model_providers.api111] name api111 base_url https://selltoken.top/v1 wire_api responses4. 启动重启终端!然后:codexVSCode 插件同上,扩展商店搜codex即可。五、常见问题 FAQQ1:启动报 401 / 403 怎么办?检查auth.json里的 key 有没有复制错(开头结尾别带空格)去 selltoken 后台确认 key 状态是否启用确认分组是否选对:Windows 选「codex 专属」、Mac 选「codex 特供」、Linux 选「codex 渠道-gpt」,分组选错会直接调不通Q2:报 model not found?config.toml里model字段必须是 selltoken 后台实际开通的模型重点检查wire_api responses这一行没漏——Codex CLI 走的是 OpenAI Responses 端点,不是 chat/completionsQ3:运行到一半 timeout?试试把model_reasoning_effort调成medium或low,高强度思考更费时检查 selltoken 后台额度是否充足Q4:VSCode 插件连不上,但 CLI 没问题?VSCode 插件和 CLI 读的是同一份配置(~/.codex/或C:\Users\xxx\.codex\),所以 CLI 能用插件就一定能用装完插件后重启 VSCodeQ5:Mac 上codex命令找不到?全局 npm 包的路径没加到 PATH。先npm config get prefix看一下,把输出的bin目录加到~/.zshrc或~/.bash_profile里source一下即可或者临时用npx openai/codex跑Q6:Windows 上配置文件路径找不到?C:\Users\你的用户名\.codex\是隐藏目录,先在文件资源管理器 → 查看 → 勾选「显示隐藏的项目」六、写在最后OK,到这里三平台的安装配置就讲完了。Codex CLI 真正上手用一段时间你会发现,它在改 bug、查文档、写一次性脚本这些「小而碎」的任务上特别趁手——比 IDE 插件更自由,比 ChatGPT 网页版更贴近代码,中间不用切窗口,效率提升是真的有感。如果本文对你有帮助,点赞、收藏就是最大的支持 评论区遇到问题随时留言,看到都会回。下一篇准备写 Codex CLI 的进阶用法(自定义指令、上下文压缩、配合 git worktree 干大事),有想看的内容也可以评论区提~