設定と CLAUDE.md

Claude Codeのステータスラインの設定方法⁠｜/statuslineとsettings.json、出力スタイルの切り替え

Claude Codeのステータスラインは、画面の下に出し続けられる自分用の表示欄です。使っているモデル、コンテキストの使用率、gitのブランチ、費用などを、会話の邪魔をせずに見られます。作り方は2通りで、Claude Codeの中で/statuslineに頼むか、settings.jsonのstatusLineにスクリプトを指定します。

返事の口調や長さを変えたいときは、ステータスラインではなく出力スタイルの仕事です。/output-styleで切り替えます。この記事では、2つをまとめて説明します。

手順は、2026年10月23日に公式のステータスラインの説明と出力スタイルの説明と照らし合わせました。

ステータスラインとは何か

ステータスラインは、設定したシェルスクリプトの出力を、画面の下に表示する機能です。Claude Codeがセッションの情報をJSONでスクリプトに渡し、スクリプトがechoした文字がそのまま表示されます（公式の説明）。

• ローカルで動く。ステータスラインはAPIのトークンを使いません
• 組み込みの表示（フッターのバッジ）の上に別の行として出ます。置き換えはしません
• カスタムのステータスラインを設定すると、esc to interruptや? for shortcutsなどのフッターの操作ヒントは、ほとんど出なくなります
• ヘルプメニューや許可の確認が出ている間は、一時的に隠れます

用語の意味は、用語集のステータスラインにもあります。コンテキストの使用率は、用語集のコンテキストウィンドウと/compactの話につながります。

/statuslineで作る（いちばん簡単）

Claude Codeの中で、欲しい表示を日本語でも英語でも頼みます。

/statusline show model name and context percentage with a progress bar

Claude Codeがスクリプトを~/.claude/に作り、設定も自動で書き換えます。ファイルの編集を許可するか聞かれたら承認します（公式の説明）。

消したいときも同じ画面で、/statusline deleteや/statusline remove itのように頼みます。

settings.jsonに自分で書く

自分でスクリプトを書くなら、手順は3つです。公式の例（macOSとLinux向けのBash）を、そのまま載せます。ほかのOSは次の章で触れます。

1. スクリプトを作る ~/.claude/statusline.shに保存します。JSONの読み取りにjqを使うので、入っていなければ入れます。

#!/bin/bash
input=$(cat)

MODEL=$(echo "$input" | jq -r '.model.display_name')
DIR=$(echo "$input" | jq -r '.workspace.current_dir')
PCT=$(echo "$input" | jq -r '.context_window.used_percentage // 0' | cut -d. -f1)

echo "[$MODEL] 📁 ${DIR##*/} | ${PCT}% context"

// 0は、値がまだ無いときの代わりの値です。

2. 実行できるようにする

chmod +x ~/.claude/statusline.sh

3. 設定に書く ~/.claude/settings.jsonに次を足します。

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

保存すると、Claude Codeが設定を読み直してスクリプトを動かします。ユーザー全体の設定（~/.claude/settings.json）にも、プロジェクトの設定にも書けます。設定ファイルの置き場所は、次の記事にまとめています。

関連記事設定と CLAUDE.mdClaude Codeの設定｜settings.jsonの場所・おすすめ設定・MCP・環境変数Claude Codeの設定は、ユーザー、プロジェクト、ローカルのsettings.jsonを編集して変えます。場所と優先順位、初期設定、おすすめの設定例、MCP、出力スタイル、権限、環境変数、学習に使われない設定、日本語、VS Codeまで公式仕様に沿って解説します。

書けるオプション

出典は公式の説明です。

スクリプトに渡される主なデータ

スクリプトは標準入力でJSONを受け取ります。公式の一覧から、よく使うものを選びました。

全部の項目は公式の一覧にあります。cost.total_cost_usdは/clearで新しいセッションになると0に戻ります。コンテキストを空ける方法は、用語集の/compactにあります。

5時間と週の枠をステータスラインに出す例と、上限に当たったときの対処は、次の記事で説明しています。

関連記事料金とプランClaude Codeの使用量の確認方法と制限のリセット｜/usage・ステータスライン・上限に当たったときの対処Claude Codeの使用量の確認方法を、/usage、/status、ステータスライン、デスクトップアプリ、claude.aiの画面ごとに解説。5時間と週の制限がいつリセットされるか、上限に当たったときの表示と対処、自動で再開する待ち方、使う量を減らすコツまで。

いつ更新されるか

スクリプトは、セッションの開始時（再開したときも）に1回動きます。そのあとは、次のときに動きます。

• 新しい返事が届いたとき
• /compactが終わったとき
• 許可モードが変わったとき
• vimモードを切り替えたとき
• 設定のcommandを変えたとき
• refreshIntervalの時間が来たとき
• 渡された利用上限の窓がresets_atの時刻に達したとき、または温まっているプロンプトキャッシュがexpires_atに達したとき

更新は300ミリ秒でまとめられ、前のスクリプトがまだ動いているときに新しい更新が来ると、前のものは打ち切られます。重い処理（git statusなど）を毎回走らせると遅くなるので、公式は結果をキャッシュする例を載せています。

表示されないとき

公式のトラブル対応から、よくある原因を並べます。

原因が分からないときは、claude --debugで起動すると、スクリプトの標準エラー出力と終了コードがログに出ます（公式のトラブル対応）。組織のポリシーが絡む場合は、次の記事も見てください。

関連記事入れる・困ったとき会社のPCにClaude Codeを入れる｜管理者権限なしのWindows、プロキシ・証明書・実行ポリシーの対処と情報システム部への確認事項会社のPCにClaude Codeを入れるときの手順と、管理者権限、プロキシ、証明書、PowerShellの実行ポリシー、WSL、managed settingsの対処を、情報システム部の担当者向けにまとめました。

