Claude Code 使い方とコツ完全ガイド｜全コマンド一覧・エラー対処

Claude Code は、ターミナルや IDE から日本語で頼むと、コードを読み、ファイルを編集し、コマンドを実行して確かめるところまで進める Anthropic のコーディングエージェントです。 2026年10月16日時点の最新版は 2.1.301（npm の latest、10月15日公開）で、安定版チャネル（stable）は 2.1.292 です。使い方のコツを1行で言うと「Claude に自分で確かめる手段（テスト・ビルド）を渡し、関係のない作業の間は /clear で文脈を空ける」 で、これは公式の Best practices の最初の2項目と同じです。

最終更新：2026年10月16日（変更点）

確認環境：Claude Code 2.1.301 を npm（@anthropic-ai/claude-code、Node.js 22.22.2、Linux x64）で入れ、claude --version・claude --help・各サブコマンドの --help・claude doctor・claude mcp add／get／remove・引数の誤りのエラー表示を実行して出力を確かめました。コマンド・設定・権限・料金・対応 OS は、code.claude.com の公式ドキュメント（英語版）と claude.com/pricing で確かめました（確認日 2026年10月16日）。

Claude Code とは：できることと使える場所

公式の概要ページは Claude Code を「コードベースを読み、ファイルを編集し、コマンドを実行し、開発ツールとつながるエージェント型のコーディングツール」と説明しています。チャットで答えを返すだけでなく、自分でファイルを探して読み、編集し、テストを実行して結果を見て直すまで続けて進めるのが特徴です。

同じエンジンに複数の入口があり、リポジトリの CLAUDE.md・.claude/settings.json・.mcp.json はどの入口でも共通に使われます。

インストール（Windows・Mac・Linux）

システム要件

OS別のインストールコマンド

• Homebrew と WinGet は、CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE=1 を設定すると Claude Code が更新コマンドを代わりに実行します。
• 安定版チャネルは「おおむね1週間遅れで、大きな不具合を含むリリースを飛ばす」版です。curl -fsSL https://claude.ai/install.sh | bash -s stable のように入れるか、設定の autoUpdatesChannel を "stable" にします。

Windows は、ネイティブで動かすか WSL の中で動かすかを選びます。

Git for Windows がないときは PowerShell ツールでコマンドを実行し、あるときは Git Bash を Bash ツールとして使います。管理者権限は要りません。PowerShell で CMD 用のコマンドを打つと The token '&&' is not a valid statement separator、CMD で PowerShell 用を打つと 'irm' is not recognized as an internal or external command になります。プロンプトが PS C:\ なら PowerShell、C:\ なら CMD です。

npm で入れたときの中身（実測）

npm パッケージは、ネイティブインストーラーと同じネイティブバイナリを入れます。OS ごとの optional dependency（例：@anthropic-ai/claude-code-linux-x64）から取り出し、インストール後の処理で配置する仕組みで、入った claude 自体は Node.js を呼びません。手元で 2.1.301 を入れた結果です。

npm install @anthropic-ai/claude-code@2.1.301
du -sh node_modules
ls -l node_modules/@anthropic-ai/claude-code/bin/

added 2 packages, and audited 3 packages in 6s
256M    node_modules
-rwxr-xr-x 2 root root 267955384 Oct 16 16:07 claude.exe

• バイナリ1個で 約 256MB あります。ディスクの空きが少ない環境では、先に空きを確かめておきます。
• npm で入れられるのは darwin-arm64・darwin-x64・linux-x64・linux-arm64・linux-x64-musl・linux-arm64-musl・win32-x64・win32-arm64 の8種類です。optional dependency を入れない設定だとバイナリが入らず、Error: claude native binary not installed になります。
• 公式ドキュメントは sudo npm install -g を使わないよう警告しています。更新は npm install -g @anthropic-ai/claude-code@latest で、npm update -g は元の版の範囲に縛られるため勧められていません。

更新・アンインストール

--version・--help の実際の出力（2.1.301）

claude --version

2.1.301 (Claude Code)

claude --help の出力は 311 行あり、オプションが 66個、サブコマンドが 18個 並びます。先頭とサブコマンド部分をそのまま載せます。

