# Claude Code Statusline 配置 (/docs/claude-code-statusline)



<figure>
  ![Claude Code Statusline](https://r2.unono.app/2026/05/62fda09f14f10c727bfdf1644cc89121.png)
  <figcaption>自定义状态栏效果</figcaption>
</figure>

Claude Code 支持用自定义脚本接管底部状态栏。这个脚本会显示两行信息：

* **第一行**：项目目录、Git 分支、ahead/behind、文件变更统计
* **第二行**：模型、费用、cache 命中率、session token 累计、上下文窗口占比（附告警）

***

## 安装 [#安装]

下载脚本到 `~/.claude/`：

```bash
curl -o ~/.claude/statusline.py \
  https://gist.githubusercontent.com/OiAnthony/38d6882a2d687814b059a391b03e87d4/raw/statusline.py
```

在 `~/.claude/settings.json` 中添加配置：

```json
{
  "statusLine": {
    "type": "command",
    "command": "python3 ~/.claude/statusline.py",
  }
}
```

重启 Claude Code 即生效。

***

## 验证 [#验证]

手动测试脚本是否正常输出：

```bash
echo '{}' | python3 ~/.claude/statusline.py
```

能看到带颜色的两行输出即说明工作正常。

<figure>
  ![终端验证输出](https://r2.unono.app/2026/05/8980acb3a41099006d8d308866e7f221.png)
  <figcaption>手动测试脚本输出</figcaption>
</figure>