Claude Code 하네스 교체 가이드
OMC → ECC + 사용 한도 상태표시줄

무엇을 바꾸나요

1. Claude에게 주는 지시

mkdir -p ~/.claude
curl -fsSL https://ecc-team-setup.pages.dev/statusline.sh -o ~/.claude/statusline.sh
chmod +x ~/.claude/statusline.sh

shasum -a 256 ~/.claude/statusline.sh

309b1364fdc34ad542c09f29b418be32eb65b3a750c8dbee19705143dbc7df15

command -v jq && jq --version || echo "JQ_MISSING"

brew install jq

echo "$HOME"

tar -czf ~/claude-backup-before-ecc-$(date +%Y%m%d-%H%M%S).tgz -C ~ .claude
ls -lh ~/claude-backup-before-ecc-*.tgz

npm ls -g --depth=0 2>/dev/null | grep -i -e sisyphus -e oh-my-claude || echo "설치되어 있지 않음"
npm uninstall -g oh-my-claude-sisyphus

ls -d ~/.claude/hud ~/.claude/.omc* 2>/dev/null
grep -rIl -e 'oh-my-claude' -e 'sisyphus' -e 'omc-' \
  ~/.claude/agents ~/.claude/skills ~/.claude/commands ~/.claude/hooks 2>/dev/null

rm -rf ~/.claude/hud
rm -rf ~/.claude/.omc ~/.claude/.omc-cache ~/.claude/.omc-state

grep -n -e 'omc' -e 'sisyphus' -e 'hud' ~/.claude/settings.json || echo "OMC 참조 없음"

[ -f ~/.claude/settings.json ] || echo '{}' > ~/.claude/settings.json
cp ~/.claude/settings.json ~/.claude/settings.json.bak

jq '.extraKnownMarketplaces.ecc = {"source":{"source":"github","repo":"affaan-m/ECC"}}
    | .enabledPlugins["ecc@ecc"] = true' \
  ~/.claude/settings.json > ~/.claude/settings.json.tmp \
  && mv ~/.claude/settings.json.tmp ~/.claude/settings.json

jq -e '.extraKnownMarketplaces.ecc, .enabledPlugins["ecc@ecc"]' ~/.claude/settings.json

/plugin marketplace add affaan-m/ECC
/plugin install ecc@ecc

mkdir -p ~/.claude
curl -fsSL https://ecc-team-setup.pages.dev/statusline.sh -o ~/.claude/statusline.sh
chmod +x ~/.claude/statusline.sh

shasum -a 256 ~/.claude/statusline.sh

309b1364fdc34ad542c09f29b418be32eb65b3a750c8dbee19705143dbc7df15

"statusLine": {
  "type": "command",
  "command": "bash ~/.claude/statusline.sh",
  "refreshInterval": 30
}

jq --arg cmd "bash $HOME/.claude/statusline.sh" \
  '.statusLine = {"type":"command","command":$cmd,"refreshInterval":30}' \
  ~/.claude/settings.json > ~/.claude/settings.json.tmp \
  && mv ~/.claude/settings.json.tmp ~/.claude/settings.json

jq -r '.statusLine.command' ~/.claude/settings.json

command -v jq && jq --version

jq -e . ~/.claude/settings.json > /dev/null && echo "settings.json 유효함"

printf '{"workspace":{"current_dir":"/Users/me/imac"},"model":{"display_name":"Opus 5"},"context_window":{"used_percentage":23},"cost":{"total_cost_usd":14.74},"rate_limits":{"five_hour":{"used_percentage":31,"resets_at":%s},"seven_day":{"used_percentage":9,"resets_at":%s}}}' \
  $(( $(date +%s) + 9900 )) $(( $(date +%s) + 435600 )) \
  | bash ~/.claude/statusline.sh; echo

Opus 5 │ 5h 31% 2h45m │ 주 9% 5d │ ctx 23% │ $14.74 │ imac

echo '{}' | bash ~/.claude/statusline.sh; echo

2. 직접 설치하기 (수동)

Claude에게 맡기지 않고 손으로 하려면 아래를 순서대로 터미널에 복사·붙여넣기 하세요. (맥에서 터미널 열기: Command + Space → “터미널” 입력 → 엔터)

① 백업 — 이것부터

tar -czf ~/claude-backup-before-ecc-$(date +%Y%m%d-%H%M%S).tgz -C ~ .claude
ls -lh ~/claude-backup-before-ecc-*.tgz

