Codex 配置

Codex 是 OpenAI 官方的 CLI 工具,由原 codex-cli 重命名而来，内置 GPT-5 系列模型，在写作、代码、工具调用这类任务上和 Claude Code 能力接近。

Flowix Memo 把 Codex 当作一个外挂 Agent -- 接入后，你在文档光标位置就能直接调用它，不用切换终端，不用复制上下文，也不用手动管理历史对话。Codex 默认支持 ChatGPT Plus / Pro 订阅登录(走订阅额度，免 API 费用)，也可以改用 OpenAI API key 单独计费。同一个文档可以同时放多张 Codex 卡片，每张独立追踪自己的对话流。

1. 安装 Codex

前提条件：

• 您需要安装 Node.js 20 或更新版本环境
• macOS 用户推荐使用 nvm 方式安装 Node.js 或 Homebrew 方式（brew install node）。不推荐直接安装包安装(后续可能会遇到权限问题)
• Windows 用户还需安装 Git for Windows

进入命令行界面，安装 Codex：

npm install -g @openai/codex

升级到最新版本：

npm install -g @openai/codex@latest

注意：macOS 用户若在安装过程中遇到权限问题，请使用 nvm 方式安装 Node.js。安装成功后，还需下方「二、如何在 Flowix Memo 使用 Codex」完成接入，先不要直接使用 codex 命令启动(可能由于网络或地区限制无法使用)。

1.1 macOS

第一步：安装 Node.js 20+

brew install node

第二步：全局装 Codex CLI

npm install -g @openai/codex

1. 验证安装：codex --version，输出版本号说明 CLI OK
2. 升级（可选）：npm install -g @openai/codex@latest
3. 全链路验证：在终端跑 codex "说一句 hello"，能正常回应说明 CLI + 登录 + PATH 都通了。

1.2 windows 11

1. 装 Node.js 20+：到 nodejs.org 装 LTS 版本，安装时勾选 Add to PATH
2. 装 Git for Windows
3. 全局装 CLI：用 管理员 PowerShell 执行 npm install -g @openai/codex
4. 验证安装：codex --version，输出版本号说明 CLI OK
5. 升级（可选）：npm install -g @openai/codex@latest
6. 全链路验证：新开一个终端 跑 codex "说一句 hello"，能正常回应说明 CLI + 登录 + PATH 都通了。

2. 如何在 Flowix Memo 使用 Codex

CLI 装好之后，Flowix Memo 自动检测识别，无需额外配置。登录方式在 设置 > AI > Codex 里二选一：

• ChatGPT Plus / Pro 订阅登录 -- 点「ChatGPT 登录」按钮，浏览器授权 ChatGPT 账号，自动走订阅额度，写满一篇 3000 字文档大概几分钱订阅费都覆盖不到
• OpenAI API key -- 在表单粘 sk-...，等价于写 ~/.codex/.env，按 token 计费

登录完成后用 / 命令插入 Codex 卡片，跟 Claude Code 同一套 UI 习惯。

2.1 通过命令插入 Agent 卡片

在文档任意位置输入 / 弹出 Agent 类型菜单，选 Codex，系统会插入一张可拖拽的 Agent 卡片。

2.2 AI Agent 对话

文档光标位置就能直接调用它，不用切换终端，不用复制上下文，也不用手动管理历史对话。Codex 自带 codex 前缀 bash 模式，可在 设置 > AI > Codex > 启用 Bash 模式 里打开，直接跑 shell 命令。