Usage: claude [options] [command] [prompt]

Claude Code - starts an interactive session by default, use -p/--print for
non-interactive output

Arguments:
  prompt                                Your prompt

Options:
  --add-dir <directories...>            Additional directories to allow tool
                                        access to
  --agent <agent>                       Agent for the current session. Overrides
                                        the 'agent' setting.
  …（中略）…

Commands:
  agents [options]                      Manage background agents
  attach <id|name>                      Open a background session in this
                                        terminal. …
  auth                                  Manage authentication
  auto-mode                             Inspect or reset auto mode classifier
                                        configuration
  doctor                                Check the health of your Claude Code
                                        installation. …
  gateway [options]                     Run the enterprise auth/telemetry
                                        gateway
  import [options] [source]             Import config from another AI coding
                                        agent into Claude Code
  install [options] [target]            Install Claude Code native build. Use
                                        [target] to specify version (stable,
                                        latest, or specific version)
  logs <id|name>                        Print a background session's recent
                                        terminal output
  mcp                                   Configure and manage MCP servers
  plugin|plugins                        Manage Claude Code plugins
  purge [options] [path]                Delete all Claude Code state for a
                                        project (transcripts, tasks, file
                                        history, config entry)
  respawn [options] [id]                Restart a background session, or all of
                                        them with --all, so it runs the current
                                        Claude Code version
  rm <id>                               Delete a background session, and its
                                        worktree when that is safe. …
  setup-token                           Set up a long-lived authentication token
                                        (requires Claude subscription)
  stop|kill <id>                        Stop a background session. …
  ultrareview [options] [target]        Run a cloud-hosted multi-agent code
                                        review of the current branch (or a PR
                                        number / base branch) and print the
                                        findings
  update|upgrade                        Check for updates and install if
                                        available

claude doctor の出力（npm で入れた 2.1.301）

claude doctor は、セッションを始めずにインストールの状態を読み取り専用で診断します。手元の出力の前半です（Path: 行のパスは省きました）。

Claude Code doctor

Running: npm-global (2.1.301)
Commit: 12a1baed117f
Platform: linux-x64
Config install method: unknown
Search: OK (bundled)
Auto-updates: enabled
Auto-update channel: latest
Last update attempt: none recorded
…
No installation issues found.

For a full setup checkup that can also fix issues, run /doctor in a Claude Code session.

料金プランと使える範囲（2026年10月）

Claude Code は Pro・Max・Team・Enterprise のいずれか、または Claude Console（API の従量課金）で使えます。無料の Free プランには含まれません（公式 Advanced setup）。Amazon Bedrock・Google Cloud の Agent Platform・Microsoft Foundry 経由でも使えます。

• サブスクリプションの利用枠は「5時間ごと」と「週ごと」に区切られ、全モデルで共有です。You've hit your session limit が出たとき、/model で切り替えても戻りません（Opus・Sonnet 個別の上限のときは別系統のモデルに切り替えられます）。
• API で使ったときの目安として、公式のコストページには「企業での平均は開発者1人あたり稼働日1日約 $13、月 $150〜250。90% の利用者は1日 $30 未満」とあります。
• /usage のセッション費用の金額は、サブスクリプションでは請求に関係しない推定値です。プランの利用量バーと内訳を見ます。
• Claude Code で Fable 5.1 を使うには 2.1.255 以降が要ります（Claude ヘルプセンター）。モデルごとの API 単価は関連記事「Claudeモデル比較2026年10月版｜Haiku 5.5〜Fable 5.1料金」で扱っています。

最初の30分の使い方

0〜5分：入れて、ログインする

curl -fsSL https://claude.ai/install.sh | bash   # Windows は irm https://claude.ai/install.ps1 | iex
claude --version                                  # 2.1.301 (Claude Code) のように出れば成功
cd your-project
claude

初回はブラウザが開いてログインします。ANTHROPIC_API_KEY が設定されていると、ブラウザの代わりに「このキーを使うか」を1回だけ聞かれます。初めて開くフォルダでは「このフォルダを信頼するか」を聞かれます。

5〜10分：理解させてから CLAUDE.md を作る

最初はコードを変えさせず、質問から入ります。公式クイックスタートの例です。

