Knowledge Notebook
一覧に戻る

あなたの代わりに作業するAI部下「Claude Code」の育て方・使い方マニュアル

先日、開発コミュニティで大きな話題になっている「Claude Code(クロード・コード)」を、恐る恐る自分のパソコンにインストールしてみました。これまでのように質問に答えるだけのチャットAIとは違い、コマンド一発でファイルを探し出し、テストを実行し、エラーまで勝手に直してGitコミットしてくれるその挙動は、まさに「自律して働くAIエージェント」そのものです。

今回は、私が実際に日々の開発作業で使い倒して分かったリアルな使用感を交えながら、基本的な使い方や、このAI部下を「自分好みの優秀なパートナー」へと育てるマニュアルを分かりやすく整理しました。

1. 「AIエージェント」とは?従来のチャット型AIとの違い

まずは、今回ご紹介する「Claude Code」の根底にある「AIエージェント」という概念について説明します。これまでのAIと何が違うのか、シンプルに整理してみましょう。

  • これまでのAI(チャット型): 質問すると、言葉でアドバイスや回答を返してくれるもの(ChatGPTや通常のClaudeなど)。
  • AIエージェント: 回答を返すだけでなく、ユーザーの代わりにパソコンを動かして、実際の作業まで実行してくれるAIのこと。

AIエージェントに指示を出すと、例えば以下のような作業を自動でこなしてくれるようになります。

  • 書類の自動まとめ: 大量の領収書や請求書ファイルが入ったフォルダを渡し、「取引先、金額、日付ごとにスプレッドシートにまとめて」と頼むと、一瞬で整理された表が作成されます。
  • ごちゃごちゃしたフォルダの整理: 画像やPDF、テキストが混ざったフォルダを、データの種類や日付ごとに素早く仕分けてくれます。
  • 簡単なアプリケーションの作成: 難しいプログラミング言語を自分で書かなくても、日本語で指示を出すだけで、自分専用の便利な小道具やツールを短時間で構築させることができます。

AIエージェントは、例えるなら「知識は非常に豊富だが、まだ自社の業務ルールを知らない優秀な新入社員」です。能力が高くても、最初はあなたの好みや仕事の進め方を理解していません。だからこそ、「自分好みのルール(マニュアル)を与えて育てていくこと」が、業務を効率化するための鍵になります。

2. なぜ「Claude Code」から始めるべきなのか

現在、多くのIT企業がAIエージェントの開発を進めていますが、その中でもAnthropic社が提供する「Claude Code」をまず知っておくことをおすすめします。

理由は、現在登場している多くのAIエージェントツールにおいて、このClaude Codeの動作モデルやルール構築の手法が、実質的なスタンダード(基準)として参考にされているからです。つまり、この仕組みを一度理解しておけば、今後他のAIツールが登場した際にも、スムーズに対応できるようになります。

※なお、実際に動作させるにはClaudeのプロプランなどのアカウントが必要になりますが、まずは仕組みを理解し、本当に自分にとって必要だと感じてから導入を検討すれば十分です。

3. 快適な作業環境「VS Code」の準備手順

Claude Codeの力を引き出すためには、Microsoftが無料で提供している開発環境「VS Code(Visual Studio Code)」を利用するのが最もスムーズです。手順はシンプルに以下の4ステップです。

  1. 公式サイトからお使いのOSに合ったVS Codeをダウンロードし、インストールします。
  2. 起動後、画面左側にある拡張機能(パズルのピースのようなアイコン)から「Japanese Language Pack」を検索してインストールし、日本語化します。
  3. 同じく拡張機能から「Claude」と検索し、公式のClaude拡張機能を追加します。
  4. ご自身のClaudeアカウントと連携(サインイン)すれば、基本的な準備は完了です。

作業を行う際は、パソコンの中に「AIの作業部屋」となる専用のプロジェクトフォルダを1つ作成し、その中でAIに仕事を依頼する形をとります。これにより、関係のないファイルにAIが触れるのを防ぐことができます。

4. 安全を守るための「許可モード」の選択

AIに「このフォルダにある資料を整理して、構成案を作って」と日本語で指示を出すと、AIがファイルを読み書きし始めます。この際、安全性の観点から、AIが勝手にファイルを書き換えないよう「実行許可」を求める仕組みになっています。

この確認の手間は、利用シーンに応じて以下の3つのモードで調整が可能です。

  • アスク(Ask)モード: ファイルの変更やコマンドの実行ごとに、毎回ユーザーの許可を求める最も安全なモード。
  • エディット(Edit)モード: 通常の書き換え作業は自動で行い、特にシステムに関わる重要な操作のときだけ確認を求める実用的なモード。
  • プラン(Plan)モード: 実際に作業へ入る前に、「こういう手順で進めます」という計画書を提示し、合意を得てから作業するモード。

使い始めの時期は「アスクモード」や「プランモード」でAIの動きを見守り、操作に慣れてきたら「エディットモード」に切り替えて効率的に作業を進めるのがおすすめです。

5. AI部下を優秀に育てる「2つの秘密道具」

Claude Codeを「頼れる部下」にするための最も重要な仕組みが、共通ルール(claude.md)業務マニュアル(スキル)の2つです。

① `claude.md`(共通の基本ルール)

