别再盲目等 AI 了:这个工具让你的 ClaudeCode 和 Codex CLI 状态一目了然

作者：AICoder 项目地址：github.com/kaelinda/AICodingStatusLine

痛点：你是不是也在”盲开”ClaudeCode/Codex？

用 Claude Code 或 Codex CLI 写代码的时候，你有没有遇到过这些问题：

• 额度用了多少？5 小时限额还剩多少、周额度还够不够？完全不知道，只能等到被限速了才后知后觉。
• 上下文炸了没？聊到第 30 轮，突然发现模型开始”失忆”——因为 context window 早就满了，你一点提示都没收到。
• 现在跑的是哪个模型？Opus 还是 Sonnet？推理努力等级是 high 还是 low？切了半天，回头一看记不清了。
• Git 分支对不对？写了半天代码才发现还在 main 上，忘了切分支。

这些信息本来就应该随时可见，但原生工具都不提供。

AICodingStatusLine就是为了解决这个问题而生的——它给你的 AI 编程工具加上一条实时状态栏，所有关键信息一行搞定。

AICodingStatusLine 是什么？

简单来说，它是一个命令行状态栏增强工具，支持两种 AI 编程工具：

• Claude Code：通过原生 statusLine.commandhook 驱动，无缝集成在 Claude Code 底部。
• Codex CLI：因为 Codex 没有原生扩展点，它通过 tmux 包装层在终端底部生成状态栏。

一行状态栏里能看到什么？模型名称、推理努力等级、Git 分支（含增删统计）、context 使用率、5 小时限额、7 天限额，以及额外用量——全部实时更新。

五大亮点

1. 额度预警，告别”突然限速”

这是最实用的功能。状态栏实时显示 5h 和 7d（weekly）两档额度的使用百分比，配合颜色编码——绿色安全、黄色警告、红色危险——你可以随时调整使用节奏，不会再被突如其来的限速打断工作流。

2. Context 使用率可视化

大模型的 context window 是有限的。当你在一次长对话里不断追加内容，context 占用越来越高，模型表现就会开始下降。状态栏直接把使用率摆在眼前，该开新对话的时候你心里有数。

3. 9 种主题 + 7 种进度条样式，颜值在线

内置 9 种配色主题（dracula、monokai、solarized 等经典方案全都有），7 种进度条字符样式（点、方块、盲文字符等），还支持自定义字符。不管你的终端是深色还是浅色背景，总有一款合你审美。

4. 终端宽度自适应

窗口变窄了？状态栏不会直接截断乱掉，而是按优先级逐步隐藏次要信息——先去掉 extra 段、再隐藏 reset 时间、最后压缩 Git 信息。始终保证最关键的数据可见。

5. /statuslineSkill：对话式管理配置

在 Claude Code 里直接输入 /statusline theme dracula就能切主题，输入 /statusline preview能看到 ANSI 色块预览，完全不需要手动编辑 JSON 文件。还支持模糊匹配——输入 drac就能匹配到 dracula。

小白安装指南（5 分钟搞定）

前置条件

• 一台安装了 Git的电脑（macOS / Linux / WSL）
• 已经在用 Claude Code或 Codex CLI（至少其一）
• 如果要用 Codex 状态栏，需要安装 tmux（brew install tmux或 apt install tmux）

第一步：克隆仓库

打开终端，执行：

git clone https://github.com/kaelinda/AICodingStatusLine.gitcd AICodingStatusLine

第二步：运行安装脚本

根据你用的工具选一条命令执行：

# 只用 Claude Code./install.sh# 只用 Codex CLI./install.sh --target codex# 两个都装./install.sh --target both

安装时还能直接指定主题和样式，一步到位：

./install.sh --target both --theme dracula --layout bars --bar-style dots

装完就生效了，打开 Claude Code 或 Codex CLI 就能看到状态栏。

第三步（可选）：调整配置

Claude Code 用户：在对话里输入 /statusline即可交互式管理所有配置。

Codex CLI 用户：编辑 ~/.codex/config.toml：

[statusline]theme = "dracula"layout = "bars"bar_style = "blocks"show_git_line = trueshow_overview_line = true

卸载

不想用了？一条命令干净卸载：

./install.sh --uninstall

布局选择：compact vs bars

工具提供两种布局模式，适合不同偏好：

compact（默认）：所有信息挤在一行，适合不想占太多屏幕空间的用户。看起来像这样：

Opus 4.6 │ high │ main(+3 -1) │ ctx 42% │ 5h 8% │ 7d 19%

bars：多行布局，每个额度单独一行，配上可视化进度条，信息量更大也更直观。进度条有多种字符风格可选：

[●●●●○○○○○○] 5h   8%[●●●●●●●○○○] 7d  19%

常见问题速查

Q：状态栏显示 5h -/ 7d -怎么办？

Claude Code 需要使用 OAuth 认证（Pro/Max 订阅），API key 模式不支持用量查询。Codex CLI 则需要至少运行过一次对话，让 ~/.codex/sessions/下生成 .jsonl文件。

Q：进度条在 Windows 上显示乱码？

切换到默认的 ascii风格即可解决（[===-------]这种），它不依赖 Unicode 字符。

Q：终端太窄，信息被砍了？

这是宽度自适应的正常行为。加宽终端窗口，或者通过 MAX_WIDTH环境变量手动设置更大的宽度预算。

写在最后

AICodingStatusLine 解决的是一个很小但很实际的问题：让你在用 AI 编程的时候，不再信息盲区里裸奔。额度、上下文、模型、分支——这些信息你迟早要查，不如让它们一直待在眼前。

项目完全开源、MIT 协议，安装只要 5 分钟。如果你也在日常使用 Claude Code 或 Codex CLI，推荐试一试。

觉得有用的话，去 GitHub 点个 ⭐ 支持一下吧。

本项目 fork 自 daniel3303/ClaudeCodeStatusLine，在原作基础上扩展了主题系统、多布局、进度条样式、Codex CLI 支持和 /statuslineSkill。感谢原作者 Daniel Oliveira 的工作。