中文 | English
你的 Codex 还可以跑多久？
Codex Runway 是一个原生 macOS 状态栏应用，帮你在菜单栏里随时掌握 Codex 的剩余额度、重置次数、使用成本和本机会话状态。它面向日常高频使用 Codex 的用户：少打开网页，少猜额度，少错过重置时间。
- 一眼看到 Codex 还能跑多久，适合长任务和连续开发场景。
- 同时关注 5 小时、每周和附加额度，提前发现额度紧张。
- 自动识别当前 Codex 账号和订阅类型，减少多账号混淆。
- 追踪 reset credits 的可用数量和到期风险，避免可用重置次数被浪费。
- 将本周期 Codex 用量换算成 API 等价成本，帮助理解实际使用强度。
- 修复本机会话索引，让 Codex 会话列表恢复一致。
- 原生 macOS 菜单栏体验，支持浅色、深色、跟随系统和中英文界面。
- 内置更新检测，保持应用持续可用。
从 GitHub Release 下载与你的 Mac 匹配的压缩包：
- Apple Silicon：
CodexRunway-macos-arm64.zip - Intel：
CodexRunway-macos-x86_64.zip
解压后把 CodexRunway.app 放到 Applications 或任意目录运行。
当前 Release 是 ad-hoc signed，未 notarized。首次打开如果提示“无法验证开发者”或“未经安全验证”，请右键点击 CodexRunway.app，选择“打开”，或在“系统设置 > 隐私与安全性”中点击“仍要打开”。
如果提示“CodexRunway.app 已损坏，无法打开。您应该将它移到废纸篓”，通常是下载隔离属性导致的。把 app 放入 Applications 后运行：
xattr -dr com.apple.quarantine /Applications/CodexRunway.app然后再次打开应用。
- macOS 12+
- 已登录过 Codex
- 本机存在
~/.codex/auth.json
swift run CodexRunway自检命令：
swift run CodexRunway --self-check自检会输出本地诊断信息，token 会被 redacted。
- token 只从本机
~/.codex/auth.json读取。 - access token、refresh token、id token 不会写入日志、README、issue 模板或自检输出。
- API 等价成本默认来自本机会话 JSONL 日志，不上传会话内容。
- 在线用量数据只在本地没有可用 token 数据时作为补全来源。
- 会话修复只处理
~/.codex/session_index.jsonl，写入前会创建备份，不删除会话文件。 - 更新检测只访问版本信息，不上传 Codex 账号或会话数据。
swift test
swift build
swift build -c release贡献说明见 CONTRIBUTORS.md。
本项目遵循仓库中的 LICENSE。