CodeX 笔记 🔨

约 625 字大约 2 分钟

2025-12-18

Codex CLI 是一个在终端里直接用的 AI 编程助手

npm install -g @openai/codex

安装完成后验证：

codex --help

codex auth login

常用参数

--yes（自动应用修改）

--dry-run（只看不改）

配置文件位置

Win ：

C:\Users\<你的用户名>\.codex

终端代理

setx HTTP_PROXY http://127.0.0.1:7890
setx HTTPS_PROXY http://127.0.0.1:7890

通知

在 Windows 10 上运行 Codex CLI 时，任务通常在终端中执行，完成后没有明显提示。当任务耗时较长（如代码重构、分析仓库）时，很容易错过完成时机。通过 PowerShell 的通知能力，可以在 Codex 任务结束后触发 Windows 系统级 Toast 通知（右下角通知中心）。

Codex CLI 支持在任务结束时触发 notify 钩子
notify 本质是执行一个外部命令或脚本
PowerShell 可通过第三方模块 BurntToast 发送 Windows Toast 通知
组合方式类似：npm i 安装依赖，代码中 require / import 使用依赖

PowerShell 的 Module 等价于：

Node.js 的 npm 包
Python 的 pip 包

特点：

模块通过 Install-Module 安装
模块通过 Import-Module 加载
模块向 PowerShell 暴露函数（命令）

BurntToast 模块提供的核心函数是：New-BurntToastNotification

安装 BurntToast 模块

在 PowerShell 中执行以下命令：

Set-ExecutionPolicy -Scope CurrentUser RemoteSigned -Force
Install-Module BurntToast -Scope CurrentUser -Force

说明：

ExecutionPolicy 用于允许当前用户执行本地脚本
CurrentUser 不影响系统其他用户
BurntToast 是 Windows Toast 通知的事实标准模块

验证系统通知是否可用

在 PowerShell 中手动执行测试命令：

Import-Module BurntToast
New-BurntToastNotification -Text "Codex", "任务已完成 🎉"

验证结果：

右下角弹出 Windows 通知 → 系统环境正常
无通知 → 检查 Windows 通知设置或专注助手（Focus Assist）

Codex 通知脚本设计

Codex 不直接发通知，而是调用一个脚本。该脚本负责发送通知。

创建通知脚本

路径建议固定为：

C:\Users\<用户名>\.codex\notify.ps1

脚本内容：

Import-Module BurntToast
New-BurntToastNotification -Text "Codex", "任务已完成 🎉"

说明：

每次 Codex 任务结束都会执行此脚本
可自由修改通知内容或逻辑

配置 Codex notify 钩子

编辑 Codex 配置文件：

C:\Users\<用户名>\.codex\config.toml

添加或修改：

notify = [
  "powershell",
  "-NoProfile",
  "-ExecutionPolicy",
  "Bypass",
  "-File",
  "C:\\Users\\<用户名>\\.codex\\notify.ps1"
]

配置说明：

-NoProfile 避免加载用户 PowerShell 配置导致不确定行为
Bypass 防止脚本执行被策略拦截
路径必须使用双反斜杠