当前位置：首页 > news >正文

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

news 2026/6/30 3:50:08

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+。

系统	额外依赖
Windows	Git Bash(推荐,后面脚本/路径更友好)
Mac	Homebrew(可选,装 Node.js 更方便)
Linux	curl / wget(系统基本都自带)

二、Windows 平台安装

1. 安装 Git Bash(前置步骤)

去 Git 官网下载对应你系统的版本,一路「下一步」装完即可。

2. 安装 Node.js

去 Node.js 官网下载最新的 LTS 版本,默认安装。

装完打开 CMD,跑一下验证:

node-vnpm-v

3. 安装 Codex CLI

打开 CMD 或 PowerShell,执行:

npminstall-g@openai/codex

4. 配置 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.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 = "responses"

把sk-xxx替换成你自己生成的 key
model_reasoning_effort可选high/medium/low,代表模型的思考强度
wire_api = "responses"这一行不能漏,Codex CLI 走的是 OpenAI Responses 接口,不是 chat/completions

5. 启动 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.jsbrewinstallnode

2. 安装 Codex CLI

npminstall-g@openai/codex

3. 配置 API

3.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 = "responses"

4. 启动 & 装 VSCode 插件

重启终端!然后:

codex

VSCode 插件同 Windows,扩展商店搜codex装上即可。

四、Linux 平台安装

1. 安装 Node.js

Ubuntu / Debian

sudoaptupdatecurl-fsSLhttps://deb.nodesource.com/setup_lts.x|sudo-Ebash-sudoapt-getinstall-ynodejs

CentOS / RHEL / Fedora

sudodnfinstallnodejsnpm# 或sudoyuminstallnodejsnpm

Arch Linux

sudopacman-Snodejsnpm