AIは新しい会話(セッション)を始めるたびに、過去のやり取りを忘れてリセットされてしまいます。毎回「回答は日本語で」「見出しはこうして」と指示し直すのは手間がかかります。

そこで、作業用フォルダの直下に claude.md という名前のテキストファイルを作成しておきます。ここに「このフォルダではブログ記事の執筆を行います」「出力は箇条書きを優先してください」といった前提ルールを書いておくと、AIは会話を始める前にこのファイルを自動で読み込みます。これにより、前提条件を毎回説明する手間が省けます。

② スキル(業務マニュアル)

こちらは、特定の作業を正しく行うための個別マニュアルです。例えば、AIと協力してうまく資料を作成できた際に、「今行った手順を『週次レポート作成手順』としてスキル登録して」と依頼します。すると、AIはその手順をマニュアル化して記憶します。次回からは「あの手順でお願い」と一言伝えるだけで、登録されたフローに沿って正確に作業を実行してくれます。

コンビニの運営に例えるなら、`claude.md` は「接客時は笑顔で」「営業時間は24時間」といった店舗共通の基本ルールであり、スキルは「レジの操作方法」「品出しの手順」といった業務ごとのマニュアルです。すべてを基本ルールに書き込むとAIが混乱するため、基本方針は claude.md に、具体的な手順はスキルとして切り分けて管理するのが、賢く育てるコツです。

実際にClaude Codeを動かした時の挙動と使用感

私のローカル環境で、Claude Codeに対して「フォルダ内の全HTMLファイルを調査して、タイトルをマイルドに修正し、コミットして」と依頼した際の、実際のターミナルの出力サンプル(抜粋)です。

$ claude "HTMLのタイトルをマイルドに直して"
Thinking...
  I will:
  1. Search for HTML files in the project directory.
  2. Inspect the <title> tags for sensational keywords.
  3. Propose and apply modifications.
  4. Commit the changes using git.

  [Tool Call: grep_search for "<title>"]
  [Tool Call: view_file ...]
  
  I found 7 files with sensational titles (e.g., "【徹底解説】", "【保存版】").
  I plan to modify these to flatter versions.
  
  [Request] Edit notes/general/mellojoy-how-to-buy.html? [y/N] y
  [Tool Call: replace_file_content ...]
  ✓ Updated notes/general/mellojoy-how-to-buy.html

  [Tool Call: run_command "git add -A && git commit -m ..."]
  ✓ Successfully committed title changes.
  
I have updated the titles of the 7 HTML files and committed the changes to Git.

使用感のリアルなレビュー:
実際に動かしてみて感動したのは、AI自身が「自分でディレクトリ構造を調べ、grep検索をかけ、プランを立てて実行する」というプロセスの滑らかさです。アスク(Ask)モードに設定していれば、上記のようにファイルを書き換える直前で必ず「y/N」の確認を求めてくれるため、AIに勝手にコードを壊される心配がありません。思考(Thinking)のスピードも極めて早く、一連の修正が数分で完了する実用性の高さには驚かされました。

6. 外部サービスとつなぐ「MCP」と「API」の活用

Claude Codeは、パソコン内の作業にとどまらず、外部のツールやサービスと連携させることで、さらに活用の幅が広がります。

  • MCP(Model Context Protocol): これを介してGoogleカレンダーや各種データベースと連携させることで、「カレンダーから予定を読み取って整理する」「メールの下書きを作成する」といった業務連携が可能になります。
  • APIの連携: 他の画像生成AIや翻訳サービスなどの外部APIキーを登録することで、Claudeから直接それらの機能を呼び出し、ブログの挿絵を自動生成させるなどの連携が行えます。

⚠️ セキュリティ上の重要な注意点
外部連携で利用する「APIキー」は、クレジットカード番号と同等の極めて重要な情報です。他人に教えたり、AIとのチャット画面に直接貼り付けたりしてはいけません。必ず専用の環境変数ファイル(.env ファイルなど)に保存し、外部に露出しないよう細心の注意を払ってください。

7. セキュリティが心配な場合の選択肢「GitHub Codespaces」

「いくら便利でも、自分の本番用パソコンのファイルをAIに直接操作させるのは、誤操作やデータの消失が心配だ」と感じるのは、セキュリティ意識として非常に健全です。

そこでおすすめしたいのが、無料から利用できるクラウド開発環境「GitHub Codespaces(ギットハブ・コードスペース)」です。これはインターネット上に作成できる「安全な使い捨ての仮想パソコン」のようなものです。この仮想環境の中でClaude Codeを動作させることで、万が一AIが予期しないファイルの削除を行っても、ご自身のパソコンには一切影響が及びません。安全に検証したい場合に最適な環境です。

導入前は「自分のPC内のファイルを直接AIに触らせるなんて、怖くて使い物にならないのでは」と懐疑的でしたが、今では日々の細かなGit操作や文字列の置換といった「手作業的雑務」はすべてClaude Codeに任せています。自分が設計や実装の核心に集中できるようになり、開発の快適さが大きく向上しました。

トークン消費によるAPI利用料金や機密情報の取り扱いには一定の注意を払う必要がありますが、この「AIが自律して動く心地よさ」は、これからの時代の新しい開発スタンダードになると感じています。興味がある方は、使い捨ての仮想環境(GitHub Codespaces)などから試してみるのが良さそうです。