Claude Codeコマンド完全リファレンス|CLI・スラッシュコマンド・ショートカット一覧【2026年版】¶
Claude Codeは、Anthropic社が提供するAIコーディングアシスタントのCLIツールだ。本記事では、CLIコマンド・フラグ、スラッシュコマンド、キーボードショートカット、設定ファイルのすべてを活用頻度別(★5段階評価)に整理した。日常的に使う機能から優先的に習得できる構成になっている。
対象: Claude Codeを業務で使用中、またはチーム導入を検討中のエンジニア
この記事のポイント¶
- CLIコマンド・フラグを完全網羅 起動コマンドからサブエージェント定義まで、ターミナルで使う全オプションを一覧化
- スラッシュコマンド全種をカテゴリ別整理
/compact/fast/plan等のセッション内コマンドを用途別に分類 - キーボードショートカット&設定ファイル早見表 操作効率を上げるショートカットと、チーム運用に必要な設定構造をまとめ
この記事の読み方¶
| 目的 | 読むセクション |
|---|---|
| 基本コマンドを確認 | CLIコマンド → スラッシュコマンド |
| 自動化に使いたい | CLIフラグ > 出力制御 → 環境変数 → DevOpsワークフロー |
| 設定を調べたい | 設定ファイル構造 → フック設定 |
| クイックリファレンス | ショートカット一覧 → プロンプト内記法 |
2025年版からの主な変更点
2026年版では以下の機能を新規追加・更新した。
- Fast Mode(
/fast): Opus 4.6を2.5倍高速化する新モード - Agent Teams:
--agentsフラグによるマルチエージェント定義 - Skills: カスタムコマンドとスキルの統合(
.claude/skills/) - Plugins: マーケットプレイスからの拡張機能管理
- Remote Control:
claude rc//rcによるモバイル操作 /rewindの強化: 会話のみ・コードのみの選択巻き戻し/keybindings: カスタマイズ可能なキーバインド/doctor: 環境診断コマンドclaude authサブコマンド:login/status/logout--from-pr: PR番号によるセッション再開--json-schema: 構造化出力の検証--worktreeフラグ: git worktreeによる並列セッション隔離(v2.1.55〜)/simplify&/batch: バンドルスラッシュコマンド(マルチエージェントレビュー&並列変更。v2.1.63〜)- HTTPフック: URLへのJSON POSTでCI/CD連携(フックハンドラタイプ4番目)
/copyコマンド: コードブロック選択コピー(SSH対応。v2.1.59〜)/effortコマンド: effortレベル簡素化(3段階+auto)- Opus 4.6 effortデフォルト変更: Max/Teamでmediumがデフォルト化
ultrathinkキーワード再導入: 次ターンのみhigh effort/review,/pr-comments,/security-review: PR連携コマンド群- Worktree対応フック:
WorktreeCreate/WorktreeRemove InstructionsLoadedフック: CLAUDE.md読み込み検知
活用度の評価基準
- ★★★★★: 日常的に使用、業務効率に直結
- ★★★★☆: 頻繁に使用、特定の用途で高い価値
- ★★★☆☆: 定期的に使用、状況に応じて有用
- ★★☆☆☆: 限定的な用途、特殊ケース向け
CLIコマンド(ターミナルから実行)¶
ターミナルで claude コマンドを実行する際の基本コマンドとサブコマンドの一覧。
| コマンド | 説明 | 活用度 |
|---|---|---|
claude | 対話セッションを開始 | ★★★★★ |
claude "質問" | 初期プロンプト付きで開始 | ★★★★★ |
claude -p "質問" | 非対話モードで実行し終了 | ★★★★★ |
cat file \| claude -p "質問" | パイプで入力を渡す | ★★★★☆ |
claude -c | 直近のセッションを再開 | ★★★★★ |
claude -r "ID" | 指定IDのセッションを再開 | ★★★☆☆ |
claude update | 最新版にアップデート | ★★★★☆ |
claude mcp | MCPサーバーを管理 | ★★★★☆ |
claude auth login | 認証(ログイン) | ★★★☆☆ |
claude auth status | 認証状態の確認 | ★★★☆☆ |
claude auth logout | ログアウト | ★★☆☆☆ |
claude agents | 設定済みエージェント一覧 | ★★★☆☆ |
claude rc | Remote Controlセッションを起動 | ★★★☆☆ |
claude plugin / claude plugins | プラグイン管理CLI(pluginsはalias) | ★★★☆☆ |
セッション管理のポイント
claude -c(continue)はカレントディレクトリの直近セッションを再開する。別ディレクトリのセッションに戻りたい場合は -r でセッションIDを指定する。--from-pr を使えば、特定のPull Requestに紐づくセッションを直接再開できる。
次のセクションでは、起動時にフラグで挙動を制御する方法を見ていく。
CLIフラグ(起動時オプション)¶
起動時にフラグを付与することで、Claude Codeの挙動を細かく制御できる。用途別に整理した。
セッション制御¶
| フラグ | 説明 | 活用度 |
|---|---|---|
--continue, -c | 直近セッションを再開 | ★★★★★ |
--resume, -r | ID指定でセッション再開 | ★★★☆☆ |
--from-pr <PR> | PR番号またはURLでセッション再開 | ★★★★☆ |
--fork-session | 再開時に新セッションIDで分岐 | ★★★☆☆ |
--session-id <UUID> | セッションIDを明示指定 | ★★☆☆☆ |
--max-turns N | 非対話モードのターン数上限 | ★★★★☆ |
--worktree, -w | git worktreeを作成しセッションを隔離(並列開発の基盤機能。名前省略でランダム生成) | ★★★★★ |
--tmux | tmuxセッション内でClaude Codeを起動(--worktreeと組み合わせて並列セッション管理) | ★★★☆☆ |
モデル・モード制御¶
| フラグ | 説明 | 活用度 |
|---|---|---|
--model <name> | モデルを指定(sonnet, opus, haikuまたはフル名) | ★★★★☆ |
--fallback-model <name> | 過負荷時の自動フォールバックモデル(printモードのみ) | ★★★☆☆ |
--permission-mode <mode> | 起動時の権限モードを指定(plan等) | ★★★☆☆ |
出力制御¶
| フラグ | 説明 | 活用度 |
|---|---|---|
--output-format json | JSON形式で出力 | ★★★★★ |
--output-format stream-json | ストリーミングJSON出力 | ★★★☆☆ |
--output-format text | テキスト形式(デフォルト) | ★★★★☆ |
--json-schema '<json>' | エージェント完了後に指定スキーマでJSON検証(printモードのみ) | ★★★☆☆ |
--verbose | 詳細ログ(ターンごとの出力を表示) | ★★★★☆ |
--input-format <format> | 入力形式を指定(text, stream-json) | ★★☆☆☆ |
--include-partial-messages | ストリーミング途中イベントも出力 | ★★☆☆☆ |
システムプロンプト制御¶
Claude Codeでは3種類のシステムプロンプトフラグを用途に応じて使い分ける。
| フラグ | 動作 | モード | 活用度 |
|---|---|---|---|
--system-prompt "..." | デフォルトプロンプトを完全置換 | 対話+print | ★★★☆☆ |
--system-prompt-file <path> | ファイル内容でプロンプトを完全置換 | printのみ | ★★★☆☆ |
--append-system-prompt "..." | デフォルトプロンプトの末尾に追記 | 対話+print | ★★★★☆ |
--system-prompt と --system-prompt-file は併用不可
ほとんどのケースでは --append-system-prompt が安全。デフォルトのClaude Code機能を維持しつつカスタム指示を追加できる。--system-prompt はデフォルト指示がすべて消えるため、完全な制御が必要な場合のみ使用する。
セキュリティ・権限制御¶
| フラグ | 説明 | 活用度 |
|---|---|---|
--allowedTools <tools> | 追加で許可するツール | ★★★★★ |
--disallowedTools <tools> | 追加で禁止するツール | ★★★☆☆ |
--dangerously-skip-permissions | 全権限チェックをスキップ(sandbox改善により非推奨度が増加) | ★★☆☆☆ |
--permission-prompt-tool <tool> | 非対話モードでの権限プロンプト処理ツール指定 | ★★☆☆☆ |
--tools <tools> | ビルトインツールの使用リストを明示指定("" で全無効、"default" で全有効) | ★★☆☆☆ |
--dangerously-skip-permissions の使用条件
信頼できるコンテナ環境でのみ使用すること。→ 詳細は自動承認の安全運用ガイドで解説
エージェント・拡張¶
| フラグ | 説明 | 活用度 |
|---|---|---|
--agent <name> | セッションで使用するエージェントを指定 | ★★★☆☆ |
--agents '<json>' | カスタムサブエージェントをJSON定義 | ★★★★★ |
--add-dir <path> | 追加ワーキングディレクトリを指定(複数可) | ★★★☆☆ |
--mcp-config <path> | MCPサーバー設定をJSONファイルから読み込み | ★★★☆☆ |
--strict-mcp-config | --mcp-configのみ使用し他MCP設定を無視 | ★★☆☆☆ |
--plugin-dir <path> | セッション限定でプラグインディレクトリを追加 | ★★☆☆☆ |
--teleport | リモート接続でセッションを転送 | ★★☆☆☆ |
--agentsフラグの形式¶
--agentsフラグはJSONオブジェクトで1つ以上のサブエージェントを定義する。
| フィールド | 必須 | 説明 |
|---|---|---|
description | Yes | サブエージェントの用途説明 |
prompt | Yes | サブエージェントのシステムプロンプト |
tools | - | 使用可能ツール配列(省略時は全ツール継承) |
model | - | モデル指定(sonnet, opus, haiku) |
claude --agents '{
"code-reviewer": {
"description": "コード変更後に自動レビュー",
"prompt": "セキュリティ、パフォーマンス、ベストプラクティスに焦点を当てたコードレビューを行う。",
"tools": ["Read", "Grep", "Glob", "Bash"],
"model": "sonnet"
},
"debugger": {
"description": "エラーとテスト失敗のデバッグ専門",
"prompt": "エラーの根本原因を特定し修正案を提示する。"
}
}'
デバッグ・診断¶
| フラグ | 説明 | 活用度 |
|---|---|---|
--debug | デバッグモード有効化(カテゴリフィルタ可) | ★★★☆☆ |
--debug "api,mcp" | 特定カテゴリのみデバッグ | ★★★☆☆ |
--debug "!statsig,!file" | 特定カテゴリを除外 | ★★☆☆☆ |
その他¶
| フラグ | 説明 | 活用度 |
|---|---|---|
--ide | 起動時にIDEへ自動接続(有効なIDEが1つの場合) | ★★☆☆☆ |
--setting-sources <list> | 読み込む設定ソースをカンマ区切りで指定 | ★★☆☆☆ |
--settings <path> | 追加の設定JSONファイルまたはJSON文字列 | ★★☆☆☆ |
--version, -v | バージョン表示 | ★★☆☆☆ |
--betas <headers> | ベータヘッダーの指定(APIキーユーザー向け) | ★★☆☆☆ |
CLIフラグの全容を把握したところで、次はセッション内で使うスラッシュコマンドを見ていく。
設定管理コマンド¶
| コマンド | 説明 | 活用度 |
|---|---|---|
claude config list | すべての設定を表示 | ★★★☆☆ |
claude config get <key> | 特定の設定を取得 | ★★★☆☆ |
claude config set <key> <value> | 設定を更新 | ★★★☆☆ |
MCPサーバー管理コマンド¶
| コマンド | 説明 | 活用度 |
|---|---|---|
claude mcp | 対話的なMCPサーバー追加(ステップバイステップ) | ★★★★☆ |
claude mcp list | 設定済みMCPサーバー一覧 | ★★★★☆ |
claude mcp add <n> <cmd> | MCPサーバー追加(stdioトランスポート) | ★★★★★ |
claude mcp add --transport sse <n> <url> | SSEトランスポートでMCPサーバー追加 | ★★★☆☆ |
claude mcp add --transport http <n> <url> | HTTPトランスポートでMCPサーバー追加 | ★★★☆☆ |
claude mcp add-json <n> '<json>' | JSON定義でMCPサーバー追加 | ★★★★☆ |
claude mcp add-from-claude-desktop | Claude Desktop設定をインポート | ★★★☆☆ |
claude mcp remove <n> | MCPサーバー削除 | ★★★☆☆ |
claude mcp serve | Claude Code自体をMCPサーバーとして起動 | ★★★☆☆ |
OAuth対応MCPサーバーの追加
Dynamic Client Registrationに非対応のMCPサーバー(Slack等)は --client-id と --client-secret を指定して追加する。
# GitHub連携を追加
claude mcp add github -- npx -y @modelcontextprotocol/server-github
# スコープ指定で追加(ユーザースコープ)
claude mcp add github -s user \
-e GITHUB_PERSONAL_ACCESS_TOKEN=your-token \
-- npx -y @modelcontextprotocol/server-github
# 設定を確認
claude mcp list
→ MCPの詳細はMCP統合戦略を参照
スラッシュコマンド(セッション内コマンド)¶
Claudeとの対話セッション中に / から始めて実行するコマンド。/ を入力すると一覧が表示され、続けてタイプすることでフィルタできる。
プロジェクト管理系¶
| コマンド | 説明 | 活用度 |
|---|---|---|
/init | CLAUDE.mdを自動生成 | ★★★★★ |
/memory | メモリファイル(CLAUDE.md)を編集 | ★★★★☆ |
/context | コンテキストウィンドウの使用状況を可視化 | ★★★★☆ |
/compact | コンテキストを圧縮(保持情報を指定可能) | ★★★★☆ |
/clear | 会話履歴をリセット(CLAUDE.mdは保持) | ★★★★★ |
/resume | 過去セッションの再開(引数なしでピッカー表示。50件表示、ブランチ検索対応、Rでリネーム可) | ★★★★☆ |
/fork | 現在の会話をフォーク(分岐)して新セッション生成 | ★★★☆☆ |
/rename | セッション名を変更(引数なしで自動生成) | ★★☆☆☆ |
/add-dir <path> | 追加ディレクトリをコンテキストに追加 | ★★★☆☆ |
/copy | コードブロック選択コピー(wキーでファイル書き出し可。SSH環境で特に有用) | ★★★★☆ |
/compact の使い分け
/compact は保持したい情報を引数で指定できる(例: /compact エラーハンドリングのパターンを保持)。コンテキスト使用量が80%を超えたら /compact、タスク切り替え時は /clear が基本。v2.0.64以降、compactionは即座に完了する。
情報確認系¶
| コマンド | 説明 | 活用度 |
|---|---|---|
/usage | プラン上限に対するトークン使用量を確認 | ★★★★★ |
/cost | 現在セッションのコスト(トークン数・金額)を表示 | ★★★★★ |
/help | 利用可能なコマンド一覧(カスタム・MCP含む) | ★★★★☆ |
/tasks | バックグラウンドタスクの確認 | ★★★★☆ |
/doctor | 環境診断(API接続、Node.jsバージョン、認証、MCP状態等を一括チェック) | ★★★☆☆ |
/stats | 利用統計をHTML形式でレポート生成 | ★★★☆☆ |
/debug | 現在セッションのトラブルシュート情報を表示 | ★★★☆☆ |
/effort <level> | 思考レベルの切り替え(low/medium/high、/effort autoでデフォルトリセット)。シンボル: ○ ◐ ● | ★★★★☆ |
/extra-usage | 追加使用量の有効化 | ★★★☆☆ |
モード・モデル制御系¶
| コマンド | 説明 | 活用度 |
|---|---|---|
/model | 使用モデルを切り替え(sonnet, opus, haiku) | ★★★★☆ |
/fast | Fast Modeのオン/オフ切り替え(Opus 4.6を2.5倍高速化) | ★★★★☆ |
/plan [description] | Plan Modeのオン/オフ(読み取り専用で計画を立てる。オプション引数でdescription指定可→即座に計画開始) | ★★★★★ |
/vim | Vimスタイル編集モードの切り替え | ★★☆☆☆ |
/output-style | 出力スタイルの変更 | ★★☆☆☆ |
Fast Mode について
Fast Modeは「別モデル」ではなく、同じOpus 4.6を速度優先のAPI設定で動かす仕組み。対話的な高速イテレーションやライブデバッグ向き。コスト重視のときはオフにする。セッション中にオンにした場合、以前のコンテキスト全体がFast Mode料金で再計算される点に注意。
effortデフォルトの変更(2026年3月〜): Opus 4.6ではMax/Teamサブスクライバーのeffortデフォルトがmediumになった(従来はhigh)。/effort highまたはultrathinkキーワードで明示的にhighに設定できる。/effort autoでデフォルトに戻す。
機能管理系¶
| コマンド | 説明 | 活用度 |
|---|---|---|
/hooks | フック設定・管理 | ★★★★★ |
/agents | サブエージェント作成・管理 | ★★★★★ |
/permissions | 権限設定の変更 | ★★★★☆ |
/sandbox | サンドボックス実行モードの有効化 | ★★★★☆ |
/config | 設定インターフェースを開く(20以上の設定項目) | ★★★☆☆ |
/login | 認証の再実行 | ★★☆☆☆ |
/rewind | 会話および/またはコード変更を巻き戻す | ★★★★☆ |
/rewind の強化(2026年)
/rewind は2026年のアップデートで会話のみ巻き戻しとコードのみ巻き戻しを選択できるようになった。Esc x 2 で巻き戻しメニューが表示され、「Rewind code only」を選ぶとコード変更だけがリバートされ、会話履歴は維持される。実験的なリファクタリングの試行錯誤に便利。
→ フックの詳細はHooks完全ガイド、権限の詳細は権限管理概要を参照
統合・拡張系¶
| コマンド | 説明 | 活用度 |
|---|---|---|
/install-github-app | GitHub PR自動レビュー設定 | ★★★★☆ |
/plugin | プラグイン管理(追加・削除・マーケットプレイス) | ★★★☆☆ |
/mcp | MCPステータス確認・OAuth認証 | ★★★★☆ |
/rc | 現在のセッションをRemote Controlに切り替え | ★★★☆☆ |
/review <PR#> | 指定PRのコードレビュー(gh CLI必須) | ★★★★☆ |
/pr-comments | 現在ブランチのPRコメント表示(gh CLI連携) | ★★★☆☆ |
/security-review | 未コミット変更のセキュリティ監査(古いgitの--merge-baseエラーは修正済) | ★★★★☆ |
/skills | スキル管理メニュー(プラグイン名付きスキル表示) | ★★★☆☆ |
バンドルコマンド系(v2.1.63〜)¶
複数エージェントが協調して動くコマンド群。PR前の品質保証や大規模変更に活用する。
| コマンド | 説明 | 活用度 |
|---|---|---|
/simplify | 3エージェントレビューパイプライン(アーキテクチャ問題・重複ロジック・パフォーマンス非効率を検出。PR前に実行推奨) | ★★★★★ |
/batch | 大規模並列変更(worktree隔離で並行実行→計画→Worker並列起動→PR自動作成。マイグレーション、パターン適用等) | ★★★★★ |
環境設定系¶
| コマンド | 説明 | 活用度 |
|---|---|---|
/terminal-setup | Shift+Enterのキーバインドを設定(VS Code, Alacritty, Zed, Warp用) | ★★★☆☆ |
/keybindings | キーバインド設定ファイルを開く/作成 | ★★★☆☆ |
/status-line | ターミナルステータスラインを設定 | ★★☆☆☆ |
カスタムスラッシュコマンド(Skills)¶
2026年版では、従来のカスタムコマンド(.claude/commands/)とSkills(.claude/skills/)が統合された。既存の .claude/commands/ ファイルは引き続き動作する。Skillsはコマンドに加え、フロントマターで自動呼び出し制御やサポートファイルの管理が可能。
| 場所 | 説明 | 活用度 |
|---|---|---|
.claude/skills/<name>/SKILL.md | プロジェクトスキル(チーム共有) | ★★★★★ |
~/.claude/skills/<name>/SKILL.md | 個人スキル | ★★★★☆ |
.claude/commands/<name>.md | 従来形式コマンド(互換維持) | ★★★★☆ |
~/.claude/commands/<name>.md | 個人用コマンド(互換維持) | ★★★☆☆ |
SkillsはAgent Skills オープンスタンダードに準拠しており、複数のAIツール間で共有できる設計になっている。
→ スキル設計の詳細はカスタムスラッシュコマンド設計ガイドを参照
スラッシュコマンドを使いこなしたら、次はキーボードショートカットで操作効率を上げていく。
キーボードショートカット¶
インタラクティブモード中の操作で使用するショートカット。
基本操作¶
| ショートカット | 説明 | 活用度 |
|---|---|---|
Esc | 処理を停止 | ★★★★★ |
Esc x 2 | 巻き戻しメニュー(会話/コードの選択巻き戻し) | ★★★★☆ |
Enter | メッセージ送信 | ★★★★★ |
Shift+Enter | 改行を挿入(iTerm2, WezTerm, Ghostty, Kittyはデフォルト対応。他は /terminal-setup が必要) | ★★★★☆ |
\ + Enter | 改行を挿入(全ターミナル共通) | ★★★★☆ |
Up | コマンド履歴を参照 | ★★★★☆ |
Ctrl+C | セッション完全終了(2回押し) | ★★★☆☆ |
Ctrl+F | バックグラウンドエージェント全停止 | ★★★☆☆ |
Ctrl+R | コマンド履歴を逆検索 | ★★★☆☆ |
Ctrl+Y | readline式ペースト(削除テキスト貼り付け) | ★★☆☆☆ |
Ctrl+S | プロンプトスタッシュ(一時退避) | ★★☆☆☆ |
? | 利用可能なショートカット一覧を表示 | ★★★☆☆ |
モード切り替え¶
| ショートカット | 説明 | 活用度 |
|---|---|---|
Shift+Tab | モード循環(normal → auto-accept → plan) | ★★★★★ |
Tab | 拡張思考のオン/オフ切り替え(セッション間で保持) | ★★★★☆ |
Ctrl+T | タスクリスト表示の切り替え | ★★★☆☆ |
Ctrl+O | Verbose表示のオン/オフ(思考内容を表示) | ★★★☆☆ |
Ctrl+G | プランを外部テキストエディタで開く | ★★★☆☆ |
Shift+Down | Agent Teamsのteammate間ナビゲーション | ★★★☆☆ |
モード切り替えの理解
Shift+Tab を押すたびに normal-mode → auto-accept on → plan mode on の順に切り替わる。現在のモードはプロンプト下部に表示される。
ファイル・画像操作¶
| ショートカット | 説明 | 活用度 |
|---|---|---|
Shift + ドラッグ | ファイルを参照として追加 | ★★★★☆ |
Ctrl+V | クリップボードから画像貼り付け | ★★☆☆☆ |
キーバインドのカスタマイズ¶
/keybindings で ~/.claude/keybindings.json を作成・編集できる。変更はClaude Code再起動なしで即座に反映される。
{
"$schema": "https://www.schemastore.org/claude-code-keybindings.json",
"bindings": [
{
"context": "Chat",
"bindings": {
"ctrl+e": "chat:externalEditor",
"ctrl+u": null
}
}
]
}
利用可能なアクションは chat:submit, app:toggleTodos, chat:externalEditor など多数。null を指定するとデフォルトバインドを無効化できる。
プロンプト内記法¶
メッセージ入力時に使用する特殊記法。
| 記法 | 説明 | 活用度 |
|---|---|---|
@<ファイル名> | ファイルまたはディレクトリを参照(行範囲指定も可) | ★★★★★ |
@terminal:<name> | ターミナル出力を参照(VS Code拡張) | ★★★☆☆ |
#<内容> | CLAUDE.mdに内容を追加(保存先選択あり) | ★★★★★ |
!<コマンド> | シェルコマンドを直接実行 | ★★★★☆ |
& <タスク> | バックグラウンドでタスクを実行 | ★★★☆☆ |
@src/main.py を参照して、エラーハンドリングを改善してください
#このプロジェクトではPEP8に準拠したコードスタイルを使用
!git status
& npm run dev
拡張思考(Extended Thinking)¶
拡張思考はデフォルトで有効。Opus 4.6ではAdaptive Reasoning(努力レベルに応じた動的な思考トークン割り当て)が導入されている。
| 制御方法 | 説明 | 活用度 |
|---|---|---|
Tab | セッション中に拡張思考をオン/オフ(セッション間で保持) | ★★★★★ |
Ctrl+O | 思考内容の表示/非表示(verbose表示) | ★★★★☆ |
CLAUDE_CODE_EFFORT_LEVEL 環境変数 | low / medium / high で思考レベルを制御 | ★★★★☆ |
カスタムコマンド(Skills)内の特殊記法¶
| 記法 | 説明 | 活用度 |
|---|---|---|
$ARGUMENTS | スラッシュコマンド内で引数を受け取る | ★★★★★ |
$1, $2, ... | 引数のプレースホルダー(順番指定) | ★★★★☆ |
!`command` | スキル内でコマンドの実行結果を埋め込む | ★★★★☆ |
---
argument-hint: [issue-number] [priority]
description: GitHub Issueを修正
allowed-tools: Bash(git:*), Read, Edit
---
## コンテキスト
- 現在のgit status: !`git status`
- 現在のブランチ: !`git branch --show-current`
Issue #$1 を優先度 $2 で修正してください。
設定ファイル・ディレクトリ構造¶
Claude Codeの設定は以下の7つのレイヤーで構成されています。
- CLAUDE.md: Claudeへのプロジェクト別指示書(チーム共有 / 個人用)
- Auto Memory: 会話内容から自動で学習するメモ(
~/.claude/projects/<project>/memory/) .claude/rules/: 条件別に切り出されたモジュール型のルールファイルsettings.json: 権限、許可ツール、フック設定、環境変数- Hooks: ターミナルコマンドやスクリプトを自動化するライフサイクルイベント
- Skills: カスタムスラッシュコマンドやサポートファイル群
- MCP: 外部ツール(GitHub, DB, Sentry等)とのコンテキスト連携設定
ベストプラクティス構成¶
your-project/
├── CLAUDE.md # 共同のプロジェクト指示書(git管理)
├── CLAUDE.local.md # 個人用指示書(.gitignore推奨)
├── .mcp.json # チーム共有MCP設定(git管理)
├── .claude/ # Claude Code管理ディレクトリ
│ ├── settings.json # プロジェクト共有設定(git管理)
│ ├── settings.local.json # プロジェクト個人設定(.gitignore推奨)
│ ├── rules/ # モジュール型ルール(git管理)
│ │ ├── code-style.md
│ │ └── security.md
│ ├── skills/ # カスタムスキル(git管理)
│ │ └── review-pr/
│ │ └── SKILL.md
│ ├── agents/ # サブエージェント(git管理)
│ └── hooks/ # Hook用スクリプト(git管理)
└── ...
Auto Memory(自動学習)の制御¶
Claude Codeは作業履歴から文脈や決定事項を ~/.claude/projects/<project>/memory/ に自動保存します。MEMORY.md(インデックス)は 最初の200行のみロードされるため、長くなるとClaudeが自動的にトピック別ファイルへ分割します。
# 一時的な強制無効化(環境変数)
CLAUDE_CODE_DISABLE_AUTO_MEMORY=1 claude
// .claude/settings.json でプロジェクト単位で恒久的に無効化する場合
{
"autoMemoryEnabled": false
}
設定の優先順位¶
設定は以下の順序で優先される(上が最優先):
| 優先度 | 設定ソース | 説明 |
|---|---|---|
| 1(最高) | Managed(管理者設定) | managed-settings.json(企業管理者が配置) |
| 2 | CLIオプション | 起動時の --model 等のコマンドライン引数 |
| 3 | Local(ローカル) | .claude/settings.local.json(Git管理外の個人設定) |
| 4 | Project(プロジェクト) | .claude/settings.json(チーム共有設定) |
| 5(最低) | User(ユーザー) | ~/.claude/settings.json(グローバル個人設定) |
プロジェクト固有(チーム共有)¶
| ファイル/ディレクトリ | 説明 | 活用度 |
|---|---|---|
CLAUDE.md | プロジェクトコンテキスト・ルール定義(<!-- -->コメントはClaude自動インジェクト時には非表示。Readツール明示読み込み時は表示) | ★★★★★ |
.claude/settings.json | プロジェクト設定(権限・フック・ツール。git worktree間で共有) | ★★★★☆ |
.claude/commands/ | カスタムスラッシュコマンド | ★★★★★ |
.claude/skills/ | スキル定義(SKILL.md+サポートファイル) | ★★★★★ |
.claude/agents/ | サブエージェント定義(worktree isolation、memoryフロントマター等の拡張対応) | ★★★★★ |
.claude/rules/ | ルールファイルの分割管理 | ★★★★☆ |
.claude/worktrees/ | worktree作業ディレクトリ(自動生成) | ★★★★☆ |
.mcp.json | MCPサーバー設定 | ★★★★★ |
個人用(ローカル)¶
| ファイル/ディレクトリ | 説明 | 活用度 |
|---|---|---|
.claude/settings.local.json | ローカル個人設定(Git管理外) | ★★★★☆ |
~/.claude/CLAUDE.md | グローバルコンテキスト | ★★★☆☆ |
~/.claude/commands/ | 個人用スラッシュコマンド | ★★★★☆ |
~/.claude/skills/ | 個人用スキル | ★★★☆☆ |
~/.claude/agents/ | 個人用サブエージェント | ★★★☆☆ |
~/.claude/settings.json | ユーザーグローバル設定 | ★★★☆☆ |
~/.claude/keybindings.json | カスタムキーバインド設定 | ★★★☆☆ |
コミット・PRの帰属表示(Attribution)の制御¶
Claude Codeはデフォルトで、コマンドからのGitコミットやPR作成時に Co-Authored-By: Claude といった帰属表示(Attribution)を自動付与します。 不要な場合や、チーム規則に合わせて独自のメッセージに変更したい場合は、.claude/settings.json(または settings.local.json)の "attribution" フィールドで制御します。
{
"attribution": {
"commit": "", // 空文字で完全に非表示
"pr": "Claude Codeで生成" // カスタムメッセージの指定も可能
}
}
~/.claude/settings.json に設定すれば、全プロジェクトでこの挙動が有効になります。フック設定¶
.claude/settings.json 内で設定するフックイベント(全19種)。
コアイベント¶
| フックイベント | 説明 | 活用度 |
|---|---|---|
PreToolUse | ツール使用前に実行 | ★★★★☆ |
PostToolUse | ツール使用後に自動実行 | ★★★★★ |
PostToolUseFailure | ツール使用失敗時に実行 | ★★★☆☆ |
Stop | セッション終了時に実行 | ★★★☆☆ |
セッション・権限イベント¶
| フックイベント | 説明 | 活用度 |
|---|---|---|
SessionStart | セッション開始時 | ★★★☆☆ |
SessionEnd | セッション完全終了時 | ★★☆☆☆ |
UserPromptSubmit | プロンプト送信時 | ★★★☆☆ |
PermissionRequest | 権限リクエスト時 | ★★★☆☆ |
Notification | 通知発生時 | ★★☆☆☆ |
InstructionsLoaded | CLAUDE.mdまたは.claude/rules/*.mdがコンテキストに読み込まれた時 | ★★★☆☆ |
ConfigChange | 設定変更時 | ★★☆☆☆ |
サブエージェント・タスクイベント¶
| フックイベント | 説明 | 活用度 |
|---|---|---|
SubagentStart | サブエージェント起動時 | ★★★☆☆ |
SubagentStop | サブエージェント終了時 | ★★★☆☆ |
TeammateIdle | Agent Teamsでチームメイトがアイドル状態 | ★★★☆☆ |
TaskCompleted | タスク完了時(/batch連携で完了通知に重要) | ★★★★☆ |
PreCompact | コンテキスト圧縮前 | ★★☆☆☆ |
ワークツリー系イベント(新カテゴリ)¶
| フックイベント | 説明 | 活用度 |
|---|---|---|
WorktreeCreate | worktree作成時(カスタムVCSセットアップ対応) | ★★★☆☆ |
WorktreeRemove | worktree削除時 | ★★☆☆☆ |
フックハンドラタイプ¶
| タイプ | 説明 | 主な用途 |
|---|---|---|
command | シェルコマンドを実行 | Linter、フォーマッター実行 |
prompt | Claudeに追加プロンプトを送信 | 自動フィードバック |
agent | サブエージェントを起動 | 専門エージェントへの委譲 |
http | URLにJSON POSTし、JSONレスポンスを受信(allowedEnvVarsで環境変数展開可) | CI/CD統合、ステートレスバックエンド連携 |
→ フックの詳細はClaude Code Hooks完全ガイドを参照
企業管理者向け設定(Managed Settings)¶
| OS | パス |
|---|---|
| macOS | /Library/Application Support/ClaudeCode/managed-settings.json |
| Linux | /etc/claude-code/managed-settings.json |
環境変数¶
| 環境変数 | 説明 | デフォルト値 | 活用度 |
|---|---|---|---|
CLAUDE_CODE_EFFORT_LEVEL | 思考レベル(low / medium / high)。Opus 4.6ではMax/Teamサブスクライバーでmediumがデフォルト | high | ★★★★★ |
CLAUDE_CODE_DISABLE_AUTO_MEMORY | Auto Memory(自動学習)機能を強制的に無効化する | 0 | ★★★★☆ |
MAX_MCP_OUTPUT_TOKENS | MCPツール出力の最大トークン数 | 25000 | ★★★☆☆ |
CLAUDE_CODE_MAX_OUTPUT_TOKENS | モデル出力の最大トークン数 | 32000 | ★★★☆☆ |
BASH_DEFAULT_TIMEOUT_MS | Bashコマンドのデフォルトタイムアウト(ms) | 120000 | ★★★☆☆ |
BASH_MAX_TIMEOUT_MS | Bashコマンドの最大タイムアウト(ms) | 600000 | ★★☆☆☆ |
SLASH_COMMAND_TOOL_CHAR_BUDGET | スキル説明の文字バジェットを上書き | 動的(コンテキストの2%) | ★★☆☆☆ |
CLAUDE_CODE_DISABLE_CRON | スケジュールcronジョブを即座に停止 | (未設定) | ★★☆☆☆ |
ENABLE_CLAUDEAI_MCP_SERVERS | claude.ai MCPサーバーの利用可否 | true | ★★★☆☆ |
CLAUDE_CODE_DISABLE_1M_CONTEXT | 1Mコンテキストを無効化 | (未設定) | ★★☆☆☆ |
ENABLE_TOOL_SEARCH | ツール検索の有効化。auto:N構文で閾値制御(auto:5=5%コンテキスト、auto:10=デフォルト) | auto:10 | ★★★☆☆ |
CLAUDE_CODE_DISABLE_TERMINAL_TITLE | ターミナルタイトル変更を無効化 | (未設定) | ★★☆☆☆ |
環境変数は settings.json 内の env フィールドでも設定でき、チーム全体への配布にはこちらが便利。
DevOps実践ワークフロー¶
1. プロジェクト初期化¶
cd /path/to/project
claude
セッション内で:
/init
2. CI/CD統合¶
claude -p "セキュリティ脆弱性をレビュー" \
--output-format json \
--allowedTools Read,Grep,Glob \
--max-turns 3 > security_report.json
構造化出力が必要な場合は --json-schema を追加:
claude -p "コード品質を分析" \
--json-schema '{"type":"object","properties":{"score":{"type":"number"},"issues":{"type":"array"}}}' \
--max-turns 5
3. チーム標準化¶
# スキルとコマンドをGitで共有
git add .claude/ CLAUDE.md .mcp.json
git commit -m "Add Claude Code team configuration"
4. 外部連携設定¶
# MCPサーバーを追加
claude mcp add github -- npx -y @modelcontextprotocol/server-github
# 設定をコミット
git add .mcp.json
git commit -m "Add MCP server configuration"
カスタムスキル作成例¶
.claude/skills/review/SKILL.md の例:
---
name: review
description: セキュリティ、パフォーマンス、保守性に焦点を当てたコードレビュー。コード変更後に自動呼び出し。
allowed-tools: Read, Grep, Glob, Bash(git diff:*)
argument-hint: [file-or-directory]
---
以下の観点でコードレビューを行う:
1. セキュリティ脆弱性
2. パフォーマンス問題
3. コード品質と保守性
4. テストカバレッジ
対象: $ARGUMENTS
使用方法:
/review src/authentication.py
スキルは description の内容に基づいてClaudeが自動的に呼び出すこともできる。自動呼び出しを無効にするにはフロントマターに disable-model-invocation: true を追加する。
Skillsフロントマター拡張記法¶
| フロントマター | 説明 |
|---|---|
context: fork | スキルを隔離されたサブエージェントで実行(会話履歴へのアクセスなし) |
isolation: worktree | サブエージェント/エージェントをgit worktreeで隔離実行 |
agent: <name> | 使用するサブエージェントを指定(Explore, Plan, カスタム名等) |
memory: user/project/local | エージェントの永続メモリスコープを指定 |
disable-model-invocation: true | モデルによる自動呼び出しを無効化 |
よくある質問(FAQ)¶
Q: Claude Codeの料金・コストを確認するには?
セッション中は /cost で現在のセッションコスト(入力トークン、出力トークン、金額)を確認できる。プランの使用量上限に対する進捗は /usage で確認する。
Q: Fast Modeはいつ使うべき?
対話的な高速イテレーション(ライブデバッグ、連続的なコード修正)に向いている。バッチ処理やCI/CDなどコスト重視の場面では通常モードを推奨。Fast Modeの料金は通常Opus 4.6の約2倍。
Q: 前回の作業を続けるには?
claude -c で直近セッション、claude -r <ID> で特定セッション、claude --from-pr <番号> でPR紐づきセッションをそれぞれ再開できる。セッション内からは /resume でピッカーを表示。
Q: チームでClaude Codeの設定を共有するには?
.claude/ ディレクトリ、CLAUDE.md、.mcp.json をGitにコミットする。個人設定は .claude/settings.local.json(gitignore推奨)に分離する。
Q: 危険なコマンドの実行を防ぐには?
.claude/settings.json の permissions.deny で禁止パターンを指定する。CI/CD環境では --allowedTools で許可ツールを明示的に制限する。
Q: worktreeとは?いつ使う?
claude --worktree feature-auth で隔離されたgit worktreeを作成しセッションを起動する。複数タスクを並列処理する際、互いのコード変更が干渉しない。サブエージェントには isolation: worktree フロントマターで適用可能。変更なしで終了した場合は自動クリーンアップされる。/batch コマンドの内部でも活用されている。
Q: /simplifyと/batchの違いは?
/simplify はPR前の品質チェック(3エージェントレビューパイプライン)。アーキテクチャ問題・重複ロジック・パフォーマンス非効率を検出する。/batch は大規模な変更を複数worktreeで並行実行しPRを自動作成するバッチ処理。マイグレーションやパターン適用等に向いている。
Q: Opus 4.6のeffortデフォルトが変わったのはなぜ?
Max/Teamサブスクライバーでは、Opus 4.6のeffortデフォルトがhighからmediumになった。コスト効率の改善が目的。/effort high や会話中の ultrathink キーワードで次のターンだけhigh effortに設定できる。/effort auto でデフォルト(medium)に戻る。CLAUDE_CODE_EFFORT_LEVEL 環境変数で常時overrideも可能。
次のステップ¶
関連記事¶
日常開発を効率化するTips
イベント駆動自動化の基礎から応用まで
安全な自動許可モードの運用
スキルの設計パターンと実践例
参考リンク¶
- Claude Code 公式ドキュメント
- CLI Reference
- Interactive Mode
- Slash Commands / Skills
- Common Workflows
- Fast Mode
- Hooks Documentation
- MCP Integration
- Settings