파일 목록이 하나 뜨면 성공입니다. 안 뜨면 여기서 멈추세요.

② OMC 제거

npm uninstall -g oh-my-claude-sisyphus
rm -rf ~/.claude/hud ~/.claude/.omc ~/.claude/.omc-cache ~/.claude/.omc-state

그 다음, 남아 있는 OMC 관련 파일이 있는지 확인합니다. 결과가 나와도 바로 지우지 말고, Cloudflare·Remotion·Workers 등 다른 도구의 파일이 섞여 있지 않은지 눈으로 확인하세요.

grep -rIl -e 'oh-my-claude' -e 'sisyphus' \
  ~/.claude/agents ~/.claude/skills ~/.claude/commands ~/.claude/hooks 2>/dev/null

③ ECC 설치

터미널에서 claude 를 실행한 뒤, Claude Code 대화창에 아래 두 줄을 한 줄씩 입력합니다.

/plugin marketplace add affaan-m/ECC
/plugin install ecc@ecc

설정 파일에 직접 넣고 싶다면 ~/.claude/settings.json 에 다음 두 항목을 추가해도 됩니다.

{
  "extraKnownMarketplaces": {
    "ecc": { "source": { "source": "github", "repo": "affaan-m/ECC" } }
  },
  "enabledPlugins": {
    "ecc@ecc": true
  }
}

어느 쪽이든 Claude Code를 재시작해야 실제로 내려받아집니다.

④ jq 확인

command -v jq || brew install jq

macOS 15에는 /usr/bin/jq 가 기본으로 들어 있어 대부분 그냥 통과합니다.

⑤ 상태줄 스크립트 내려받기

복사·붙여넣기 대신 아래 세 줄을 그대로 터미널에 넣으세요. 오타가 날 여지가 없습니다.

mkdir -p ~/.claude
curl -fsSL https://ecc-team-setup.pages.dev/statusline.sh -o ~/.claude/statusline.sh
chmod +x ~/.claude/statusline.sh

제대로 받아졌는지 체크섬으로 확인합니다.

shasum -a 256 ~/.claude/statusline.sh

아래와 똑같은 값이 나와야 합니다. 다르면 설치를 멈추고 다시 받으세요.

309b1364fdc34ad542c09f29b418be32eb65b3a750c8dbee19705143dbc7df15

내용을 직접 눈으로 보고 싶으면 “상태줄 스크립트 전문” 에 같은 내용이 그대로 실려 있습니다.

⑥ settings.json에 등록

아래 명령 한 줄이면 자동으로 절대경로가 들어갑니다.

jq --arg cmd "bash $HOME/.claude/statusline.sh" \
  '.statusLine = {"type":"command","command":$cmd,"refreshInterval":30}' \
  ~/.claude/settings.json > /tmp/cc-settings.json \
  && mv /tmp/cc-settings.json ~/.claude/settings.json

jq -r '.statusLine.command' ~/.claude/settings.json

마지막 줄 출력이 bash /Users/…/.claude/statusline.sh 형태여야 합니다. ~ 가 그대로 남아 있으면 Claude Code가 스크립트를 못 찾습니다.

⑦ 확인하고 재시작

jq -e . ~/.claude/settings.json > /dev/null && echo "설정 파일 정상"
echo '{}' | bash ~/.claude/statusline.sh; echo

5h — │ 주 — 같은 출력이 나오면 스크립트는 정상입니다. 이제 Claude Code를 완전히 껐다가 다시 켜세요.

3. 상태줄 스크립트 전문 — 검토용

https://ecc-team-setup.pages.dev/statusline.sh

309b1364fdc34ad542c09f29b418be32eb65b3a750c8dbee19705143dbc7df15

아래가 ~/.claude/statusline.sh 의 전체 내용입니다. 감사할 수 있도록 숨김 없이 그대로 공개합니다. 읽어보면 알 수 있듯 jq 로 표준입력(stdin) JSON을 파싱해 문자열을 출력하는 것이 전부이며, 네트워크 접속, 파일 쓰기, 외부 프로그램 호출이 없습니다.

#!/bin/bash
# Claude Code status line: dir | model | context | cost | 5h limit | weekly limit
#
# Every value comes from the JSON Claude Code writes to stdin. No network
# calls, no background processes, no credentials.
#
# rate_limits is sent only to Claude Pro/Max accounts, and only after the
# session's first API response — so both windows show "—" until then.
#
# Claude Code truncates from the right, so the two limits sit near the front
# and lower-value segments are dropped first when $COLUMNS is tight.

