Claude Code で初めての AI エージェントを構築する方法（完全初心者向けコース）

Claude Code のインストール方法、ゼロからエージェントを作成する手順、そして実際に動作するエージェント（フォルダを読み込み、問題を特定し、レポートを作成する）を、コーディング経験不要で構築する方法を学びます。

チャットボットは、あなたが質問をするのを待って、それに答えます。AI エージェントは違います。あなたがゴールを与えると、エージェントが自らステップを考え、ファイルを読み込み、コマンドを実行し、タスクが完了するまで自律的に行動します。あなたがすべての動きを指示するわけではありません。目的地を設定するだけです。

この違いは重要です。なぜなら、何を自動化できるかが変わるからです。あなたはプロンプトを一つずつ入力しているのではありません。あなたが他のことに集中している間、作業を代行してくれるものを作っているのです。

始める前に必要なもの

1 つのコマンドも実行する前に、必要なものはすべてここにあります。

• 有料プランの Claude アカウント（最低限 Pro プラン $20/月。Claude Code は含まれています）
• macOS 13 以降を搭載した Mac、または Windows PC、Linux マシン
• インターネット接続
• セットアップと最初の構築に約 30 ～ 45 分

事前のコーディング経験は不要です。このガイド内のすべてのコマンドは完全な形で記載されています。コピーして貼り付け、Enter キーを押すだけです。

このガイドに従うための費用：サブスクリプション以外は $0 です。Claude Code は、すべての有料 Claude プランに含まれています。

Claude Code のインストール（デスクトップアプリ、ターミナル不要）

初心者にとって最も簡単な方法はデスクトップアプリです。ターミナルコマンドを覚えなくても、Claude Code のすべてのパワーを利用できます。

claude.ai にアクセスし、お使いのプラットフォーム用のデスクトップアプリをダウンロードします。macOS の場合は、.dmg ファイルを開き、Claude をアプリケーションフォルダにドラッグします。Windows の場合は、インストーラーを実行します。アプリを起動し、Claude アカウントでサインインして、画面上部中央の「Code」タブをクリックします。

「Code」タブでプランのアップグレードを求められた場合、現在のプランには Claude Code が含まれていません。オンラインでのサインインを求められた場合は、サインインを完了してアプリを再起動してください。いずれの場合も、完了するとクリーンなワークスペースが表示されます。

成功の目安：Code タブがアクティブで、エラーメッセージが表示されていない、空のプロンプトボックスが表示されます。それがあなたのエージェントワークスペースです。ここで構築するすべてのものが動作します。

構築するもの

このガイドを通して、特定の 1 つのエージェントを構築し、使用していきます。

エージェントの役割：テキストファイルのフォルダを読み取り、先頭に行がないファイルを見つけ、修正が必要なファイルをすべてリストアップしたレポート missing-titles.txt を作成します。

これは実用的なタスクです。ファイルの読み取り、意思決定、出力の書き込みという、すべてのコアなエージェント動作を示しています。また、動作したかどうかを目視で確認できるほどシンプルです。

ステップ 1: 作業フォルダを作成する

デスクトップに my-agent という名前の新しいフォルダを作成します。これがエージェントの作業場所です。エージェントはこのフォルダ内のファイルのみを参照・操作できるため、すべてが安全に隔離されます。

my-agent の中に、articles という名前の 2 つ目のフォルダを作成します。ここがエージェントがチェックするファイルを探す場所です。

次に、articles 内に 4 つのプレーンテキストファイルを作成します。ファイル名は post-one.txt、post-two.txt、post-three.txt、post-four.txt とします。そのうち 2 つのファイルを開き、最初の行として以下を追加します。

1Title: My Article

残りの 2 つのファイルは完全に空のままにします。エージェントの仕事は、それらの空のファイルを見つけることです。

成功の目安：フォルダ構造が my-agent/articles/ となり、4 つの .txt ファイルが含まれ、そのうち 2 つにはタイトル行があり、2 つにはありません。

ステップ 2: CLAUDE.md 指示ファイルを書く

CLAUDE.md は、Claude Code がセッションの開始時に毎回読み取るプレーンテキストファイルです。これはエージェントに対する常設の指示であり、決して忘れないジョブの説明書に相当します。

my-agent フォルダ内（articles の中ではありません）に、CLAUDE.md という名前の新しいファイルを作成します。任意のテキストエディタ（Windows のメモ帳や Mac の TextEdit など）で開き、以下をそのまま貼り付けます。