what does this project do?
explain the folder structure
where is the main entry point?

続けて /init を打つと、Claude がコードを読んでビルド・テストのコマンドや規約を書いた CLAUDE.md を作ります（すでにあれば改善案を出します）。

10〜20分：プランモードで設計を出させる

Shift+Tab でモードを切り替えて ⏸ plan mode on にするか、/plan に続けて頼みます。プランモードでは Claude はファイルを読むだけで、編集はしません。

/plan タスクに期限（due）を持たせ、期限切れだけを返す overdue() を足したい。
変更するファイル、追加するテスト、既存コードへの影響を整理して。実装はまだしない。

Ctrl+G でプランをエディタで開いて直接直せます。承認すると、どのモードで実装に進むかを選べます。

20〜30分：実装・テスト・コミット

プランどおりに実装して。tests/ にテストを2つ足し、テストを実行して失敗があれば直して。

変更内容を確かめて、説明的なメッセージでコミットして。

• 差分は /diff で見られます。
• 途中で方向がずれたら Esc で止め、Esc 2回か /rewind で前の時点に戻せます（チェックポイント）。
• 終わるときは /exit か Ctrl+D 2回です。同じディレクトリで claude -c を打つと続きから再開します。

初版を作った10月2日に、2.1.287 で小さなサンプルリポジトリに claude -p を1回実行したときは、CLAUDE.md に構成とテストコマンドを書いておいたことで num_turns が 1（ファイルを開かずに回答）、total_cost_usd は約 0.045 ドルでした。CLAUDE.md に「毎回聞かれること」を書くと、読むファイルが減る例です。

スラッシュコマンド一覧（全件・2.1.301）

入力欄で / を打つと、使えるコマンドが一覧で出ます。表示されるコマンドはプラン・OS・接続先で変わります（例：/desktop は macOS と x64 Windows でサブスクリプションにログインしているときだけ）。下の表は公式 Commands ページ（2026年10月16日）の全件を、用途別に並べ直したものです。「スキル」は同梱スキル、「ワークフロー」は同梱の動的ワークフローです。

基本・アカウント・ヘルプ

会話とコンテキスト

モデル・表示・設定

権限と安全

プロジェクト設定と拡張（CLAUDE.md・MCP・スキル・プラグイン）

並列作業・バックグラウンド・定期実行

レビュー・Git・GitHub

利用量と診断

IDE・ブラウザ・クラウド連携

作る・動かして確かめる（同梱スキル）

削除されたコマンド：/pr-comments（v2.1.91 で削除。Claude に直接頼む）、/vim（v2.1.92 で削除。/config → Editor mode）、/ultraplan（削除。プランモードを使う）。打つと Unknown command になります。自作のコマンドは「スキル」として作ります（.claude/commands/deploy.md と .claude/skills/deploy/SKILL.md はどちらも /deploy になります）。

キーボードショートカットまで含めた早見表は、関連記事「Claude Code コマンド 一覧｜CLI・スラッシュ・ショートカット早見表」で扱っています。

CLI フラグ一覧（--help の66個＋ヘルプに出ないもの）

起動とセッション

モデル・プロンプト

権限・ツール・設定

非対話（-p）の入出力・デバッグ

--help に出ないがドキュメントにあるフラグ

公式 CLI リファレンスには「claude --help はすべてのフラグを載せていない。載っていないことは使えないことを意味しない」と書かれています。

サブコマンド

引数を間違えたときの表示（実測）

値の誤りは起動前に止まり、選べる値が表示されます。

claude --permission-mode yolo -p hi
claude -p hi --output-format xml
claude --effort ultra --version

error: option '--permission-mode <mode>' argument 'yolo' is invalid. Allowed choices are acceptEdits, auto, bypassPermissions, manual, dontAsk, plan.
error: option '--output-format <format>' argument 'xml' is invalid. Allowed choices are text, json, stream-json.
Warning: Unknown --effort value 'ultra' — ignoring it and using the default effort. Valid values: low, medium, high, xhigh, max.
2.1.301 (Claude Code)

--permission-mode と --output-format は終了コード 1 で止まり、--effort は警告だけ出して既定の effort で続きます。