出力スタイルとは何か

出力スタイルは、Claudeの役割、口調、返事の形式を、セッション全体で切り替える指示のまとまりです。毎回のプロンプトで「短く答えて」と頼まなくて済みます（公式の説明）。用語集では出力スタイルです。

何も選んでいない状態がDefaultで、ソフトウェア開発向けの標準の指示です。ほかに4つの組み込みスタイルがあり、どれもDefaultの指示を残したまま、自分の指示を足します。

Conciseは、Claude Code v2.1.237以降が必要です。Proactiveでも、許可モードは変わりません。ファイルの変更やコマンドの実行を許可するかどうかは、これまでどおり許可モードで決まります。

切り替え方

• /output-style <名前> 例えば/output-style concise。名前を付けずに実行すると一覧が出て、いまのものに印が付きます。大文字小文字は区別されません。Claude Code v2.1.269以降が必要です
• /config のOutput styleからメニューで選ぶ
• VS Code拡張 コマンドメニューのOutput stylesから選ぶ。v2.1.257以降が必要です

どの方法でも、選んだ内容はそのプロジェクトの.claude/settings.local.jsonに保存されます。設定ファイルに直接書くなら、次のとおりです。

{
  "outputStyle": "Explanatory"
}

この値は大文字小文字を区別します。 explanatoryと書くとDefaultになります。全プロジェクトの既定にしたいときは~/.claude/settings.jsonに書きますが、プロジェクトの設定のほうが優先されます。途中で切り替えると、次のメッセージから新しいスタイルになります。

自分用のスタイルを作る

出力スタイルは、フロントマター付きのMarkdownファイルです。~/.claude/output-styles（ユーザー全体）か.claude/output-styles（プロジェクト）に置きます。

---
name: Diagrams first
description: Lead every explanation with a diagram
keep-coding-instructions: true
---

When explaining code, architecture, or data flow, start with a Mermaid diagram showing the structure, then explain in prose.

keep-coding-instructions: trueは、Claude Codeの開発向けの指示を残すための指定です。開発以外の役（文章の手伝いなど）にするなら付けません。ただし、この指定が効くのは完全なシステムプロンプトのときだけです。短いほうのシステムプロンプトには開発向けの指示の部分がないので、効果がありません。完全なほうに切り替えるには、環境変数CLAUDE_CODE_SIMPLE_SYSTEM_PROMPTを0にします。ターミナルではスタイルのファイルを起動時に読むので、作ったり直したりしたあとは再起動します。

CLAUDE.mdやフックとの違い

出力スタイルは「従ってほしい指示」で、守られることを保証する仕組みではありません。使い分けは次のとおりです（公式の比較）。

出力スタイルが効くのは、メインの会話です。サブエージェントは自分のシステムプロンプトで動くので、スタイルは変わりません。

CLAUDE.mdの書き方、フック、サブエージェントは、それぞれ次の記事で説明しています。

関連記事設定と CLAUDE.mdCLAUDE.mdの書き方とテンプレート集｜置き場所・読み込み順・AGENTS.mdとの違いCLAUDE.mdの書き方は、/initでたたき台を作り、Claudeが推測できないコマンドや規約だけを200行未満で足すのが基本です。置き場所と読み込み順、AGENTS.mdとの違い、肥大化を防ぐ分け方、用途別テンプレートも紹介します。

関連記事広げるClaude Code Hooksの使い方とおすすめ例｜通知・整形・危険操作の停止Claude Code Hooksのおすすめの使い道を早見表で。Mac・Windows・Linuxの通知、編集後の自動整形、rm -rfを止めるPreToolUse。exit 2とexit 1の違いを実際に動かして確かめた結果も。

関連記事広げるClaudeサブエージェントの作り方｜使い方・並列実行・worktreeClaude Codeのサブエージェントは、独立した文脈で調査や作業を任せる仕組みです。作り方、並列処理の具体例、worktreeでの並行作業、Agent Teamsとの違いまでまとめて解説します。

画面の下の1行より大きく、会話の横のパネルや入力欄の上の帯に自分の表示を出したいときは、プラグインの一種のmodで描けます（公式の説明）。

関連記事広げるClaude Codeのmodsとは？作り方・入れ方・止め方Claude Codeのmod（モッド）を公式情報で解説。modでできること、フック・スキル・MCPとの違い、使える場所、Claudeに作ってもらう手順と入れ方、見本のmod、入れる前の安全の確かめ方、止め方、動かないときの確かめ方、会社での管理までをまとめます。

よくある質問

ステータスラインはトークンや料金を使いますか？

使いません。公式は、ステータスラインはローカルで動き、APIのトークンを使わないとしています。

ステータスラインのスクリプトは自分で書かないといけませんか？

いいえ。/statuslineに表示したい内容を頼めば、Claude Codeがスクリプトを作って設定まで書きます。手で書くのは、細かく作り込みたいときだけです。

ステータスラインが何も表示されません。

スクリプトの実行権限、標準出力に書いているか、フォルダの信頼の確認に応じたか、の3つをまず確かめます。claude --debugで起動するとエラーが見えます。

出力スタイルを変えるとコードの品質も変わりますか？

公式によると、Conciseは返事を初期状態で短くするだけで、開発の作業は同じ丁寧さで行います。詳しい説明を頼んだときや、エラーや警告のように安全のために必要な内容は、省かれません。ExplanatoryとLearningは説明が増えるぶん、返事が長くなります。

出力スタイルを設定したのに効きません。

settings.jsonのoutputStyleは大文字小文字を区別します。Explanatoryのように書いてください。小文字だとDefaultになります。