Humpens/claude-mods/tree/main/status
이 mod 소개
claude-mods
비엔지니어도 쉽게 사용할 수 있는 Claude Code의 모드(화면에 기능을 추가하는 플러그인) 모음입니다. 데스크톱 앱의 Code 탭과 터미널(Cursor, VS Code 등)에서 모두 작동합니다.
| 모드 | 기능 | 명령어 |
|---|---|---|
| status | 도구 모음 (입력 필드 위)에 Menu ▸ 표시. 각 기능 설정, 사용하지 않는 기능 끄기, 자주 사용하는 슬래시 명령어 ★ 및 목록 (설명은 일본어) | /s |
| today | TODO를 Today, ◎ 최우선, ○ 나중, △ 여유 있을 때, ◇ 상대방 대기 중으로 관리. 상태 표시줄 (상태 라인)에 오늘의 개수 표시. 목록 화면에서 버튼으로 이동 및 완료. 채팅에서 "TODO 추가", "#12 오늘 할 일"이라고 말할 수도 있습니다 | /todo |
| baton-notify | 작업이 완료되었거나 질문이 왔거나 승인을 기다릴 때 Mac 알림으로 알려줍니다. 어떤 세션인지도 알 수 있습니다. 소리, 볼륨, 소리 종류, 읽어주기 기능을 설정할 수 있습니다 | /baton |
| u | 상태 표시줄에 5h 13% · 7d 20% · $9.53 (5시간/주간 사용률 및 API 환산 비용) 표시. 표시할 내용을 선택할 수 있습니다 | /meter |
설치 방법
Claude Code에서 다음 두 가지를 입력합니다.
/plugin marketplace add Humpens/claude-mods
/plugin install status@claude-mods
다른 모드도 today@claude-mods, baton-notify@claude-mods, u@claude-mods 와 같이 설치할 수 있습니다.
설치 후에는 새 세션을 시작하면 사용할 수 있습니다.
화면 용어
| 용어 | 위치 | 내용 | |---|---|---| | 도구 모음 | 입력 필드 바로 위 | 눌러서 사용하는 버튼 (메뉴, ★ 명령어, /) | | 상태 표시줄 (상태 라인) | 화면 맨 아래 | 보기 전용 표시 (today, u) | | 창 | 화면 옆 | 목록 및 설정 화면 | | 토스트 | 화면 오른쪽 아래 (데스크톱 앱) | 몇 초 후에 사라지는 알림 |
사용 팁
- 먼저 도구 모음(입력 필드 위)의 **Menu ▸**를 누르세요. 모든 기능에 여기에서 접근할 수 있습니다.
- 사용하지 않는 기능은 Menu → Settings에서 끄면 화면에서도 사라집니다.
- TODO는 아침에 ◎에서 3~5개를 Today로 옮기고, 그날 안에 상태 표시줄의 숫자를 0으로 만드는 것을 추천합니다.
설정
| 모드 | 설정 | 내용 |
|---|---|---|
| today | todoPath | 사용할 TODO 파일의 위치. 비어 있으면 ~/todo.md (없으면 처음 쓸 때 생성됩니다) |
/config 또는 ~/.claude/settings.json 의 pluginConfigs 에서 변경할 수 있습니다.
"pluginConfigs": {
"today": { "options": { "todoPath": "~/Documents/todo.md" } }
}
주의사항
- baton-notify의 알림 및 소리는 macOS 전용입니다 (
osascript및afplay를 사용합니다). 읽어주기 기능은 Claude Code 본체 기능이므로 Windows에서도 작동합니다. - status는 슬래시 명령어의 영어 설명을 일본어로 번역할 때 Claude의 가벼운 모델(haiku)을 사용합니다. 번역은 한 번만 이루어지며, 이후에는 저장되어 재사용됩니다.
- today는 지정된 TODO 파일(Markdown)만 읽고 씁니다.
- 어떤 모드도 외부 서버로 데이터를 보내지 않습니다.
- Claude Code의 일반 채팅(claude.ai)에서는 작동하지 않습니다. Claude Code 화면 전용입니다.
내용 확인
claude plugin validate ./status
claude plugin test ./status
validate 는 해당 모드가 사용하는 모든 기능(파일, 명령어 실행, 모델 호출 등)을 목록으로 보여줍니다.
라이선스
MIT (Claude Code Club)
설치
먼저 작성자의 README에서 marketplace와 플러그인 이름을 확인하세요. 저장소 구조에 따라 명령어가 달라질 수 있습니다.
claude plugin marketplace add Humpens/claude-mods claude plugin install status
원문 / README
claude-mods
非エンジニアでも使いやすい、Claude Code の mod(画面に機能を足すプラグイン)集です。 デスクトップアプリの Code タブでも、ターミナル(Cursor・VS Code など)でも動きます。
| mod | できること | コマンド |
|---|---|---|
| status | ツールバー(入力欄の上)に Menu ▸。各機能の設定、使わない機能のオフ、よく使うスラッシュコマンドの ★ と一覧(説明は日本語) | /s |
| today | TODO を Today・◎最優先・○後回し・△余裕がある時・◇相手待ちで管理。ステータスバー(ステータスライン)に今日の件数。一覧の画面からボタンで移動・完了。チャットで「TODO追加」「#12 を今日やる」とも言える | /todo |
| baton-notify | 作業が終わった・質問が来た・許可を待っているときに Mac の通知で知らせる。どのセッションかも分かる。音・音量・音の種類・読み上げを設定できる | /baton |
| u | ステータスバーに 5h 13% · 7d 20% · $9.53(5時間・週の使用率と API 換算の料金)。何を出すか選べる | /meter |
入れ方
Claude Code の中で次の2つを打ちます。
/plugin marketplace add Humpens/claude-mods
/plugin install status@claude-mods
ほかの mod も同じように today@claude-mods・baton-notify@claude-mods・u@claude-mods で入れられます。
入れたあとは、新しいセッションを始めると使えます。
画面の呼び方
| 呼び方 | 場所 | 中身 | |---|---|---| | ツールバー | 入力欄のすぐ上 | 押して使うボタン(Menu・★のコマンド・/) | | ステータスバー(ステータスライン) | 画面のいちばん下 | 見るだけの表示(today・u) | | ペイン | 画面の横 | 一覧や設定の画面 | | トースト | 画面の右下(デスクトップアプリ) | 数秒で消える通知 |
使い方のこつ
- まずはツールバー(入力欄の上)の Menu ▸ を押してください。全部の機能にここから行けます。
- 使わない機能は Menu → Settings でオフにすると、画面からも消えます。
- TODO は、朝に ◎ から3〜5個を Today に移して、その日のうちにステータスバーの数字を 0 にするのがおすすめです。
設定
| mod | 設定 | 内容 |
|---|---|---|
| today | todoPath | 使う TODO ファイルの場所。空なら ~/todo.md(無ければ最初に書き込むときに作ります) |
/config か、~/.claude/settings.json の pluginConfigs で変えられます。
"pluginConfigs": {
"today": { "options": { "todoPath": "~/Documents/todo.md" } }
}
注意
- baton-notify の通知と音は macOS 専用です(
osascriptとafplayを使います)。読み上げは Claude Code 本体の機能なので Windows でも動きます。 - status は、スラッシュコマンドの英語の説明を日本語にするとき、Claude の軽いモデル(haiku)を使います。訳は一度だけで、あとは保存して使い回します。
- today は、指定した TODO ファイル(Markdown)だけを読み書きします。
- どの mod も、外部のサーバーにデータを送りません。
- Claude Code の通常のチャット(claude.ai)では動きません。Claude Code の画面専用です。
中身を確かめる
claude plugin validate ./status
claude plugin test ./status
validate で、その mod が使う機能(ファイル・コマンド実行・モデル呼び出しなど)が全部一覧で出ます。
ライセンス
MIT(Claude Code Club)