設定ファイルの場所と優先順位

同じキーが複数の場所にあるときは、上の段の値が使われます。

押さえておきたい点です（公式 Settings ページ）。

• permissions.allow などのリストは上書きではなく合算されます。 各ファイルの許可ルールが足し合わされます。
• 環境変数はこの段に入りません。 例えば ANTHROPIC_MODEL はどのファイルの model より優先され、--model はさらに優先されます。
• permissions.defaultMode の auto と bypassPermissions は、プロジェクトの2ファイルからは効きません。 ~/.claude/settings.json か管理設定に書くか、--permission-mode で渡します。
• 共有ファイルの allow ルールと多くの env は、各メンバーがフォルダを信頼するまで効きません。 deny・ask はすぐ効きます。
• 設定ファイルは厳密な JSON です。// のコメントや末尾のカンマがあると、次の起動時に Settings Error になります。
• 読み込まれたファイルは /status の Setting sources 行で確かめられます。
• ~/.claude.json は Claude Code が自分で書くファイルで、ログイン情報・MCP サーバーの設定（local・user スコープ）・プロジェクトごとの信頼の記録などが入ります。

設定の場所の全体像です。

権限ルールの書き方を含む settings.json の全キーは、関連記事「Claude Code settings.json設定一覧｜権限の雛形と優先順位」で扱っています。

settings.json の最小例

{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "permissions": {
    "allow": [
      "Bash(npm run lint)",
      "Bash(npm run test *)"
    ],
    "deny": [
      "Read(./.env)",
      "Read(./.env.*)"
    ]
  }
}

$schema の行を入れると、VS Code などで補完と検証が効きます。編集は保存した時点で実行中のセッションに反映されます（model と effort は次のセッションから）。

CLAUDE.md（claudemd）の書き方と読み込み順

CLAUDE.md は、毎セッションの開始時に読み込まれる「プロジェクトの指示書」です。 公式は「1ファイル 200 行未満」を目安にしています。

