Claude Code基礎ガイド：インストール・権限・モデル・コンテキスト管理

Claude Codeは、AnthropicのClaudeをターミナルとコードリポジトリで使用するエージェント型開発ツールだ。単にコードの断片を回答するだけでなく、許可された範囲内でファイルの探索・編集、コマンドの実行、テスト、エラー分析を行う。

このガイドでは、インストール手順だけでなく、権限を安全に設定する方法、作業に適したモデルを選ぶ基準、コンテキストとプロジェクトの指示を管理する方法を説明する。コマンドとサポート環境は更新される可能性があるため、実際にインストールする際は、公式セットアップドキュメントに記載されている最新のコマンドを確認する必要がある。

Claudeでコーディングする3つの方法

各方法の違いは、成果物よりもツールがローカルプロジェクトとやり取りする範囲にある。

Claude Codeはプロの開発者だけを対象としたものではない。ただし、ファイルの削除、依存関係のインストール、ビルドスクリプトの実行など、システムに影響する作業が可能なため、初心者ほどPlanモードとバージョン管理を併用することが望ましい。

インストール前の準備事項

まず、次の項目を準備する。

• 公式ドキュメントで、現在サポートされているオペレーティングシステムとシェル環境を確認する。
• Claude Codeを利用できるAnthropicアカウント、またはサポートされている認証・決済環境を用意する。
• 既存プロジェクトの場合は、Gitリポジトリを作成し、変更内容をコミットするかバックアップする。
• プロジェクトのテスト、ビルド、Lintコマンドを把握する。
• VS Codeのようなエディターを使用できるが、VS Code自体はClaude Codeの必須条件ではない。

Windowsでは、公式ドキュメントに記載されているPowerShell、コマンドプロンプト、またはWSLの条件を確認する必要がある。組織が管理するコンピューターの場合は、インストール権限、プロキシ、ファイアウォール、データ処理ポリシーも事前に確認する。

Claude Codeのインストールと初回起動

1. 公式のインストールコマンドを確認する

Claude Codeの公式セットアップドキュメントで、オペレーティングシステムに合った最新のインストール方法を選択する。インストール方法とコマンドは変更される可能性があるため、古い動画やブログのコマンドをそのまま再利用するのではなく、公式ドキュメントを基準にする。

2. プロジェクトフォルダーを開く

新しいフォルダーを作成するか、既存のリポジトリへ移動する。VS Codeを使用する場合は、File > Open Folderでフォルダーを開き、続いてTerminal > New Terminalを選択できる。

cd path/to/project
claude

claudeを実行すると、必要に応じてブラウザーでの認証手順が表示される。ログイン後、Claude Codeは現在の作業ディレクトリを基準にプロジェクトを把握する。そのため、ホームディレクトリや範囲が広すぎる上位フォルダーではなく、実際のリポジトリのルートで実行するほうが安全だ。

3. 最初の依頼は小さく始める

最初からアプリケーション全体の制作を任せるのではなく、次のように範囲を分ける。

1. プロジェクト構造を読み取り、要約させる。
2. 実装計画と変更対象ファイルを提示させる。
3. 1つの機能だけを実装させる。
4. テストまたは静的解析を実行させる。
5. 変更内容と残っているリスクを説明させる。

依頼例：

このリポジトリを読み、構造と実行方法を要約して。まだファイルは変更せず、
ログインフォームを追加するための計画と変更対象ファイルだけを提案して。

権限モードと安全な設定

Claude Codeの権限モードは、バージョンと設定画面によって表示文言が異なる場合がある。公式設定で使用される代表的なモードの概念は次のとおりだ。

Shift+Tabは、対話型画面で提供される一部の権限状態を切り替えるために使用できる。ただし、すべての設定が必ずこのショートカットだけで切り替わるわけではないため、現在の画面に表示される状態と公式の権限ドキュメントを確認する必要がある。

初心者に推奨する流れ

1. Planモードで実装計画を受け取る。
2. 変更するファイルと実行するコマンドを確認する。
3. DefaultまたはAccept Editsモードで実装する。
4. パッケージのインストール、データベースの変更、削除コマンドは自分で確認する。
5. git diffとテスト結果を確認してからコミットする。

Bypass Permissionsは、単に便利な高速モードではない。誤ったコマンド、過剰なファイルアクセス、機密情報の漏洩による被害を拡大する可能性があるため、個人のコンピューターや重要なリポジトリでデフォルトとして使用しない。

モデルの選択とコスト管理

対話型セッションで/modelを使用すると、アカウントと環境で選択可能なモデルを確認または変更できる。モデル名とエイリアス、提供状況は時期と認証方式によって異なる可能性があるため、固定されたモデル一覧を前提に自動化しないほうがよい。

/model

一般的な選択基準は次のとおりだ。

Opus、Sonnet、Haikuはモデル系列を区別する名称だが、各系列の正確なバージョンとClaude Codeでのサポート状況は今後も変わる可能性がある。/model sonnetのようなエイリアスを使用できる環境もあるが、現在のセッションに表示される選択肢を確認するのが最も正確だ。

コストを抑える実用的な方法

