# Codex 安装教程：macOS、Windows、CLI 与 VS Code

> 在 macOS 和 Windows 安装 OpenAI Codex CLI、桌面端或官方 VS Code 扩展，随后用 Passion8 地址、API Key 和可用模型接入。

URL: https://docs.passion8.cc/docs/codex/install
Language: zh-CN
Publisher: Passion8
Last updated: 2026-10-11

**本地 Codex 接入 Passion8 的顺序是：安装 → 配置本站地址、API Key 和可用 Responses 模型 → 重启 → 验证请求**，无需 OpenAI 账号或浏览器 OAuth。主要在 VS Code、Cursor 或 Windsurf 里工作时，可直接看 [Codex 官方扩展安装与配置](https://docs.passion8.cc/docs/codex/ide)，不必先装独立 CLI。

Codex 有三种常用入口:

| 入口 | 用途 |
| --- | --- |
| Codex CLI | 终端运行 agent,开发和仓库任务 |
| Codex 桌面端 | 图形界面管理项目、会话和 diff |
| 官方 IDE 插件 | VS Code、Cursor、Windsurf、JetBrains 集成 |

安装完成后,如果要接入 Passion8,继续看 [配置](https://docs.passion8.cc/docs/codex/config)。

## 安装 Codex CLI

Codex CLI 通过 npm 发布,需要 Node.js LTS。






### macOS


### 1. 安装 Node.js LTS

```bash
brew install node
node -v
npm -v
```

无 Homebrew 可从 [nodejs.org](https://nodejs.org/) 下载 LTS。Homebrew 的未指定版本 node 包可能跟随 Current,请核对安装版本。

### 2. 安装 Codex CLI

```bash
npm install -g @openai/codex
codex --version
```





### Windows


### 1. 安装 Node.js LTS

```powershell
winget install OpenJS.NodeJS.LTS
node -v
npm -v
```

无 winget 可从 [nodejs.org](https://nodejs.org/) 下载。安装后重新打开 PowerShell;若 .ps1 包装器被执行策略阻止,使用 npm.cmd / codex.cmd。

### 2. 安装 Codex CLI

```powershell
npm install -g @openai/codex
codex --version
```











安装后若 `codex` 找不到,新开终端或 PowerShell 窗口,确认 npm 全局目录已进入 `PATH`。







CLI 安装只负责让 `codex` 命令可用。Passion8 的 Base URL 和 API Key 在 [配置](https://docs.passion8.cc/docs/codex/config) 里设置。




## 安装 Codex 桌面端

下载地址:[下载 Codex App](https://chatgpt.com/codex/download)






### macOS








完成安装后,从 Applications 或启动台打开 Codex。






打开本地项目文件夹。首次使用建议先选择默认权限,确认工作流后再提高权限级别。










### Windows








运行安装包或用:

```powershell
winget install Codex -s msstore
```






从开始菜单打开 Codex。






打开本地项目文件夹。首次使用建议先选择默认权限,确认工作流后再提高权限级别。
















桌面端接入 Passion8 时,Base URL 也填 `https://passion8.cc/v1`,**带** `/v1`。Key 使用你在 Passion8 创建的 API Key。





## 安装官方 IDE 插件

在 VS Code、Cursor、Windsurf 或 JetBrains 编辑器里安装 OpenAI 官方 Codex 插件。






### VS Code / Cursor / Windsurf








打开扩展市场,macOS 按 `Cmd+Shift+X`,Windows 按 `Ctrl+Shift+X`。






搜索 **Codex**,安装 OpenAI 官方发布的插件。






安装后重启编辑器,在侧边栏或命令面板里打开 Codex。










### JetBrains








在 IntelliJ IDEA、PyCharm、WebStorm、Rider 等 IDE 里打开 Plugins。






搜索并安装 OpenAI 官方 Codex 插件。






安装后重启编辑器,在侧边栏或命令面板里打开 Codex。
















IDE 插件通常沿用本机 Codex 配置。使用 Passion8 前,先完成 [配置](https://docs.passion8.cc/docs/codex/config),确保 `auth.json` 和 `config.toml` 已写好。




## 下一步



- [配置 Passion8](https://docs.passion8.cc/docs/codex/config): 写入 auth.json/config.toml,或用 CC-Switch 配置。
- [桌面端玩法](https://docs.passion8.cc/docs/codex/app): 了解桌面端的项目、权限、diff 和多 agent 工作流。
- [IDE 使用](https://docs.passion8.cc/docs/codex/ide): 在编辑器侧边栏使用 Codex。