• 読み込み順：作業ディレクトリとその上のディレクトリにある CLAUDE.md を、ルートに近いものから順につなげて読みます。同じ階層では CLAUDE.md の後に CLAUDE.local.md です。サブディレクトリの CLAUDE.md は、Claude がそのディレクトリのファイルを読んだときに読み込まれます。
• @path で他のファイルを取り込めます。 相対パスは CLAUDE.md からの相対で、最大4段までです。取り込んだファイルも起動時に読まれるので、文脈の節約にはなりません。
• AGENTS.md：CLAUDE.md がなく AGENTS.md だけあるリポジトリでは、2.1.277 以降は AGENTS.md をそのまま読みます。両方あるときは既定では CLAUDE.md だけです（/config の Project instructions で両方読むようにもできます）。
• 大きくなったら .claude/rules/*.md に分け、先頭に paths: を書くと、特定のファイルを触るときだけ読まれるルールになります。手順が長いものはスキルに移します。
• 自動メモリ：Claude が自分で書くメモは ~/.claude/projects/<project>/memory/ に入り、MEMORY.md の先頭 200 行か 25KB までが毎回読まれます。/memory で切り替えと中身の確認ができます。
• HTML コメント（<!-- … -->）は Claude に渡る前に取り除かれるので、人向けのメモに使えます。
• /doctor prompt-audit（2.1.283 以降）で、指示ファイルの矛盾や存在しないコマンドへの言及を点検できます。

最小テンプレート

# プロジェクト名

1〜2行でプロジェクトの説明（何を作っているか、主な技術）。

## コマンド
- ビルド: `npm run build`
- テスト: `npm test`（コミット前に実行する）
- Lint: `npm run lint`

## 規約
- 2スペースのインデント
- API ハンドラは `src/api/handlers/` に置く
- 公開関数を足したら `tests/` にテストを足す

## 構成
- `src/`: アプリ本体
- `tests/`: テスト

## 参照
概要は @README.md、npm スクリプトは @package.json を参照。

公式 Best practices の「入れるもの・入れないもの」です。

何を書くか・どう育てるかは、関連記事「CLAUDE.mdの書き方｜何を書くか・置き場所・育て方【テンプレートつき】」で扱っています。スキルとの使い分けは、関連記事「CLAUDE.mdとSkillsの違い｜使い分け判断表と移し替え手順」で扱っています。

権限モード（Shift+Tab）

2.1.283 以降、ターミナルと VS Code の対話セッションは auto モードで始まるのが組み込みの既定です（それより前は Pro・Max・Team だけ）。auto モードでは、別の判定用モデル（classifier）が操作を見て、危ないものだけ止めます。

• Shift+Tab を押すたびに切り替わります。auto からは1回目で default に戻り、その後 default → acceptEdits → plan の順です。状態は入力欄の下に ⏸ manual mode on・⏵⏵ accept edits on・⏸ plan mode on・⏵⏵ auto mode on のように出ます。
• 起動時に決めるなら claude --permission-mode plan、既定にするなら設定の permissions.defaultMode です。
• auto モードが使えるのは、Anthropic API では Opus 4.6・Sonnet 4.6 以降と Fable の各モデルです。Haiku では使えません。組織は permissions.disableAutoMode: "disable" で止められます。
• deny ルールはどのモードでも効きます（bypassPermissions を含む）。「.env を読ませない」など必ず守らせたいことは、CLAUDE.md ではなく permissions.deny かフックに書きます。
• claude -p の既定は default です（機能フラグを取得しないセッションでは 2.1.285 以降 auto）。

プランモードの依頼文の型は関連記事「Claude Code プランモードの使い方｜起動方法と依頼文の型10例」で扱っています。

モデル指定（/model・--model・サブエージェント）

• 指定の優先順位は、セッション中の /model → 起動時の --model → 環境変数 ANTHROPIC_MODEL → 設定の model → ANTHROPIC_DEFAULT_MODEL です。
• Claude Code の effort の既定は多くのモデルで high、Opus 5.5・Sonnet 5.5・Haiku 5.5 は medium です。
• サブエージェントのモデル指定は、定義ファイルの model: に sonnet・opus・haiku・fable・完全なモデル ID・inherit を書きます。決まる順番は「呼び出しごとの model → 定義ファイルの model → 環境変数 CLAUDE_CODE_SUBAGENT_MODEL → 親のモデル」です。

モデルごとの料金と使い分けは関連記事「Claudeモデル比較2026年10月版｜Haiku 5.5〜Fable 5.1料金」で扱っています。

MCP・サブエージェント・hooks・Skills・プラグインの要点

公式の勧めは「まず CLAUDE.md。ほかは決まったきっかけが出てから足す」です。

CLAUDE.md やスキルの指示は「お願い」で、hooks と権限設定は「仕組み」です。必ず守らせたいことは hooks と permissions に書きます。

claude mcp add の書き方（実測）

# リモート（HTTP）
claude mcp add --transport http sentry https://mcp.sentry.dev/mcp

# ローカル（stdio）。-- の後ろがサーバーの起動コマンド
claude mcp add --scope project files -- npx -y @modelcontextprotocol/server-filesystem .

# 環境変数を渡す（--env の直後に名前を置かない）
claude mcp add --env API_KEY=xxx --transport stdio my-server -- npx my-mcp-server

2.1.301 で2つ目の --scope project を実行した結果です（パスは省略）。

Added stdio MCP server files with command: npx -y @modelcontextprotocol/server-filesystem . to project config
File modified: <プロジェクト>/.mcp.json

作られた .mcp.json です。

{
  "mcpServers": {
    "files": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "."
      ],
      "env": {}
    }
  }
}

claude mcp get files では、まだ承認していないプロジェクトのサーバーは接続されず、次のように表示されました。

files:
  Scope: Project config (shared via .mcp.json)
  Status: ⏸ Pending approval (run `claude` to approve)
  Type: stdio
  Command: npx
  Args: -y @modelcontextprotocol/server-filesystem .
  Environment:

To remove this server, run: claude mcp remove files -s project

• -- を忘れると、サーバー側のフラグ（--port など）を Claude Code が自分のオプションとして読もうとします。
• 同じ名前が複数あるときは local → project → user → プラグイン → claude.ai コネクタの順で1つだけ使われ、項目は混ぜられません。
• MCP ツールの出力が 10,000 トークンを超えると警告が出て、既定では 25,000 トークンで切られます（MAX_MCP_OUTPUT_TOKENS で変更）。起動の待ち時間は MCP_TIMEOUT（ミリ秒）です。
• サブコマンドは add・add-json・add-from-claude-desktop（Mac と WSL）・get・list・remove・login・logout・reset-project-choices・serve です。

.mcp.json の雛形と設定項目の一覧は、関連記事「Claude Code MCP設定の追加方法｜.mcp.json雛形と一覧」で扱っています。MCP の仕組みは、関連記事「MCPとは？サーバーとクライアントの仕組みと設定例を図解」で扱っています。サーバーの自作は、関連記事「MCPサーバーの作り方｜Pythonで作ってClaude Codeにつなぐ」で扱っています。

サブエージェント（Claude Code）

組み込みのサブエージェントは Explore（読み取り専用の探索）、Plan（プランモードの下調べ）、general-purpose（調査と編集の両方）などです。自作は Markdown 1枚で、必須は name と description だけです。

---
name: code-searcher
description: コードベースから関連ファイルと呼び出し元を探す。調査だけで編集はしない
tools: Read, Glob, Grep
model: haiku
---

あなたはコード検索の担当です。見つけたファイルのパスと行番号、根拠になる行を短く返します。

ほかに disallowedTools・permissionMode・effort・memory・maxTurns・skills・mcpServers・hooks・isolation などの項目があります。委任の効果を実測した結果は関連記事「Claude Codeサブエージェントの使い方｜実測で見る委任とコンテキスト節約」で扱っています。

hooks（フック）

フックは、Claude Code の決まったタイミングでシェルコマンドなどを必ず実行する仕組みです。編集のたびに Prettier をかける公式の例です（.claude/settings.json）。

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "jq -r '.tool_input.file_path' | xargs npx prettier --write"
          }
        ]
      }
    ]
  }
}

公式の hooks ガイド（2026年10月16日）では、ほかに PermissionRequest・SubagentStart・SubagentStop・InstructionsLoaded・ConfigChange・FileChanged・PreModelSwitch など全部で 33 のイベントがあります。種類は command・http・mcp_tool・prompt・agent の5つです。設定は /hooks で一覧でき、"disableAllHooks": true で止められます。設定例と実行結果は関連記事「Claude Code Hooksの使い方｜設定例と実行結果・止め方まで」で扱っています。

Skills とプラグイン

スキルは SKILL.md（先頭に YAML、続けて手順）を置いたフォルダです。

---
name: fix-issue
description: GitHub の issue を直す
disable-model-invocation: true
---
GitHub の issue $ARGUMENTS を調べて直す。

1. `gh issue view` で内容を読む
2. 関係するファイルを探して直す
3. テストと lint を通してからコミットする

/fix-issue 1234 で呼びます。disable-model-invocation: true にすると、Claude が勝手に読み込まず、自分で呼んだときだけ動きます。作り方は関連記事「Claude Code Skillsの作り方｜SKILL.md雛形と項目一覧」で扱っています。

プラグインは、スキル・サブエージェント・フック・MCP サーバーを1つにまとめたものです。/plugin の Discover タブから入れるか、claude plugin install <名前>@claude-plugins-official のように入れます。Anthropic の公式マーケットプレイス（claude-plugins-official）は、最初に対話セッションを開いたときに追加されます。入れたプラグインのスキルや説明は毎ターンの文脈に入るので、使わないものは claude plugin disable で止めます。

Claude Code のコツ（claude code コツ）：公式 Best practices から10個

公式 Best practices の前提は 「文脈（コンテキスト）はすぐ埋まり、埋まるほど性能が落ちる」 の1点です。コツの多くはここから来ています。

公式が挙げる「よくある失敗の型」です。

費用を抑えるコツ（公式 Manage costs）も同じ方向です。

• 作業を切り替えるときは /clear（/rename してから消すと /resume で戻れる）。
• 日常の実装は Sonnet、難しい設計判断は Opus。単純なサブエージェントは model: haiku。
• gh・aws などの CLI は MCP より文脈を使いません。使わない MCP サーバーは /mcp で止めます。
• 長いログはフックで ERROR の行だけに絞ってから Claude に渡すと、数万トークンが数百トークンになります。

トークンを減らす方法は、関連記事「Claude Codeのトークン節約術｜コンテキスト使用率を下げる7つの方法」で扱っています。任せ方の習慣は、関連記事「Claude Codeの実務での使い方｜補完AIとの違い・任せ方の3つの習慣」で扱っています。

非対話実行：claude -p

claude -p "指示" は、対話画面を開かずに1回実行して結果を出し、終了します。CI やスクリプト、パイプから使う入口です。

# 1. テキストで答えだけ受け取る
claude -p "この関数の責務を1行で説明して"

# 2. JSON で受け取り、本文だけ取り出す（jq を使用）
claude -p "変更点を3行で要約して" --output-format json | jq -r '.result'

# 3. パイプで材料を渡す
git diff main --name-only | claude -p "これらの変更ファイルをレビューして"

# 4. 構造化出力
claude -p "テストの不足を列挙して" \
  --json-schema '{"type":"object","properties":{"gaps":{"type":"array","items":{"type":"string"}}},"required":["gaps"]}'

# 5. CI 向け：ターン数と金額に上限、許可するツールを絞り、それ以外は自動で拒否
claude -p "lint エラーを直して" --max-turns 10 --max-budget-usd 2.00 \
  --allowedTools "Edit" "Bash(npm run lint)" --permission-mode dontAsk

--output-format json の結果には result（本文）のほか is_error・subtype・num_turns・total_cost_usd・usage・session_id・permission_denials が入ります。CI では is_error と subtype で成否を判定し、permission_denials が空でなければ「許可されずに止まった操作がある」と分かります。GitHub Actions での組み込みは関連記事「Claude Code GitHub Actions連携｜YAML雛形と入力一覧」で扱っています。

よくあるエラーと対処

command not found の再現と直し方

PATH からインストール先を外して実行すると、公式に載っている Linux の例と同じ種類のエラーになります（bash -c 経由なので line 1: が付きます）。

env PATH=/usr/bin:/bin bash -c 'claude --version'

bash: line 1: claude: command not found

# Zsh（macOS の既定）
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc
# Bash（多くの Linux の既定）
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc && source ~/.bashrc

$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

VS Code 拡張機能だけを入れた場合、claude は PATH に入りません。ターミナルで使うには CLI を別に入れます。

よくある質問

Q. claude code のコツを1つだけ挙げるなら？ A. 公式 Best practices の最初の項目は「Claude に自分で確かめる手段を渡す」です。テストケースや期待する出力を指示に入れ、「実装したらテストを実行して直して」まで頼むと、Claude が合否を見て自分で直し続けます。2つ目は、関係のない作業の間に /clear で文脈を空けることです。

Q. claude mcp add の書き方は？ A. リモートは claude mcp add --transport http <名前> <URL>、ローカルは claude mcp add <名前> -- <起動コマンド> です。チームで共有するなら --scope project を付けると .mcp.json に書かれます。既定の local スコープは ~/.claude.json に保存され、自分のこのプロジェクトだけで使えます。

Q. サブエージェントは Claude Code でどう作りますか。 A. .claude/agents/<名前>.md に、name・description（いつ任せるか）を書いた YAML と、役割の説明を置きます。Claude に「〜を担当するサブエージェントを作って」と頼んでも作れます。使うときは「サブエージェントで〜を調べて」と頼みます。

Q. Claude のサブエージェントでモデルを指定するには？ A. 定義ファイルの model: に haiku・sonnet・opus・fable・完全なモデル ID・inherit を書きます。全部のサブエージェントの既定を変えるなら環境変数 CLAUDE_CODE_SUBAGENT_MODEL を使います。定義ファイルの model のほうが環境変数より優先されます。

Q. claudemd（CLAUDE.md）とは何ですか。 A. Claude Code が毎セッションの最初に読む Markdown の指示書です。プロジェクト直下の CLAUDE.md に、ビルド・テストのコマンド、規約、構成を書きます。/init で下書きを作れます。目安は 200 行未満です。

Q. hooks は Claude Code で何に使いますか。 A. 「必ず毎回起きてほしいこと」に使います。編集後のフォーマット、保護したいファイルへの編集の拒否、入力待ちの通知、要約後の文脈の再注入などです。settings.json の hooks に書き、/hooks で確かめます。

Q. 無料プランで使えますか。 A. 使えません。Pro（月 $20、年払いなら月 $17）以上か、Console（API の従量課金）が要ります。

Q. Node.js がなくても使えますか。 A. 使えます。ネイティブインストーラー・Homebrew・WinGet・apt などは Node.js を使いません。npm で入れる場合だけ Node.js 22 以上が要ります。

Q. Windows では WSL が要りますか。 A. 要りません。PowerShell か CMD でネイティブに動きます。サンドボックスを使いたいときは WSL 2 です。

Q. 未経験からでも Claude Code を使えるようになりますか。 A. まず「確かめる手段を渡す」「計画を先に出させる」の2つを習慣にすると、出てきたコードを読んで判断する練習になります。学ぶ順番は関連記事「AI駆動開発は未経験からできるか｜バイブコーディングとの違いと研修で学ぶ順番」で扱っています。

まとめ

• 2026年10月16日時点の最新は Claude Code 2.1.301（安定版は 2.1.292）。インストールは OS ごとのネイティブインストーラーが推奨で、npm 版もバイナリは同じ（約 256MB）
• 使えるのは Pro・Max・Team・Enterprise・Console。Free は対象外。サブスクリプションの枠は5時間・週で全モデル共有
• スラッシュコマンドは 100 を超え、--help のフラグは 66個。ヘルプに出ない --max-turns なども CLI リファレンスにある
• 設定は 管理 → --settings → ローカル → プロジェクト → ユーザー の順に強い。リストは合算、deny はどのモードでも効く
• 2.1.283 以降、対話セッションの既定は auto モード。Shift+Tab で Manual・acceptEdits・plan に切り替える
• コツは 確かめる手段を渡す・計画してから実装・/clear で文脈を空ける・調査はサブエージェントへ・必ず守らせることは hooks と権限へ
• 困ったら claude doctor、独自設定を疑うなら claude --safe-mode

参考・出典

確認日はいずれも 2026年10月16日です。

• Claude Code Docs「Documentation map」：https://code.claude.com/docs/en/claude_code_docs_map.md
• Claude Code Docs「Advanced setup」：https://code.claude.com/docs/en/setup
• Claude Code Docs「Commands」：https://code.claude.com/docs/en/commands
• Claude Code Docs「CLI reference」：https://code.claude.com/docs/en/cli-reference
• Claude Code Docs「Settings files and precedence」：https://code.claude.com/docs/en/settings
• Claude Code Docs「Choose a permission mode」：https://code.claude.com/docs/en/permission-modes
• Claude Code Docs「How Claude remembers your project」：https://code.claude.com/docs/en/memory
• Claude Code Docs「Model configuration」：https://code.claude.com/docs/en/model-config
• Claude Code Docs「Connect Claude Code to tools via MCP」：https://code.claude.com/docs/en/mcp
• Claude Code Docs「Create custom subagents」：https://code.claude.com/docs/en/sub-agents
• Claude Code Docs「Automate actions with hooks」：https://code.claude.com/docs/en/hooks-guide
• Claude Code Docs「Skills」：https://code.claude.com/docs/en/skills
• Claude Code Docs「Plugins overview」：https://code.claude.com/docs/en/plugins/overview
• Claude Code Docs「Best practices for Claude Code」：https://code.claude.com/docs/en/best-practices
• Claude Code Docs「Manage costs effectively」：https://code.claude.com/docs/en/costs
• Claude Code Docs「Troubleshoot installation and login」：https://code.claude.com/docs/en/troubleshoot-install
• Claude Code Docs「Error reference」：https://code.claude.com/docs/en/errors
• Claude「Plans & pricing」：https://claude.com/pricing
• npm「@anthropic-ai/claude-code」：https://www.npmjs.com/package/@anthropic-ai/claude-code

株式会社RJC ― SI事業・SES事業・AI駆動開発。RJCは一緒に成長を楽しめる会社です。