• 必要なサブディレクトリで実行し、不要なファイル探索を減らす。
• 依頼に目標、制約、完了条件をまとめて明記し、手戻りを減らす。
• 大きなログ全体ではなく、エラー周辺と再現手順を提示する。
• 生成ファイル、ビルド結果、大規模データなど、不要なパスを除外する。
• 探索と設計が完了したら、新しい作業単位としてセッションを整理する。
• 簡単な作業は、利用可能な範囲でより高速かつ安価なモデルを使用して処理する。
• APIベースで利用する場合は、コスト関連のコマンドとAnthropic Consoleの使用量情報を併せて確認する。

コスト構造はログイン方式によって異なる。Claudeのサブスクリプションアカウントにはプランごとの使用上限が適用される場合があり、Anthropic APIまたはクラウドプロバイダー経由の使用にはトークンベースの課金が適用される場合がある。そのため、特定のモデルが常に無料である、または一定額しかかからないと想定してはならない。

コンテキストウィンドウの管理

コンテキストウィンドウとは、現在の応答を生成するときにモデルが参照できる会話、ファイル内容、ツールの結果、プロジェクトの指示などの範囲だ。これは永続的な記憶や、単純な会話の文字数と同じものではない。

主なコマンド

コンテキストが特定の割合を超えると必ず回答品質が低下するという普遍的な基準はない。Claude Codeが自動圧縮を行う場合もあり、品質は含まれる情報の量だけでなく、関連性・重複・矛盾の有無にも影響される。

次の兆候が見られたら、整理を検討する。

• すでに修正した要件を繰り返し見落とす。
• 古いファイルの状態を現在の状態だと誤認する。
• 異なる機能の条件を混同する。
• 同じファイルを不必要に何度も読み込む。
• 会話とツールの出力が長くなりすぎた。

機能が1つ完了するたびに、必ず/clearを実行する必要はない。代わりに、完了した決定事項、未解決項目、テスト結果をプロジェクトドキュメントや作業記録に残してから新しいセッションへ移ると、情報の損失を減らせる。

CLAUDE.mdによるプロジェクト指示の管理

ファイル名は通常、大文字を含むCLAUDE.mdとする。このファイルはClaudeの永続的な記憶ではなく、Claude Codeがプロジェクト内で参照する継続的な指示文書だ。リポジトリに含めるとチームメンバーと指示を共有できるが、機密情報を記録してはならない。

/initコマンドでプロジェクトを分析し、最初のCLAUDE.mdの作成を開始できるが、その結果は必ず人が確認する必要がある。

含めるとよい内容

• プロジェクトの目的と中核機能
• 使用言語、フレームワーク、ランタイムのバージョン
• 重要なディレクトリとモジュールの役割
• インストール、開発サーバー、テスト、Lint、ビルドのコマンド
• コードスタイルと命名規則
• 変更してはならないファイルや生成コード
• セキュリティ・個人情報の取り扱い原則
• 作業の完了条件と検証手順

例：

# Project instructions

## Stack
- TypeScriptとNode.jsを使用する。
- パッケージマネージャーはpnpmとする。

## Commands
- テスト：`pnpm test`
- Lint：`pnpm lint`
- ビルド：`pnpm build`

## Rules
- `.env`と実際の認証情報を読み取ったりコミットしたりしない。
- 公開APIのレスポンス形式を変更する前に、まず計画を提示する。
- 機能の変更には関連するテストを追加する。

CLAUDE.mdに公式な最大200行という制限があるわけではない。ただし、長すぎる指示はコンテキストを消費し、ルール間の矛盾を生む可能性があるため、短く具体的に保つのが実用的だ。詳細な設計説明は別のドキュメントに分け、必要なパスを案内する。

推奨される作業手順

安全性と成果の品質をともに高める基本手順は次のとおりだ。

1. Gitの状態がクリーンであることを確認し、バックアップまたはコミットを作成する。
2. リポジトリのルートでClaude Codeを実行する。
3. CLAUDE.mdと既存のドキュメントを確認する。
4. Planモードで目標、修正ファイル、テスト計画を受け取る。
5. 大きな作業をレビュー可能な小さな単位に分ける。
6. DefaultまたはAccept Editsモードで1単位ずつ実装する。
7. インストール・削除・デプロイ・データ変更のコマンドは自分で確認する。
8. テスト、Lint、型チェック、git diffを確認する。
9. 完了状態と残っている問題を文書化する。
10. 次の作業が以前の会話と無関係なら、/clearで新しいセッションを開始する。

セキュリティチェックリスト

• .env、APIキー、証明書、顧客データがプロンプトやリポジトリに漏洩しないようにする。
• 本番サーバーとデータベースで直接実験しない。
• 出所不明のシェルコマンドやインストールスクリプトは、実行前に内容を確認する。
• Claudeが作成したコードについても、依存関係、ライセンス、セキュリティ脆弱性、テストを確認する。
• 重要な作業では、最小権限の原則と隔離された開発環境を適用する。
• 自動生成された変更はGit diffで確認し、人が最終的な責任を負う。

Claude Codeは開発プロセスを大幅に短縮できるが、結果の正確性と安全性を保証する自動的な仕組みではない。最も安定した使用方法は、明確な指示、制限された権限、小さな変更単位、自動テスト、人によるレビューを組み合わせることだ。