Codex Usage 图文使用教程

chxdon

Codex Usage 概览

Codex Usage 用来把 Codex CLI 的限额剩余百分比显示在 Ulanzi 设备按键上。常用视图是

1. 5H、周

复制代码

：上方显示较短窗口的剩余额度，下方显示周限额剩余额度。

1. 使用前准备
先确认本机已经安装 Codex CLI，并完成 Codex Auth 登录。插件会在本机调用

1. codex

复制代码

命令读取限额，不需要在插件里单独填写账号或 API Key。

在终端检查 Codex CLI：

1. codex --version

复制代码

登录 Codex Auth：

1. codex login

复制代码

确认登录状态：

1. codex login status

复制代码

如果

1. codex login status

复制代码

没有显示已登录，插件会提示

1. Run codex login

复制代码

。

2. 安装插件
在 Ulanzi Studio 中安装或导入

1. Codex Usage

复制代码

插件。插件加载成功后，可以在动作列表中看到

1. Codex Usage

复制代码

。

插件要求 Ulanzi Studio

1. 3.0.0

复制代码

或更新版本。

3. 添加到按键

D200X 显示效果

1. 打开 Ulanzi Studio 的设备配置页面。
2. 在插件动作列表中找到

1. Codex Usage

复制代码

。
3. 将动作拖到一个按键上。
4. 首次读取时可能短暂显示

1. LOAD

复制代码

。
5. 成功读取后，按键会显示 Codex 限额剩余百分比。

按下该按键可以立即刷新一次。自动刷新时，如果已经有旧数据，插件会静默刷新，不会反复显示

1. LOAD

复制代码

。

4. 配置项说明

配置项	推荐值	说明
Display	5H、周	同时显示短窗口和周窗口。也可以选择 仅 5H 或 仅周。
Refresh Minutes	3	自动刷新间隔，默认 3 分钟。
Warn Below %	25	剩余额度低于该百分比时进入警告颜色。
Critical Below %	10	剩余额度低于该百分比时进入危险颜色。

插件会自动查找

1. codex

复制代码

命令，常见来源包括

1. PATH

复制代码

、npm、npx、pnpm、fnm、nvm、Volta 和 Homebrew 安装位置。一般不需要手动配置命令路径。

5. 如何读取按键显示
按键上的信息从上到下读取：

显示内容	含义
CODEX	固定标题，表示当前按键是 Codex Usage。
左上圆点	当前限额状态。绿色正常，黄色警告，红色危险或错误。
5H 78%	短窗口剩余额度。这里表示 5 小时窗口还剩 78%。
W 42%	周窗口剩余额度。W 表示 Weekly，也就是周限额。
底部进度条	跟随主要显示项的剩余额度变化。
R 2h	距离当前主要窗口重置还剩约 2 小时。

实际窗口标签取决于 Codex CLI 返回的数据。常见标签包括：

-

1. 5H

复制代码

：5 小时窗口
-

1. D

复制代码

：日窗口
-

1. W

复制代码

：周窗口

6. 常见状态和处理方式

按键提示	说明	处理方式
LOAD	首次读取中。	等待几秒。已有数据后，后续刷新会静默进行。
Install Codex CLI	插件没有找到可用的 codex 命令。	安装 Codex CLI，并确认终端能运行 codex --version。
Run codex login	Codex CLI 尚未登录。	在终端运行 codex login，完成后再按键刷新。
ERR	读取失败。插件会先自动重试 3 次，仍失败才显示错误。	检查网络、Codex CLI 登录状态，或在终端运行 codex login status。

7. 推荐使用方式
日常建议使用默认配置：

-

1. Display

复制代码

:

1. 5H、周

复制代码

-

1. Refresh Minutes

复制代码

:

1. 3

复制代码

-

1. Warn Below %

复制代码

:

1. 25

复制代码

-

1. Critical Below %

复制代码

:

1. 10

复制代码

这样可以同时看到短窗口和周限额，按键颜色也能在额度偏低时给出明显提示。