Claude実践大全 第9章:Claude Codeの基礎──ファイルを直接動かすCLIエージェント入門

本記事は、『Claude実践大全:Chat・Cowork・Codeで「動くAI」を仕事に組み込む技術』を1章ずつ紹介するシリーズの第9回です。各記事では1つの章のエッセンスをダイジェストでお届けします。

第IV部から、舞台はいよいよClaude Codeへ。これはチャット欄にメッセージを送るツールではなく、ファイルを直接読み取り、解析し、書き換えるコマンドラインエージェントです。だからこそ強力で、アーキテクチャとセキュリティモデルを正しく理解しておく必要があります。第9章はその第一歩。インストールと認証から、内部動作、複数ファイルをまたぐリファクタリング、Git worktreeによる並列開発、パーミッションの扱いまでを実務の流れに沿って解説します。

CLIは内部で何をしているのか

導入は簡単で、npmでグローバルインストールし、ANTHROPIC_API_KEYを環境変数に設定するだけです。でも裏側では複数の層が連携します。タスクを指定すると、CLIはコードベースを読み込み、ディレクトリツリーやファイル要約を含む構造化プロンプトを組み立ててClaude APIへ送り、返ってきた構造化された操作を解釈してファイルを生成・変更します。

ここで返るのは自由形式のテキストではなく、CLIが実行できる一連のファイル操作です。実行層はその計画をパーミッション設定に照らし、許可されていない操作で処理を止めます。この「制御できる」点こそ、自動化を組む開発者には決定的に重要です。

コード生成とファイル操作の実際

散らばった日付ユーティリティを一つのモジュールに統合する──そんな依頼をすると、Claude Codeは関連関数を特定し、整理されたモジュールを作り、プロジェクト全体のインポートを更新し、JSDocや型定義、インデックスファイルまで添えます。しかも入力値の検証や丁寧なエラー処理を自動で足し、本番投入に耐える品質へ引き上げます。数十個のAPIルートを新パターンへ揃える、データベースモデルの足場を生成するといった骨の折れる作業も、一度説明するだけで系統立てて片づきます。

Git worktreeで安全に並列開発する

複雑なリファクタリングを管理する強力な手法が、Git worktreeとの組み合わせです。同じリポジトリから複数の作業ディレクトリを切り出し、別ブランチで並行作業できます。Claude Codeが片方で作業する間、自分はmainで作業を続け、レビューしてからマージ。Claude Codeが誤れば、worktreeを破棄するだけでmainには一切影響しません。

大規模なリファクタリングでは、ステージング用worktreeで反復的に磨き込むのが効きます。一度で完璧を狙うより、生成→レビュー→改善の反復のほうが、はるかに制御しやすいのです。

パーミッションと自動承認モード

Claude Codeは既定で対話モードで動き、ファイル操作のたびに承認を求めます。これが最も安全な使い方です。CI/CDなど自動化では自動承認モードで確認をスキップできますが、これは起動内容を完全に信頼でき、適切なレビュー体制が整っている場合に限るべきもの。安全に運用するための範囲制限やCI/CD連携の作法は、本書でじっくり確かめてください。

この章で得られること

• Claude Code CLIのインストール・認証と、内部アーキテクチャの全体像
• 複数ファイルをまたぐリファクタリングやボイラープレート生成の実際
• Git worktreeでリスクを隔離しながら並列開発する手法
• パーミッションと自動承認モードを安全に扱うためのガードレール

使いこなせば、これまで何日もかかったリファクタリングやレビューを数時間で。ただしその高速化は、特性テストを書き、生成された変更を注意深くレビューする規律があってこそ成り立ちます。

次回:第10章「レガシーコードを安全にリファクタリングする」。テストチェックポイントを挟みながら、古いコードベースに手を入れる現実的な手順へ進みます。