Claude Code Coralline Statusline 教學

你會看到哪些資訊？

Git 與 context 符號怎麼讀？

背後機制只有三步

複製{
  "statusLine": {
    "type": "command",
    "command": "bash ~/.claude/coralline/run.sh",
    "refreshInterval": 1
  }
}

檔案架構

常用個人設定

複製. ~/.claude/coralline/themes/claude-coral.conf
VL_STYLE="pill"
VL_LAYOUT="auto"
VL_MAX_LINES=2
VL_SEGMENTS="dir git model ctx cost clock"
VL_CLOCK="12h"
VL_CLOCK_SECONDS=1
VL_BAR_WIDTH=5
VL_COST_DECIMALS=2
VL_PATH_DEPTH=4
VL_ASCII=0

如果你的終端機沒有 Nerd Font，先把 VL_ASCII=1，讓圖示改成純 ASCII，避免看到方塊或問號。

Windows（Git Bash）一鍵安裝

複製#!/usr/bin/env bash
set -euo pipefail

echo "=== [1/5] 安裝 jq（若已安裝會自動跳過）==="
powershell.exe -Command "winget install jqlang.jq --accept-package-agreements --accept-source-agreements" || true

JQ_DIR=$(powershell.exe -Command "(Get-ChildItem '$env:LOCALAPPDATA\Microsoft\WinGet\Packages' -Filter 'jqlang.jq*' -Directory | Select-Object -First 1).FullName" 2>/dev/null | tr -d '\r')
if [ -z "$JQ_DIR" ]; then
  echo "WARNING: 找不到 jq 安裝目錄，請手動確認路徑並更新 run.sh"
  JQ_DIR="/c/Users/$(whoami)/AppData/Local/Microsoft/WinGet/Packages/jqlang.jq_Microsoft.Winget.Source_8wekyb3d8bbwe"
fi

JQ_UNIX_DIR=$(echo "$JQ_DIR" | sed 's|\\|/|g' | sed 's|C:|/c|' | sed 's|D:|/d|')
echo "jq 路徑：$JQ_UNIX_DIR"

echo "=== [2/5] 下載 Coralline 腳本 ==="
BASE="https://raw.githubusercontent.com/Nanako0129/coralline/main"
mkdir -p "$HOME/.claude/coralline/themes"
curl -fsSL "$BASE/statusline.sh" -o "$HOME/.claude/coralline/statusline.sh"
curl -fsSL "$BASE/themes/claude-coral.conf" -o "$HOME/.claude/coralline/themes/claude-coral.conf"
chmod +x "$HOME/.claude/coralline/statusline.sh"

echo "=== [3/5] 建立 Windows jq PATH wrapper ==="
cat > "$HOME/.claude/coralline/run.sh" << WRAPPER
#!/usr/bin/env bash
export PATH="\$PATH:$JQ_UNIX_DIR"
exec bash "\$(dirname "\$0")/statusline.sh"
WRAPPER
chmod +x "$HOME/.claude/coralline/run.sh"

echo "=== [4/5] 建立 coralline.conf ==="
cat > "$HOME/.claude/coralline.conf" << 'CONF'
. ~/.claude/coralline/themes/claude-coral.conf
VL_STYLE="pill"
VL_LAYOUT="auto"
VL_MAX_LINES=2
VL_SEGMENTS="dir git model ctx cost clock"
VL_CLOCK="12h"
VL_CLOCK_SECONDS=1
VL_BAR_WIDTH=5
VL_COST_DECIMALS=2
VL_PATH_DEPTH=4
VL_ASCII=0
CONF

echo "=== [5/5] 更新 ~/.claude/settings.json ==="
SETTINGS="$HOME/.claude/settings.json"
[ -f "$SETTINGS" ] && cp "$SETTINGS" "${SETTINGS}.bak"
python - "$SETTINGS" << 'PYEOF'
import json, sys, pathlib

path = pathlib.Path(sys.argv[1])
data = json.loads(path.read_text(encoding="utf-8")) if path.exists() else {}
data["statusLine"] = {
    "type": "command",
    "command": "bash ~/.claude/coralline/run.sh",
    "refreshInterval": 1
}
path.write_text(json.dumps(data, indent=2, ensure_ascii=False), encoding="utf-8")
print("settings.json 更新完成")
PYEOF

echo "安裝完成。請重啟 Claude Code。"

macOS 一鍵安裝

複製#!/usr/bin/env bash
set -euo pipefail

echo "=== [1/5] 安裝 jq ==="
brew install jq

echo "=== [2/5] 下載 Coralline 腳本 ==="
BASE="https://raw.githubusercontent.com/Nanako0129/coralline/main"
mkdir -p "$HOME/.claude/coralline/themes"
curl -fsSL "$BASE/statusline.sh" -o "$HOME/.claude/coralline/statusline.sh"
curl -fsSL "$BASE/themes/claude-coral.conf" -o "$HOME/.claude/coralline/themes/claude-coral.conf"
chmod +x "$HOME/.claude/coralline/statusline.sh"

echo "=== [3/5] 建立 coralline.conf ==="
cat > "$HOME/.claude/coralline.conf" << 'CONF'
. ~/.claude/coralline/themes/claude-coral.conf
VL_STYLE="pill"
VL_LAYOUT="auto"
VL_MAX_LINES=2
VL_SEGMENTS="dir git model ctx cost clock"
VL_CLOCK="12h"
VL_CLOCK_SECONDS=1
VL_BAR_WIDTH=5
VL_COST_DECIMALS=2
VL_PATH_DEPTH=4
VL_ASCII=0
CONF

echo "=== [4/5] 更新 ~/.claude/settings.json ==="
SETTINGS="$HOME/.claude/settings.json"
[ -f "$SETTINGS" ] && cp "$SETTINGS" "${SETTINGS}.bak"
TMP=$(mktemp)
jq '.statusLine = {"type":"command","command":"bash ~/.claude/coralline/statusline.sh","refreshInterval":1}' \
  "$SETTINGS" > "$TMP" && mv "$TMP" "$SETTINGS"

echo "=== [5/5] 完成 ==="
echo "安裝完成。請重啟 Claude Code。"

安裝後測試

如果重啟 Claude Code 後沒有看到狀態列，先用假資料手動測試腳本是否能輸出：

複製echo '{"model":{"display_name":"test"},"context_window":{"used_percentage":50},"cost":{"total_cost_usd":0.01},"cwd":"/tmp"}' | bash ~/.claude/coralline/run.sh

macOS 若沒有 run.sh，把最後的路徑改成 ~/.claude/coralline/statusline.sh。

常見問題

參考來源

• 來源筆記：10-shared-knowledge/ai-agent/2026-06-28-claude-code-coralline-statusline-教學SOP.md
• Coralline 原作者來源：Nanako0129/coralline GitHub repository
• 一鍵安裝腳本下載 base URL：https://raw.githubusercontent.com/Nanako0129/coralline/main
• 站內教學：AI 工具安裝與用途說明
• 站內教學：AI 新手 Skill 推薦與安全下載指南