コンテンツにスキップ

Claude Code 完全ガイド

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 mcpMCPサーバーを管理★★★★☆
claude auth login認証(ログイン)★★★☆☆
claude auth status認証状態の確認★★★☆☆
claude auth logoutログアウト★★☆☆☆
claude agents設定済みエージェント一覧★★★☆☆
claude rcRemote Controlセッションを起動★★★☆☆
claude plugin / claude pluginsプラグイン管理CLI(pluginsはalias)★★★☆☆

セッション管理のポイント

claude -c(continue)はカレントディレクトリの直近セッションを再開する。別ディレクトリのセッションに戻りたい場合は -r でセッションIDを指定する。--from-pr を使えば、特定のPull Requestに紐づくセッションを直接再開できる。

次のセクションでは、起動時にフラグで挙動を制御する方法を見ていく。


CLIフラグ(起動時オプション)

起動時にフラグを付与することで、Claude Codeの挙動を細かく制御できる。用途別に整理した。

セッション制御

フラグ説明活用度
--continue, -c直近セッションを再開★★★★★
--resume, -rID指定でセッション再開★★★☆☆
--from-pr <PR>PR番号またはURLでセッション再開★★★★☆
--fork-session再開時に新セッションIDで分岐★★★☆☆
--session-id <UUID>セッションIDを明示指定★★☆☆☆
--max-turns N非対話モードのターン数上限★★★★☆
--worktree, -wgit worktreeを作成しセッションを隔離(並列開発の基盤機能。名前省略でランダム生成)★★★★★
--tmuxtmuxセッション内でClaude Codeを起動(--worktreeと組み合わせて並列セッション管理)★★★☆☆

モデル・モード制御

フラグ説明活用度
--model <name>モデルを指定(sonnet, opus, haikuまたはフル名)★★★★☆
--fallback-model <name>過負荷時の自動フォールバックモデル(printモードのみ)★★★☆☆
--permission-mode <mode>起動時の権限モードを指定(plan等)★★★☆☆

出力制御

フラグ説明活用度
--output-format jsonJSON形式で出力★★★★★
--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つ以上のサブエージェントを定義する。

フィールド必須説明
descriptionYesサブエージェントの用途説明
promptYesサブエージェントのシステムプロンプト
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-desktopClaude Desktop設定をインポート★★★☆☆
claude mcp remove <n>MCPサーバー削除★★★☆☆
claude mcp serveClaude 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との対話セッション中に / から始めて実行するコマンド。/ を入力すると一覧が表示され、続けてタイプすることでフィルタできる。

プロジェクト管理系

コマンド説明活用度
/initCLAUDE.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★★★★☆
/fastFast Modeのオン/オフ切り替え(Opus 4.6を2.5倍高速化)★★★★☆
/plan [description]Plan Modeのオン/オフ(読み取り専用で計画を立てる。オプション引数でdescription指定可→即座に計画開始)★★★★★
/vimVimスタイル編集モードの切り替え★★☆☆☆
/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-appGitHub PR自動レビュー設定★★★★☆
/pluginプラグイン管理(追加・削除・マーケットプレイス)★★★☆☆
/mcpMCPステータス確認・OAuth認証★★★★☆
/rc現在のセッションをRemote Controlに切り替え★★★☆☆
/review <PR#>指定PRのコードレビュー(gh CLI必須)★★★★☆
/pr-comments現在ブランチのPRコメント表示(gh CLI連携)★★★☆☆
/security-review未コミット変更のセキュリティ監査(古いgitの--merge-baseエラーは修正済)★★★★☆
/skillsスキル管理メニュー(プラグイン名付きスキル表示)★★★☆☆

バンドルコマンド系(v2.1.63〜)

複数エージェントが協調して動くコマンド群。PR前の品質保証や大規模変更に活用する。

コマンド説明活用度
/simplify3エージェントレビューパイプライン(アーキテクチャ問題・重複ロジック・パフォーマンス非効率を検出。PR前に実行推奨)★★★★★
/batch大規模並列変更(worktree隔離で並行実行→計画→Worker並列起動→PR自動作成。マイグレーション、パターン適用等)★★★★★

