AI書房
本でAIを読む
金京鎮弁護士のAI・法律・産業・歴史・政治・文化をテーマにしたオンライン書籍を収録しています。各書きは目次・序文・章・エピローグで構成され、連続読書が可能です。
[AI書房] 第3章 Claude Code、誰でも使える
Claude Code完全攻略
第1部
第3章 Claude Code、誰でも使える
金京鎮
導入
毎日朝、カフェでノートパソコンを広げるフリーランスのコンサルタントがいます。彼は n8n でクライアントのメール自動分類システムを構築し、Zapier で CRM データを Google スプレッドシートに同期するワークフローを数十個運用してきました。自動化の味わいを十分に堪能した方です。しかし最近、クライアントからある質問が飛び交い始めています。
"エージェント型 AI でできることはないのでしょうか?" 彼は「エージェント」という言葉を耳にするたびに、ふと不安を感じます。コーディングを学ぶべきか、それとも Python から始めるべきかと。ところが、実際に Claude Code を開いてみると、彼が入力したのはコードではなく、日本語の文章でした。
n8n・Zapier の経験者が持つ隠れた強み
エージェントによる作業フローが注目される中、従来の自動化ツールの経験が無意味になるのではないかという懸念が生まれるかもしれません。しかし、それは正反対です。n8n や Zapier でワークフローを構築した経験がある方は、エージェントシステムを扱う際に決定的な優位性を有しています。
ウェブフック(ウェブフック)が何かを知っています。API がどのように動作するかを感覚的に理解し、データが一つのノードから別のノードへ流れる構造を頭の中に描くことができます。この基礎がない人がエージェントツールに飛び込むと、エージェントが作成した結果が優れているのか劣っているのかを判断できません。エージェントが誤った判断を下した際、それが誤りであるという事実自体に気づくことができません。
自動化の基本原理を体得した人は、エージェントへの指示も正確です。「このウェブサイトからリードを収集して」といった漠然とした依頼ではなく、「この URL から営業職の求人広告をウェブ情報収集し、職種・地域・経験年数のフィールドを含めてエクセルに整理し、200 件まで取得して」と具体的に伝えます。エージェントはこうした具体的な指示を受けた場合、はるかに優れた結果を提示します。
基礎なく飛び込むと生じる罠:ウェブフックを知らなければミスを発見できない
エージェント作業フロー市場が熱狂するにつれ、自動化の経験なくすぐに Claude Code に飛び込む人が増えています。「コーディング不要でアプリが作れる」というメッセージに惹かれてのことです。Claude Code が開発者ではない人にとっても強力なツールであることは確かですが、基礎概念を完全に無視すると危険です。
エージェントに「リードスクレイパーを作ってください」と指示したと仮定しましょう。エージェントは懸命にコードを書き、ツールを作成し、ワークフローを構築します。結果物が生まれます。しかし、その結果物が本当に良いのか、セキュリティ上の脆弱性はないか、データを正しく処理しているのか、どのように判断できるでしょうか。
ウェブフックの仕組みを知らない人は、エージェントがウェブフックの設定を誤っても気づきません。API 呼び出しの基本構造を知らない人は、エージェントが不要な API 呼び出しを繰り返してコストを浪費しても気づきません。
本書は、コーディングの経験がない読者のために書かれました。プログラミング言語を学ぶよう勧める本ではありません。ただし、自動化の基本概念 — データがどこからどこへ流れ、トリガーとは何か、API キーがなぜ必要なのか — を理解することが、エージェントのワークフローを適切に扱うために不可欠であることを強調しています。本書の前半で、その基礎を一緒に築いていきます。
コーディングを知らずにコーディングツールを扱う時代の到来
従来、ソフトウェアを作成するにはプログラミング言語を学ぶ必要がありました。変数の宣言、ループの記述、関数の定義方法を習得しなければなりませんでした。このプロセスが参入障壁となっていました。n8n や Zapier は、その障壁を一段階下げました。ノードをドラッグアンドドロップで接続するだけでワークフローが構築できるからです。手動でのコーディングに比べ、構築時間は劇的に短縮されました。
Claude Code は、その障壁をさらに一段階下げます。ドラッグアンドドロップさえ不要です。自然言語で望むものを説明するだけで、エージェントがコードを記述し、ファイルを作成し、エラーを修正します。ユーザーは Python コードを読めなくても構いません。エージェントが作成したツールファイルには .py という拡張子が付きますが、ユーザーがその中のコードを直接編集することはほとんどありません。
ユーザーの役割は、管理者、監督者、アーキテクトに近いものです。何を構築するかを決定し、成果物を検証し、方向性を修正するのがユーザーの役目です。
この変化の速さを肌で感じるには、タイムラインを確認すれば十分です。手動コーディングで自動化システムを構築する時間を基準とすると、コード不要ツールの登場により構築時間が大幅に短縮され、さらにエージェント型ツールの登場によって再び劇的に短縮されました。この傾向は加速しています。
Claude Codeがもたらす、言葉による制御の力
Claude Codeでワークフローを構築するプロセスは、指示を明確に行う人が成果を明確に受け取る過程です。「競合他社を分析して」と指示すれば、エージェントはまず何らかの成果物を生み出します。しかし、「当社はAIリード生成プラットフォームであり、主なターゲットはマーケティングエージェンシーで、月額サブスクリプション料は200ドルから500ドルの範囲です」と指示すれば、その後の成果物の質は全く異なります。
競合他社の価格戦略、中核機能、ターゲット市場を比較分析し、当社のロゴとブランドカラーを適用したPDFレポートとして作成してください」と指示すれば、成果物のレベルは全く異なるものになります。
エージェントとの対話において核心となるのは、二つの点です。目標を具体的に記述すること、そして完了基準を明確にすることです。「顧客リストを作成してください」よりも、「米国と欧州の営業職の求人広告500件をウェブ情報から収集し、職種・地域・年収の列を含むExcelファイルとして保存してください」と指示する方がはるかに優れています。エージェントは後者の指示から、いつ作業を停止すべきか、どのようなデータを収集すべきかを明確に把握できます。
n8nでノードのパラメータを一つずつ設定していた作業は、Claude Codeでは自然言語の一文で置き換えられます。APIドキュメントを読み、適切なエンドポイントを見つけ、JSONを構造化する作業をエージェントが代行します。ユーザーに残るのは「何を求めているか」を正確に表現する能力であり、それはコーディングよりも普遍的で、訓練可能なスキルです。
フリーランスのコンサルタントはカフェで最初のエージェント作業フローを完成させました。n8nでは3時間かかっていたワークフローを、Claude Codeではわずか20分で構築しました。エージェントが生成したPythonコードを一行も読まなかったにもかかわらず、結果は正確でした。彼はノートパソコンを閉じながら考えます。このツールの真の力は、コードを書くことにはありません。
自分が何を求めているかを明確に伝えられるかどうかにかかっています。そしてそれは、自動化を数年間行ってきた自分にとってすでに慣れ親しんだ筋肉のようなものでした。
[図3-01: 自動化構築時間の変化タイムライン。手動コーディングからコード不要のツール(n8n、Zapier)へ、そしてエージェンティックツール(Claude Code)へと移行する過程で、構築時間が段階的に短縮される様子を示す図表。]