set -uo pipefail

readonly RESET=$'\033[0m'
readonly DIM=$'\033[2m'
readonly GREEN=$'\033[32m'
readonly YELLOW=$'\033[33m'
readonly RED=$'\033[31m'

readonly SEPARATOR=' │ '
readonly SEPARATOR_WIDTH=3

        # Tab-separated: model display names contain spaces.
IFS=$'\t' read -r dir model ctx cost five_pct five_at week_pct week_at <<<"$(
  jq -r '[
    (.workspace.current_dir // .cwd // "-"),
    (.model.display_name // "-"),
    (.context_window.used_percentage // -1 | floor),
    (.cost.total_cost_usd // -1),
    (.rate_limits.five_hour.used_percentage // -1 | floor),
    (.rate_limits.five_hour.resets_at // 0),
    (.rate_limits.seven_day.used_percentage // -1 | floor),
    (.rate_limits.seven_day.resets_at // 0)
  ] | @tsv'
)"

# Green under half, yellow past half, red once the window is nearly spent.
colour_for() {
  if   [ "$1" -ge 80 ]; then printf '%s' "$RED"
  elif [ "$1" -ge 50 ]; then printf '%s' "$YELLOW"
  else printf '%s' "$GREEN"
  fi
}

# Epoch seconds -> "5d" / "2h45m" / "45m" remaining, or empty once passed.
countdown() {
  local remaining=$(( $1 - $(date +%s) ))
  [ "$1" -gt 0 ] && [ "$remaining" -gt 0 ] || return
  if   [ "$remaining" -ge 86400 ]; then printf '%dd' "$((remaining / 86400))"
  elif [ "$remaining" -ge 3600 ];  then printf '%dh%dm' "$((remaining / 3600))" "$(((remaining % 3600) / 60))"
  else printf '%dm' "$((remaining / 60))"
  fi
}

# Segments are collected as three parallel arrays: what to print, how wide it
# actually renders (ANSI codes take no columns), and how readily it can go.
# Lower keep_rank is dropped first.
rendered=() widths=() ranks=()
add_segment() {
  rendered+=("$1"); widths+=("$2"); ranks+=("$3")
}

# The limits lead the line: rank 9 keeps them off the chopping block, and the
# slot stays visible even when Claude Code omits the numbers, so a missing
# value reads as "unknown" rather than "fine".
# label_width is passed in because CJK labels render two columns wide while
# ${#label} counts one, and the em dash is likewise two.
add_limit() {
  local label=$1 label_width=$2 percent=$3 reset_at=$4
  if [ "$percent" -lt 0 ] 2>/dev/null; then
    add_segment "${DIM}${label} —${RESET}" "$(( label_width + 3 ))" 9
    return
  fi
  local left text width
  left=$(countdown "$reset_at")
  text="${label} $(colour_for "$percent")${percent}%${RESET}"
  width=$(( label_width + 2 + ${#percent} ))
  if [ -n "$left" ]; then
    text="${text} ${DIM}${left}${RESET}"
    width=$(( width + 1 + ${#left} ))
  fi
  add_segment "$text" "$width" 9
}

[ "$model" != "-" ] && add_segment "$model" "${#model}" 4

add_limit "5h" 2 "$five_pct" "$five_at"
add_limit "주" 2 "$week_pct" "$week_at"

if [ "$ctx" -ge 0 ] 2>/dev/null; then
  add_segment "$(colour_for "$ctx")ctx ${ctx}%${RESET}" "$(( 5 + ${#ctx} ))" 3
fi

case "$cost" in
  -1|"") ;;
  *)
    cost_text=$(printf '$%.2f' "$cost" 2>/dev/null || printf '$0.00')
    add_segment "${DIM}${cost_text}${RESET}" "${#cost_text}" 1
    ;;
esac

[ "$dir" != "-" ] && { name=$(basename "$dir"); add_segment "${DIM}${name}${RESET}" "${#name}" 2; }

# Drop the least useful segments until the line fits the terminal. COLUMNS is
# exported by Claude Code (v2.1.153+); assume a roomy default when it is not.
readonly TERMINAL_WIDTH=${COLUMNS:-200}
keep=()
for i in "${!rendered[@]}"; do keep+=(1); done

line_width() {
  local total=0 shown=0 i
  for i in "${!rendered[@]}"; do
    [ "${keep[$i]}" -eq 1 ] || continue
    total=$(( total + widths[i] ))
    shown=$(( shown + 1 ))
  done
  [ "$shown" -gt 1 ] && total=$(( total + (shown - 1) * SEPARATOR_WIDTH ))
  printf '%d' "$total"
}

for rank in 1 2 3 4; do
  [ "$(line_width)" -le "$TERMINAL_WIDTH" ] && break
  for i in "${!rendered[@]}"; do
    if [ "${ranks[$i]}" -eq "$rank" ]; then keep[$i]=0; fi
  done
done

output=""
for i in "${!rendered[@]}"; do
  [ "${keep[$i]}" -eq 1 ] || continue
  [ -n "$output" ] && output+="$SEPARATOR"
  output+="${rendered[$i]}"
done
printf '%s' "$output"

이 스크립트가 읽는 값

Claude Code는 상태표시줄 명령을 실행할 때마다 세션 정보를 JSON으로 표준입력에 넣어줍니다. 그중 한도 관련 필드는 다음 네 가지입니다.

공식 문서: https://code.claude.com/docs/en/statusline.md

4. 설치 후 이렇게 보입니다

터미널 입력줄 바로 아래에 이런 한 줄이 생깁니다.

모델명 다음에 5시간 한도와 주간 한도가 바로 붙어 줄 앞쪽을 차지하고, 참고용 정보일수록 뒤로 갑니다. 왼쪽부터 순서대로 읽으면 됩니다.

$14.74 같은 금액은 무엇인가요 — 실제 청구액이 아닙니다

색상 규칙

같은 규칙이 컨텍스트(ctx) 표시에도 적용됩니다. 예를 들어 한도를 많이 쓴 상태는 이렇게 보입니다.

남은 시간 표기는 남은 길이에 따라 5d / 2h45m / 42m 형태로 바뀌고, 이미 지난 경우에는 표시되지 않습니다.

터미널 창이 좁으면 — 덜 중요한 것부터 알아서 빠집니다

Claude Code는 상태줄 스크립트를 실행할 때 COLUMNS 환경변수로 현재 터미널 폭을 넘겨줍니다 (Claude Code v2.1.153 이상). 스크립트가 이 값을 읽어서, 한 줄이 폭에 안 맞으면 덜 중요한 항목부터 자동으로 뺍니다. 창을 좁혀도 줄이 깨지거나 뒤가 잘려나가지 않습니다.

빠지는 순서는 이렇습니다.

실제로 측정한 동작입니다.

49칸에서 $14.74 가 빠지고, 42칸에서 디렉터리 imac 이, 24칸에서는 ctx 와 모델명 Opus 5 까지 빠지지만 두 한도는 끝까지 남아 있는 것을 확인할 수 있습니다.

버전이 낮아 COLUMNS 가 전달되지 않으면 스크립트는 넉넉한 폭을 가정해 전체 항목을 그대로 출력합니다. 즉 구버전에서도 예전과 똑같이 동작하며, 따로 설정할 것은 없습니다.

5. 문제 해결

jq -r '.statusLine.command' ~/.claude/settings.json

ls -l ~/.claude/statusline.sh

brew install jq

ls -lt ~/claude-backup-before-ecc-*.tgz

mv ~/.claude ~/.claude-broken-$(date +%Y%m%d-%H%M%S)
tar -xzf ~/파일명.tgz -C ~
ls -d ~/.claude

jq '.extraKnownMarketplaces.ecc, .enabledPlugins' ~/.claude/settings.json

6. 보안 안내

상태줄 스크립트에 대해

• 스크립트는 Claude Code가 이미 화면에 표시하고 있는 세션 정보만 읽습니다. 새로 얻어오는 정보가 없습니다.
• 외부 서버와 통신하지 않습니다. 인터넷 연결이 끊겨 있어도 똑같이 동작합니다.
• 파일을 쓰거나 지우지 않습니다. 로그도 남기지 않습니다.
• API 키·토큰·인증 정보에 접근하지 않습니다.
• 전체 소스를 위에 그대로 게시했습니다. 30줄 남짓이니 직접 읽어보고 판단하세요.

백업에 대해

1단계에서 만드는 ~/claude-backup-before-ecc-*.tgz 파일에는 ~/.claude 폴더 전체가 들어갑니다. 설정과 대화 기록이 포함될 수 있으니 이 파일을 외부에 공유하거나 업로드하지 마세요. 로컬에만 두면 됩니다.