環境設定系

コマンド説明活用度
/terminal-setupShift+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+Yreadline式ペースト(削除テキスト貼り付け)★★☆☆☆
Ctrl+Sプロンプトスタッシュ(一時退避)★★☆☆☆
?利用可能なショートカット一覧を表示★★★☆☆

モード切り替え

ショートカット説明活用度
Shift+Tabモード循環(normal → auto-accept → plan)★★★★★
Tab拡張思考のオン/オフ切り替え(セッション間で保持)★★★★☆
Ctrl+Tタスクリスト表示の切り替え★★★☆☆
Ctrl+OVerbose表示のオン/オフ(思考内容を表示)★★★☆☆
Ctrl+Gプランを外部テキストエディタで開く★★★☆☆
Shift+DownAgent 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つのレイヤーで構成されています。

  1. CLAUDE.md: Claudeへのプロジェクト別指示書(チーム共有 / 個人用)
  2. Auto Memory: 会話内容から自動で学習するメモ(~/.claude/projects/<project>/memory/
  3. .claude/rules/: 条件別に切り出されたモジュール型のルールファイル
  4. settings.json: 権限、許可ツール、フック設定、環境変数
  5. Hooks: ターミナルコマンドやスクリプトを自動化するライフサイクルイベント
  6. Skills: カスタムスラッシュコマンドやサポートファイル群
  7. 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(企業管理者が配置)
2CLIオプション起動時の --model 等のコマンドライン引数
3Local(ローカル).claude/settings.local.json(Git管理外の個人設定)
4Project(プロジェクト).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.jsonMCPサーバー設定★★★★★

個人用(ローカル)

ファイル/ディレクトリ説明活用度
.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通知発生時★★☆☆☆
InstructionsLoadedCLAUDE.mdまたは.claude/rules/*.mdがコンテキストに読み込まれた時★★★☆☆
ConfigChange設定変更時★★☆☆☆

サブエージェント・タスクイベント

フックイベント説明活用度
SubagentStartサブエージェント起動時★★★☆☆
SubagentStopサブエージェント終了時★★★☆☆
TeammateIdleAgent Teamsでチームメイトがアイドル状態★★★☆☆
TaskCompletedタスク完了時(/batch連携で完了通知に重要)★★★★☆
PreCompactコンテキスト圧縮前★★☆☆☆

ワークツリー系イベント(新カテゴリ)

フックイベント説明活用度
WorktreeCreateworktree作成時(カスタムVCSセットアップ対応)★★★☆☆
WorktreeRemoveworktree削除時★★☆☆☆

フックハンドラタイプ

タイプ説明主な用途
commandシェルコマンドを実行Linter、フォーマッター実行
promptClaudeに追加プロンプトを送信自動フィードバック
agentサブエージェントを起動専門エージェントへの委譲
httpURLに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_MEMORYAuto Memory(自動学習)機能を強制的に無効化する0★★★★☆
MAX_MCP_OUTPUT_TOKENSMCPツール出力の最大トークン数25000★★★☆☆
CLAUDE_CODE_MAX_OUTPUT_TOKENSモデル出力の最大トークン数32000★★★☆☆
BASH_DEFAULT_TIMEOUT_MSBashコマンドのデフォルトタイムアウト(ms)120000★★★☆☆
BASH_MAX_TIMEOUT_MSBashコマンドの最大タイムアウト(ms)600000★★☆☆☆
SLASH_COMMAND_TOOL_CHAR_BUDGETスキル説明の文字バジェットを上書き動的(コンテキストの2%)★★☆☆☆
CLAUDE_CODE_DISABLE_CRONスケジュールcronジョブを即座に停止(未設定)★★☆☆☆
ENABLE_CLAUDEAI_MCP_SERVERSclaude.ai MCPサーバーの利用可否true★★★☆☆
CLAUDE_CODE_DISABLE_1M_CONTEXT1Mコンテキストを無効化(未設定)★★☆☆☆
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.jsonpermissions.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も可能。


次のステップ

関連記事

参考リンク