自分でビジネスを始めたいなら、30分だけ時間を確保してください。
なぜなら今日は、コーディング知識がゼロでも、本格的に機能する AI エージェントを半日で構築する方法を説明するからです。
これからお伝えする内容を、チャットボットと混同しないでください。チャットボットは質問を待って回答を返します。エージェントは違います。あなたが目標を与えると、エージェント自身が手順を設定し、ファイルを読み込み、コマンドを実行し、仕事が完了するまで自律的に進めます。あなたは一つ一つの動きを管理するのではなく、ルートを描くだけです。
この違いは重要です。なぜなら、あなたはもはやプロンプトを一つずつ書く必要がないからです。あなたが他の作業をしている間にも、仕事は自動的に進んでいきます。
必要なものは？
インストール前に必要なものはすべてここにあります：
- 有料の Claude プラン（Pro、月額 $20、Claude Code を含む）
- Mac（macOS）、Windows、または Linux
- インターネット接続
- 30〜45 分の自由時間
コーディング知識は一切不要です。すべてのコマンドは完全な形で書かれています。コピー＆ペーストして Enter キーを押すだけです。
追加費用はかかりません。サブスクリプション以外に一銭も使う必要はありません。
インストール：デスクトップアプリケーション、ターミナル不要
初心者にとって最も簡単な方法は、デスクトップアプリケーションを使用することです。これにより、ターミナルを学ばずに Claude Code のすべてのパワーを手に入れることができます。
お使いのオペレーティングシステムに適したデスクトップアプリケーションを claude.ai からダウンロードしてください。Mac の場合は .dmg ファイルを開き、Claude をアプリケーションフォルダにドラッグします。Windows の場合はインストーラーを実行します。アプリケーションを開き、アカウントでログインし、上部中央の「Code」タブをクリックします。
Code タブでプランのアップグレードを求められた場合、現在のプランが Claude Code をカバーしていないことを意味します。オンラインログインを求められた場合は、ログインを完了してアプリケーションを再起動してください。いずれの場合も、最終的には空のワークスペースが表示されます。
ここでの成功とは、空のプロンプトボックス、アクティブな Code タブ、そしてエラーメッセージがないことです。これから構築するすべてのものは、この領域に存在することになります。
何を構築するのか？
シンプルで明確なエージェントを一つ構築し、記事の最後まで同じエージェントで進めていきます。
そのタスクは次の通りです：フォルダ内のテキストファイルを読み込み、タイトルが欠けているファイルを見つけ、修正が必要なファイルをリストアップした missing-titles.txt という名前のレポートを作成します。
小さくても実際のタスクです。これには、エージェントが行うべき3つの基本的なこと、すなわちファイルの読み取り、意思決定、出力の書き込みが含まれています。そして、それが正しく動作するかどうかを自分の目で確認できるほどシンプルです。
ステップ 1：作業フォルダのセットアップ
デスクトップに my-agent という名前のフォルダを作成します。エージェントはここで作業します。このフォルダの内部だけを見て操作できるため、すべてが安全に保たれます。
my-agent の中に、articles という名前の2つ目のフォルダを作成します。エージェントはチェックするファイルをここで探します。
articles の中に、4つのプレーンテキストファイルを作成します：post-one.txt、post-two.txt、post-three.txt、post-four.txt。そのうち2つのファイルを開き、一番上に次のように記述します：
Title: 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）で開き、以下を正確に貼り付けます：
# My File Check Agent ## Your Task Check every .txt file in the /articles folder.
## What to look for A valid file starts with this line: Title: If the first line does not start with "Title:", the file's title is missing.
## What to do 1. Read every .txt file inside /articles one by one. 2. Note which files have missing titles. 3. Create a file named missing-titles.txt in the main folder. 4. Write each filename that failed the check into this file, one per line. 5. If all files are valid, write "All files have titles." into missing-titles.txt.
## What not to do Do not edit any article files. Only read. Only write to the missing-titles.txt file.
保存します。これがエージェントの頭脳全体です。Claude Code は他の何よりも先にこれを読み取ります。
my-agent/CLAUDE.md ファイルが作成され、上記の指示が含まれていれば、それで完了です。
ステップ 3：Claude Code をフォルダに誘導する
Claude Code デスクトップアプリケーションを開き、フォルダアイコンまたは「フォルダを開く」オプションをクリックし、my-agent フォルダに移動します。選択して確定します。
Claude Code は自動的に CLAUDE.md ファイルを読み取ります。確認メッセージは表示されません。これはフォルダを開くたびにバックグラウンドで静かに行われます。
ターミナルを使用する場合は、ターミナルを開いて以下を実行します：
cd ~/Desktop/my-agent claude
cd コマンドは「ディレクトリを変更する」という意味で、my-agent フォルダ内に移動します。claude と入力すると、そのフォルダからセッションが開始されます。
ステップ 4：エージェントを実行する
Claude Code インターフェースの下部にあるプロンプトボックスに、以下を正確に入力します：
Read every .txt file in the articles folder. Find any file missing a Title line at the top. Write the results to missing-titles.txt as instructed in CLAUDE.md.
Enter キーを押します。そして、見守ってください。
Claude Code は作業中に行うすべてのことを表示します：どのファイルを読み取っているか、各ファイルで何を見つけたか、何を書き込んでいるか。この透明性は意図的なものです。すべてのアクションが実行される前に確認でき、何かおかしいと思ったら停止できます。
Claude は4つのファイルを読み取り、タイトルのない2つを検出し、my-agent フォルダに missing-titles.txt ファイルを作成します。ファイルを開くと、2つのファイル名が上下に並んで表示されるはずです。
最も一般的なエラー：エージェントが「完了」と言うが、ファイルが空である
これは通常、エージェントが missing-titles.txt ファイルを作成するものの、中に何も書き込まない場合に発生します。その理由は、ほとんどの場合、CLAUDE.md の指示が曖昧すぎることです。
解決策：CLAUDE.md を開き、出力指示をより具体的にします。「ファイルをリストする」の代わりに、「各ファイル名を独自の行に書き込む。例：post-two.txt」と記述します。指示に具体的な例を含めることで、毎回具体的な出力が得られます。
エージェントが間違ったファイル名を書き込んだり、ファイルをスキップしたりする場合は、記事ファイルの拡張子が本当に .txt であり、.txt.txt ではないことを確認してください。これは Windows でファイル拡張子が非表示になっている場合によく発生します。エクスプローラーの設定から「ファイル拡張子を表示する」をオンにして確認してください。
ステップ 5：確認と拡張
missing-titles.txt ファイルを開き、空白のままにしておいた2つのファイルがリストされていることを確認します。正しければ、エージェントが最初から最後まで正しく動作したことを意味します。
これで、動作するエージェントができました。これは my-agent に存在し、CLAUDE.md から指示を受け取り、新しいファイルを articles フォルダにドロップするたびに、同じプロンプトで再実行できます。
次の明確なステップ：CLAUDE.md を更新し、各ファイルが5行より長いかどうかもチェックするようにします。「What to look for」の見出しの下に、以下を追加します：
**A valid file also contains content longer than 5 lines. If a file is 5 lines or shorter, also mark it as "too short" next to the title check.**
同じプロンプトでエージェントを再度実行します。これで、1つではなく2つのことをチェックするようになります。プロンプトは変更せず、指示ファイルだけを変更しました。
あなたは何をしたのか、そしてなぜそれが重要なのか？
あなたは、ファイルを読み取り、意思決定を行い、出力を書き込み、そしてすべてのステップを監視することなくこれを行うエージェントを構築しました。これは、今後構築するすべてのより高度なエージェントの基本パターンです。
スケールする部分は CLAUDE.md です。そこに追加する新しいルール、新しいチェック、新しい出力形式はすべて、実行方法を変えることなく、エージェントの動作を変更します。プロンプトは同じままで、指示が進化します。
ここからの自然なステップ：より多くのファイルタイプのチェック、CSV などの異なる形式でのレポート作成、または特定の間隔でチェックを自動的に繰り返すようにすること。
おめでとうございます。最初の一歩を踏み出しました。残りはあなたの手の中にあり、あなたの想像力に比例します。
差が広がる前に、行動を起こしましょう。
保存して共有し、コメントでサポートすることを忘れないでください。
