Claude Code 参考ガイド

← 本編ページに戻る

1. 起動と画面

1-1. 起動コマンド

ターミナルで claude を実行すると Claude Code が起動します。

# 通常起動
claude

# 直前のセッションを履歴付きで継続
claude --continue   # または -c

# 特定のセッションを ID 指定で復帰(ピッカーあり)
claude --resume     # または -r

# 起動と同時に 1 ターン投げる(非対話モード)
claude -p "今日のタスクを 3 つに分けて"

1-2. 許可ダイアログ

Claude Code がツール（ファイル書き込み、コマンド実行 等）を呼ぶたびに、許可を求めるダイアログが出ます。

• Allow once: 今回だけ許可
• Always allow: このプロジェクトで常に許可（settings.json に記録）
• Deny: 今回は拒否

2. 主要コマンド

2-1. ビルトインコマンド

プロンプト欄で / から始めるとコマンドモード。

2-2. プラグイン操作

# マーケットプレイスを登録(GitHub repo を「お店」として追加)
/plugin marketplace add <owner>/<repo>

# プラグイン本体をインストール
/plugin install <plugin-name>@<marketplace-name>

# 一覧
/plugin list

# 削除
/plugin uninstall <plugin-name>

プラグインの中身は ~/.claude/plugins/marketplaces/<owner>/<plugin>/ にダウンロードされ、その中の skills/ commands/ agents/ hooks/ が自動で有効化されます。

2-3. CLI フラグ（起動時オプション）

3. ツールと許可

Claude Code 本体（ハーネス）が AI に提供している主なツール。AI はこれらを自分で選んで呼び出します。

★ 各ツールの呼び出しごとに「許可ダイアログ」が出ます。settings.json の permissions.allow / permissions.deny にパターンで書いておくと、毎回聞かれずに済みます。

4. スキル / サブエージェント / フック

Phase 1 §8-4 で図解した「自分仕様パーツ」のうち、Slash Commands 以外をもう一段詳しく。

4-1. Skills

SKILL.md をフロントマター付きで .claude/skills/<name>/ に置くと Claude が **タスクの場面に応じて自動で読み込み** ます。発動条件は description フィールドに自然文で書きます。

---
name: example-skill
description: 使うべき場面の説明文。Claude がこれを読んで「使うか」判断する
---

# やってほしい手順

1. 最初に X を確認
2. 次に Y を実施
3. 最後に Z を検証

4-2. Subagent (Task)

Task ツールで子エージェントを spawn できます。子は fresh context で動き、結果だけを親に返すので、長い調査や別領域のタスクで親の context を汚しません。

4-3. Hooks

settings.json に登録するイベント駆動スクリプト。Claude を経由せず、ハーネスが直接実行する のが最大の特徴です。

5. 設定 (settings.json)

~/.claude/settings.json（グローバル）と .claude/settings.json（プロジェクト）の 2 階層。プロジェクトが優先されます。

{
  "permissions": {
    "allow": [
      "Bash(git:*)",
      "Bash(ls:*)",
      "Read(**)"
    ],
    "deny": [
      "Read(**/.env)",
      "Read(~/.ssh/**)",
      "Bash(rm -rf:*)",
      "Bash(curl:*)"
    ]
  },
  "env": {
    "EDITOR": "code"
  },
  "hooks": {
    "Stop": [
      { "command": "/path/to/save-transcript.sh" }
    ]
  }
}

★ deny は allow より優先されます。~/.ssh/** や **/.env などの秘匿パスは 必ず deny に 書いておくと、Claude が判断ミスしてもブロックされます。

6. トラブルシュート

← 本編ページに戻る