Codex

安装教程

在 macOS 和 Windows 上安装 Codex CLI、Codex 桌面端和 OpenAI 官方 IDE 插件。

Codex 有三种常用入口:

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

安装完成后,如果要接入 Passion8,继续看配置。

#安装 Codex CLI

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

brew install node
node -v
npm -v

无 Homebrew 可从 nodejs.org 下载。

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

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

无 winget 可从 nodejs.org 下载。

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

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

CLI 安装只负责让 codex 命令可用。Passion8 的 Base URL 和 API Key 在配置里设置。

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

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

运行安装包或用:

winget install Codex -s msstore

从开始菜单打开 Codex。

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

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

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

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

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

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

IDE 插件通常沿用本机 Codex 配置。使用 Passion8 前,先完成配置,确保 auth.json 和 config.toml 已写好。

Support / 支持

接入、计费与模型异常可邮件联系；服务可用性以状态页为准。
For setup, billing, or model issues, email us. Check the status page for uptime.

也可使用右下角微信 / QQ 客服 · WeChat / QQ support is available at the bottom right