---
title: "context-meter"
url: "https://claudemods.dev/ko/builds/context-meter-4f44b6"
source: "https://github.com/Vibe-Commit/claude-context-mods/tree/main/plugins/context-meter"
source_type: "github"
repo: "https://github.com/Vibe-Commit/claude-context-mods/tree/main/plugins/context-meter"
author: "Vibe-Commit"
author_handle: "Vibe-Commit"
stars: 0
category: "대시보드 및 HUD"
categories: ["hud"]
tags: ["claude-code", "context-meter", "context-window", "hooks", "hud", "plugin", "status-line"]
permission_level: 0
scan_complete: true
install: "claude plugin marketplace add Vibe-Commit/claude-context-mods\nclaude plugin install context-meter@claude-context-mods"
added: "2026-10-05T01:47:15.828Z"
updated: "2026-11-01T14:39:46Z"
locale: "ko"
content_locale: "ko"
---

# context-meter

프롬프트 푸터에 컨텍스트 윈도우 사용량을 표시합니다.

## Description

# claude-context-mods

긴 세션을 건강하게 유지하기 위한 Claude Code mod 두 가지입니다:

| Mod | What it does |
| --- | --- |
| **context-meter** | 프롬프트 푸터에 컨텍스트 윈도우 사용량(`207k / 1.0M (21%)`)을 표시하고 사용량이 80%를 넘으면 한 번 알립니다. |
| **context-handoff** | 컨텍스트가 60–70% 차면 Claude가 자연스러운 중단 지점을 선택하고 자신에게 전달 메모를 작성합니다. |

둘 다 function-hook mod(TypeScript hook 모듈로 작성된 플러그인)입니다. Claude Code 2.1.289에서 제작 및 테스트되었습니다.

## Install

```
/plugin marketplace add Vibe-Commit/claude-context-mods
/plugin install context-meter@claude-context-mods
```

## Install

```
claude plugin marketplace add Vibe-Commit/claude-context-mods
claude plugin install context-meter@claude-context-mods
```

## Original README

# claude-context-mods

Two Claude Code mods for keeping long sessions healthy:

| Mod | What it does |
| --- | --- |
| **context-meter** | Shows context-window usage in the prompt footer (`207k / 1.0M (21%)`), and shows a notice once when usage passes 80%. |
| **context-handoff** | When context is 60–70% full, Claude picks a natural stopping point and writes itself a handoff note. The mod then cuts the note-writing out of the transcript (a rewind), runs `/compact`, and has Claude read the note and carry on. The note is deleted once Claude has read it back. |

Both are function-hook mods (plugins written as TypeScript hook modules). That API is **early access**, so it can change between Claude Code releases. They were built and tested on **Claude Code 2.1.289**.

## Install

Inside Claude Code:

```
/plugin marketplace add Vibe-Commit/claude-context-mods
/plugin install context-meter@claude-context-mods
/plugin install context-handoff@claude-context-mods
```

Or from a shell:

```sh
claude plugin marketplace add Vibe-Commit/claude-context-mods
claude plugin install context-meter@claude-context-mods
claude plugin install context-handoff@claude-context-mods
```

Restart Claude Code afterwards (or run `/reload-plugins`). Install one mod or both; they work independently.

## Update and uninstall

```sh
claude plugin marketplace update claude-context-mods
claude plugin update context-handoff@claude-context-mods   # restart to apply
claude plugin uninstall context-handoff@claude-context-mods
```

## context-handoff in detail

1. **In the band.** Once context passes 60%, Claude gets a hidden note telling it to hand off at the next natural boundary: a task finished, tests green, or before a new subtask, never mid-edit. At 70% the note says to do it now. The status line shows the current phase.
2. **Write.** Claude calls the mod's `Handoff` tool with a markdown note. The note covers the goal, current state, decisions and their reasons, files, open problems, next steps, and commands to verify. It is saved to `~/.claude/handoffs/<session-id>/handoff-N.md`. Claude is then held to ending its turn.
3. **Rewind and compact.** When the turn ends, the mod compacts the session. The summary only covers the transcript up to the `Handoff` call, so writing the note never ends up in context.
4. **Resume.** The mod sends a prompt telling Claude to read the note and continue from its next steps.
5. **Clean up.** After Claude reads the note back, the mod deletes it. It only deletes a file it wrote itself, and only if that file is inside the session's handoff folder. If the note is never read, it is kept and a notice shows its path.

Safeguards:
- Subagents are ignored.
- If a turn ends at 75% or more with no handoff, Claude is asked once to write one.
- If you interrupt the turn after the note is saved, the compaction is cancelled and the note is kept.

Command: `/handoff [status|on|off|now]`. `now` asks for a handoff right away, which is the quickest way to try the mod.

Thresholds (60 / 70 / 75 by default) can be changed per user. You can use `/plugin configure context-handoff@claude-context-mods` inside Claude Code, or a shell:

```sh
echo '{"bandLow":"55","bandHigh":"65","overshoot":"75"}' \
  | claude plugin configure context-handoff@claude-context-mods --values-stdin
```

When you install, Claude Code reports "3 userConfig options not yet set". That's expected: unset options use the defaults.

## Developing

Each mod has tests:

```sh
claude plugin validate plugins/context-handoff
claude plugin test plugins/context-handoff
```

To work on a mod with hot reload, load it from your checkout with `claude --plugin-dir ./plugins/context-handoff`, or list the folder in `CLAUDE_CODE_PLUGIN_DIRS`. Uninstall the marketplace copy first so it doesn't load twice. Bump `version` in the mod's `plugin.json` and in `.claude-plugin/marketplace.json` together. `claude plugin validate .` checks that they agree.
