高性能エージェンティックプログラミングのためのClaude Codeセットアップ初心者ガイド

ほとんどの人のClaude Codeのセットアップは初日を超えることはありません。インストーラを実行し、ログインし、プロンプトを入力して有用な結果を得て、その後設定ファイルに触れることはありません。数週間後には、セッションは以前の決定を追跡できなくなり、同じ権限プロンプトが1日に50回表示され、すべての長いタスクは同じように終わります：コンテキスト警告の壁と、会話を放棄して最初から再開しなければならないことです。

これらはモデルの限界ではなく、セットアップの限界です。Claude Codeには適切なデフォルトが用意されていますが、適切なデフォルトと高性能は異なる基準であり、そのギャップはほとんど初心者が開いたことのない少数のファイルによって構成されています。このガイドはそのギャップを埋めるものです。実際の設定、権限、フック、およびコマンド習慣について説明し、これらは新規インストールと実際の持続的なエージェント作業に耐えるセットアップを分けるものであり、Anthropicの現在のドキュメントに基づいて検証されています。

Claude Codeの正しいインストール

Claude Codeはスタンドアロンのコマンドラインインターフェース（CLI）としてインストールされ、現在推奨される方法はネイティブインストーラーですが、npmもフォールバックとして機能します。インストール後、初めてclaudeを実行する前に、実際のプロジェクトディレクトリにcdしてください。これは重要です：Claude Codeは起動したディレクトリにプロジェクトメモリと設定をスコープするため、ホームフォルダやデスクトップから起動すると、作業中の何に対しても正しいコンテキストを取得できません。

初回実行では認証が行われます：Claudeサブスクリプション（Pro、Max、Team）でのOAuthログイン、またはコンソールアカウントにリンクされたAPIキーです。ターミナル以外にも、Claude CodeはVS Code拡張機能、JetBrainsプラグイン、デスクトップアプリ、Webベースのバージョンでも利用可能で、すべて同じ設定とプロジェクトファイルを読み取ります。

3つの重要なファイル

Claude Codeは2つの場所から設定を読み取ります：プロジェクトの.claude/ディレクトリ（およびプロジェクトルートのCLAUDE.md）と、全プロジェクトに適用されるグローバルな~/.claude/ディレクトリです。これらの違いを理解することが、ツールのパフォーマンスを左右する最大の要因です。

CLAUDE.mdはプロジェクトメモリであり、Claudeがそのリポジトリの各セッション開始時に読む指示です：アーキテクチャノート、ビルドおよびテストコマンド、コードスタイルルールなど。/initコマンドで初期ファイルを生成し、/memoryで調整します。簡潔に保ち、Anthropicのガイダンスでは約2500トークン以下に抑え、長い内容やパス固有のものは.claude/rules/*.mdファイルにプッシュします。

settings.jsonは.claude/settings.json（プロジェクトレベル）または~/.claude/settings.json（個人のデフォルト）に存在し、権限、フック、環境変数、モデルのデフォルトを実際に格納します。これはほとんどの初心者が開いたことのないファイルであり、ツールに関する2つの最も一般的な不満（絶え間ない権限の中断と、タスクに必要なよりも高価なモデルを使用すること）に直接関係しています。

自動メモリは新しい静かなレイヤーです：Claudeはセッション中に自分の作業ノートを読み書きでき、autoMemoryEnabled設定またはCLAUDE_CODE_DISABLE_AUTO_MEMORY環境変数で切り替えます。

実用的なルール：安定したルールはCLAUDE.mdに書くべきです。会話履歴にのみ埋め込まれた指示は、長いセッションが自動圧縮をトリガーすると失われるからです。ルールが今日のセッションを超えて生き残る必要があるなら、書き留めてください。

権限とフックの設定

Claude Codeは3つの権限モードのいずれかで動作します：デフォルト（リスクのあるツールコールのたびに確認）、自動編集受け入れ（ファイル編集を確認なしで許可するが、他のツールは制限）、プランモード（読み取り専用、計画を承認するまで実行なし）。不慣れなコードベースでの最初のセッションではプランモードをデフォルトにすることをお勧めします。

settings.jsonでは実際の権限ルールを記述でき、同じ安全なコマンドをセッション中に50回手動で承認する必要がなくなります。例えば、npm test:*などのパターンを許可し、rm -rf /*などの危険なコマンドを拒否できます。拒否ルールは許可ルールよりも優先されます。

フックは権限ルールを超えます：ルールは呼び出しを許可またはブロックするだけですが、フックは呼び出しに応答して実際に何かを実行できます。PostToolUseフックは、Claudeがファイルを編集するたびに自動フォーマット（Prettierを使用）を実行できます。PreToolUseフックは、危険なコマンドが実行される前にブロックでき、より強力な保証を提供します。例えば、Pythonスクリプトを使用して、コマンドに再帰的な強制削除、sudo rm、chmod 777、またはメインブランチへの強制プッシュが含まれているかどうかをチェックし、それらをブロックできます。

最初に学ぶ価値のあるコマンド

Claude Codeには現在60以上の組み込みコマンドがありますが、初心者がすべてを覚える必要はありません。/compact（会話履歴を要約してコンテキストを解放）、/plan（プランモードの切り替え）、/diff（セッションのすべての変更のインタラクティブな差分を表示）を最初に習得することを優先してください。これら3つだけで初期のフラストレーションのほとんどを解決できます。/init、/memory、/clear、/context、/model、/effortなどの他のコマンドは必要に応じて学習します。

独自の/truthコマンドを作成する

/truthは公式コマンドではありませんが、カスタムスキルを使って同様の機能を実装できます：Claudeに、その主張を信頼する前に実際のコードベースと照合させることです。.claude/skills/truth/SKILL.mdファイルを作成し、説明と許可するツール（Read、Grep、Glob、Bashなど）を定義します。その後、そのスキルを使ってClaudeの最近の主張が正確かどうかを確認します。

このガイドのセットアップを通じて、Claude Codeを効率的で信頼性の高いエージェンティックプログラミングに最大限活用できるようになります。