1# My File Checker Agent
2
3## あなたの仕事
4
5/articles フォルダ内のすべての .txt ファイルをチェックします。
6
7## チェック項目
8
9有効なファイルは、最初の行が次のように始まっている必要があります：Title:
10
11最初の行が "Title:" で始まっていない場合、そのファイルにはタイトルがありません。
12
13## 実行手順
14
151. /articles 内のすべての .txt ファイルを 1 つずつ読み取ります。
162. Title 行がないファイルを特定します。
173. メインフォルダに missing-titles.txt というファイルを作成します。
184. そのファイルに、チェックに失敗した各ファイル名を 1 行に 1 つずつリストします。
195. すべてのファイルがパスした場合は、missing-titles.txt に "All files have titles." と書き込みます。
20
21## 禁止事項
22
23記事ファイルを編集しないでください。読み取りのみ行います。書き込みは missing-titles.txt のみに行います。

ファイルを保存します。これがエージェントの頭脳全体です。Claude Code は、何かを行う前にこれを読み取ります。

成功の目安：my-agent/CLAUDE.md にファイルが作成され、上記の指示が含まれています。

ステップ 3: Claude Code にフォルダを指定する

Claude Code デスクトップアプリを開き、フォルダアイコンまたは「フォルダを開く」オプションをクリックして、my-agent フォルダに移動し、選択して確認します。

Claude Code は自動的に CLAUDE.md ファイルを読み取ります。確認メッセージは表示されませんが、フォルダを開くたびにバックグラウンドで自動的に行われます。

デスクトップアプリの代わりにターミナルを使用する場合は、ターミナルを開いて以下を実行します。

1cd ~/Desktop/my-agent
2claude

cd コマンドは「ディレクトリを変更する」という意味です。my-agent フォルダに移動します。claude と入力すると、そのフォルダ内でエージェントセッションが開始されます。

ステップ 4: エージェントを実行する

Claude Code インターフェース下部のプロンプトボックスに、以下をそのまま入力します。

1articles フォルダ内のすべての .txt ファイルを読み取ってください。先頭に Title 行がないファイルを見つけてください。CLAUDE.md の指示に従って、結果を missing-titles.txt に書き込んでください。

Enter キーを押します。何が起こるか見てみましょう。

Claude Code は実行中にその作業内容を表示します。つまり、どのファイルを読み取っているか、各ファイルで何を見つけたか、何を書き込んでいるかがわかります。この透明性は意図的なものです。すべてのアクションを実行前に確認でき、問題があれば停止できます。

成功の目安：Claude が 4 つのファイルを読み取り、タイトルのない 2 つを特定し、my-agent フォルダに missing-titles.txt を作成します。そのファイルを開くと、2 つのファイル名が 1 行に 1 つずつリストされているはずです。

初心者がよくやる間違い：エージェントが完了したと言っているのに、ファイルが空である

これは、エージェントが missing-titles.txt を作成したものの、実際には何も書き込んでいない場合に発生します。原因はほとんどの場合、CLAUDE.md の指示が曖昧すぎることです。

修正方法：CLAUDE.md を開き、出力指示をより明確にします。「ファイルをリストする」代わりに、「各ファイル名を独自の行に、次のように書き込んでください：post-two.txt」と記述します。指示に具体的な例を含めると、毎回具体的な出力が得られます。

エージェントが間違ったファイル名を書き込んだり、1 つ見逃したりした場合は、記事ファイルの拡張子が実際に .txt であり、Windows でファイル拡張子が非表示になっている場合に発生する .txt.txt ではないことを確認してください。ファイルエクスプローラーの設定で「ファイル名拡張子を表示する」をオンにして確認します。

ステップ 5: 確認と拡張

missing-titles.txt を開き、空のままにした正確に 2 つのファイルがリストされていることを確認します。リストされていれば、エージェントは最初から最後まで正しく動作しています。

これで、動作するエージェントが完成しました。これは my-agent に存在し、CLAUDE.md から指示を読み取り、新しいファイルを articles フォルダにドロップして同じプロンプトを実行するたびに実行できます。

明確な次のステップ：CLAUDE.md を更新して、各ファイルが 5 行を超えているかどうかもチェックするようにします。「チェック項目」の下に以下を追加します。

1有効なファイルには、5 行を超えるコンテンツも必要です。
2ファイルが 5 行以下の場合は、タイトルチェックと一緒に「短すぎる」としてフラグを立てます。

同じプロンプトでエージェントを再度実行します。これで、プロンプトを変更せずに、指示ファイルの変更だけで、2 つのことをチェックするようになります。

構築したものとその重要性

あなたは、各ステップを監視することなく、ファイルを読み取り、判断し、出力を書き込むエージェントを構築しました。これは、今後構築するであろう、より高度なエージェントの背後にある中核的なパターンです。

CLAUDE.md ファイルは、拡張可能な部分です。新しいルール、新しいチェック、新しい出力形式を追加するたびに、実行方法を変更することなく、エージェントの動作が変わります。プロンプトは同じまま、指示が進化します。

ここから、自然な拡張としては、より多くのファイルタイプのチェック、レポートを CSV などの異なる形式で書き込む、Claude Code の組み込み Routines 機能を使用してスケジュールに従ってチェックを実行する、などが考えられます。

いずれかのステップについて質問がありますか？以下にコメントを残してください。