Codex Micro
Codex 中文站说明： 本页围绕“Codex Micro”重新补充了中文使用场景和验证重点。界面名称可能随 Codex 版本更新，请以当前客户端为准。
你的 Codex 聊天控制中心。
Codex Micro 是 Codex 与 Work Louder 限量推出的联名产品。它可配合 ChatGPT 桌面 App 使用，让你无需离开键盘，就能快速查看和切换聊天、使用按住说话，以及触发常用操作或 skill。
Work Louder · OpenAI 2026 + Thinking + Complete + Idle + Requires input + Error + No assigned chat ϟ Fast mode ✓ Approve × Decline ⑂ Continue in a new chat ◉Push to talk ⌁Send
设置 Codex Micro
- 打开 ChatGPT 桌面 App。
- 通过 USB-C 线缆或蓝牙将 Codex Micro 连接到电脑，然后按照 ChatGPT 检测到设备时显示的设置流程操作。
- 在 macOS 上，根据提示允许 Input Monitoring（输入监控），以便 ChatGPT 响应按键操作。
- 打开 Settings > Codex Micro，选择 Agent Keys 要跟踪的聊天，为 Command Keys 和模拟摇杆方向分配操作，并调整灯光。
若要再次打开这些设置，请按住旋钮 500 毫秒，或选择 ChatGPT 底部帐户名称旁的 Codex Micro 图标。
ChatGPT 首次检测到设备后，Settings 中会出现 Codex Micro。如果你想在 ChatGPT 之外使用该设备，可以通过 Work Louder Input 自定义这些控制项。
使用 Agent Keys 查看和切换聊天
六枚磨砂 Agent Keys 均可跟踪一条聊天，并通过灯光显示当前状态。按一次 Agent Key 可切换到对应聊天，但不会把 ChatGPT 窗口带到前台；在 350 毫秒内连按两次，则会切换聊天并把 ChatGPT 窗口带到前台。
| 灯光 | 状态 | 含义 |
|---|---|---|
| 白色 | Idle | 聊天空闲。 |
| 蓝色 | Thinking | ChatGPT 正在工作。 |
| 绿色 | Complete | 聊天已完成，并有未读更新。 |
| 琥珀色 | Requires input | ChatGPT 需要你的审批或回复。 |
| 红色 | Error | 出现错误。 |
| 熄灭 | No assigned chat | 该按键未跟踪聊天。 |
所选聊天对应的按键会按照其状态灯光脉动。
默认情况下，这些按键会跟踪最近更新的六条聊天，无论它们是否已置顶。你可以在 Settings > Codex Micro 中更改 Agent source，采用不同的排列方式：
- Most recent chats：跟踪最近更新的六条聊天，无论是否已置顶。
- Pinned chats：跟踪 Pinned 中的前六条聊天。
- Priority chats：优先排列等待输入、未读和活动中的聊天。
- Custom assignments：选择分配给每枚 Agent Key 的聊天。按下未分配的 Agent Key 会打开新聊天；开始聊天后，ChatGPT 会把它分配给该按键。
状态颜色保持不变。你可以决定 Agent Keys 跟踪哪些聊天，但不能把它们改成额外的 Command Keys。
使用和自定义 Command Keys
Codex Micro 的默认布局包含六项操作：
| 按键 | 默认操作 |
|---|---|
| Fast keycap | 开启或关闭 Fast mode。 |
| Approve keycap | 批准当前 request。 |
| Decline keycap | 拒绝当前 request。 |
| Fork keycap | 在新聊天中继续当前聊天。 |
| Mic keycap | 开始按住说话。 |
| Codex keycap | 发送编辑器中的消息。 |
Mic 键使用电脑的麦克风；Codex Micro 本身没有麦克风。按住按键说话，松开即可停止。若要免手持录音，请在 350 毫秒内连按两次以继续录音，再按一次停止。
录音期间，海绿色灯光会沿键盘移动。ChatGPT 处理语音时，灯光会变为移动的白光；提示词准备好后则变为常亮白光。按 Codex 键即可发送。
在 Settings > Codex Micro 中选择一枚 Command Key，然后选择其 keycap 和操作。你可以打开浏览器或终端、评审变更、用 Git 提交、创建 PR、附加文件或照片、管理定时任务、更改推理强度，或打开 Skills。如果选择了已在其它位置使用的 keycap，ChatGPT 会交换两者，而不会重复使用同一 keycap。
重新映射按键后，请更换实体 keycap，使其与新操作保持一致。
使用模拟摇杆和旋钮
模拟摇杆可以向任意方向自由移动。推离中心足够远时，ChatGPT 会把移动转换为四个方向操作之一。Codex Micro 的默认映射如下。
你可以在 Settings > Codex Micro 中，为每个方向选择任何可用的 ChatGPT 桌面命令或已启用的 skill。
| 方向 | 默认操作 |
|---|---|
| 上 | 开启或关闭计划模式。 |
| 右 | 在 App 历史记录中前进。 |
| 下 | 显示或隐藏侧边栏。 |
| 左 | 在 App 历史记录中后退。 |
旋钮用于在编辑器控件和选项之间移动，默认选中 Reasoning。转动旋钮更改所选项目，再按下旋钮打开或选择当前控件。编辑器控件或菜单打开时，旋钮右侧紧邻的 Agent Key 会亮起红灯；按下该键可取消。
在 Settings > Codex Micro 中，可以选择旋钮使用 Composer navigation 还是 Reasoning only。在 Reasoning only 模式下，转动旋钮会打开并调整推理强度；按下旋钮可打开滑块或其高级选项。
调整灯光
在 Settings > Codex Micro 中调整亮度，并选择闲置时灯光保持多长时间。使用键盘或 Agent Key 状态变化时，灯光会重新亮起。默认情况下，灯光会在三分钟后关闭。
当键盘上报电池状态时，你可以在 Settings > Codex Micro 以及 Codex Micro 图标的侧边栏提示中查看。
添加更多 layer
Codex 使用 layer 1。通过 Work Louder Input，还可配置最多五个 layer，为其它 App 设置快捷键和操作。
Codex Micro 故障排查
重新配对键盘
使用左下角触控区重新开始配对。背部按钮只控制电源，不会开始配对。
- 按住左下角触控区三秒，进入通信模式。
- 轻触该区域，选择蓝牙通道 1、2 或 3。
- 在所选通道上按住三秒。配对时通道灯会闪烁，配对完成后保持常亮。
修复 macOS 上的 Input Monitoring
如果 Settings > Codex Micro 显示 Input Monitoring 尚未设置，请选择 Open System Settings，然后执行以下步骤：
- 打开 System Settings > Privacy & Security > Input Monitoring。
- 如果列表中已有 ChatGPT，请为其开启访问权限。如果没有，请把 Applications 中的 ChatGPT 拖入列表，或选择 Add (+) 并选择 ChatGPT。
- 退出并重新打开 ChatGPT，然后确认 ChatGPT 能在 layer 1 检测到 Codex Micro。
有关此 macOS 权限的更多信息，请参阅 Apple 的 Input Monitoring 指南。
获取更多 Work Louder 帮助
如果需要蓝牙、线缆、电源或重置键盘方面的帮助，请参阅 Work Louder 的 Creator Micro 2 设置指南。如需直接支持，请发送邮件至 hello@worklouder.cc。
获取 Codex Micro
在有库存期间，你可以通过 OpenAI Supply Co 购买 Codex Micro。
订单预计会在购买后不久开始发货。
本站实践建议
阅读“Codex Micro”时，建议先在非生产项目中走完一次完整流程，并记录实际界面、命令输出和验证结果。产品更新后，可据此快速判断哪些步骤需要调整。
Codex API 与国内使用
在实践“Codex Micro”相关功能时，如需为 Codex 配置 OpenAI-compatible API，可以前往 APIBest 获取 API Key。第三方服务的模型映射、价格、额度和数据处理方式以 APIBest 当前说明为准。