[ハンズオン資料は最後に！]
AIコーディングエージェントが急速に普及するなかで、「ツールの存在は知っているが、実際の開発フローにどう組み込めばよいか分からない」という声を、組織の規模を問わずよく耳にするようになりました。
今回、SaaS開発企業において業務委託として働かれている個人事業主の富永様(*)にエージェント型AI開発の第一歩を踏み出すための「Claude Code 基礎編ハンズオン」を導入。本記事では、その教材の狙いと、導入によって得られた具体的な成果を紹介します。
*富永様に掲載の許可は頂いております
1. 導入の背景：チャット型AIの「先」にある高い壁
今回の事例では、富永様はすでにChatGPTやGitHub Copilotなどの「チャット型AI」を部分的に利用していました。しかし、そこには一つの大きな課題がありました。
それは、「AIに断片的なコードを書いてもらう使い方」しかできておらず、「エージェントにリポジトリ全体を任せる使い方」ができていないという点です。
AIエージェントの可能性を感じつつも、効率的な活用方法を見いだせないと相談いただいたのが、今回のプロジェクトの出発点です。
2. ハンズオン教材の概要：コードは書かない。書くのは「指示」と「検証」だけ
本教材では一貫して、「人間はコードを書かない。書くのは日本語の指示と動作確認コマンドだけ」という方針を徹底しています。AIに任せる範囲を最大化し、人間は「方針決定」と「検証」に集中するという、AIネイティブ開発の前提を身体に染み込ませることが狙いです。
教材は以下の3章構成で実施しました。
章
テーマ
題材
習得できるスキル・感覚
基礎編① 小規模開発
ゼロからのローカル開発
自作TODOアプリ（CLI/Flask）
日本語の依頼だけで動くものが完成する体験。AIに任せられる最小単位の把握。
基礎編② 大規模開発
既存コードベースの理解と修正
Joplin（OSS/モノレポ構成）
数万行の未知のコードでも、AIに整理させれば「どこを読み、どこを直すべきか」が即座に分かる感覚。
基礎編③ 並列AI開発
複数AIによる分業
個人ダッシュボード開発
複数のエージェントを役割分担させ、コンテキストを分離して開発を加速させる手法。
ステップアップの設計
- 基礎編①では、AIエージェントに依頼を投げる「リズム」を身につけます。
- 基礎編②では、あえて自分が一行も書いていない大規模なOSS（Joplin）を題材にし、「AIをナビゲーターにして未知の領域を攻略する」体験を提供します。
- 基礎編③では、1体にすべてを任せるのではなく、役割の異なる複数のエージェントを使い分けることで、並列性と効率性を高める世界観を体感します。
3. 導入によって得られた3つの成果
このハンズオンを実施した結果、富永様より開発効率が大きく向上した旨をご報告頂きました。
① AIに任せられるタスクの「解像度」が向上
「どこまでAIに任せていいのか」という線引きがチーム内で具体化され、結果として、人間が手でキーボードを叩く時間は劇的に減り、その分、設計のレビューやプロダクトの本質的な方針決定に時間を割けるようになりました。
② 新規参入・未知の領域への学習コストが激減
大規模な既存コードベースの調査をAIに任せる文化が定着しました。新しくプロジェクトに参画したメンバーも、「まずAIに全体像を解説させる」という動きをとることで、コードを読み込む時間を大幅に短縮できています。
③ トークン効率と精度の最適化
「1体のAIにすべてを説明させる」のではなく、「役割ごとにエージェントを分ける」という手法を学んだことで、消費トークンを抑えつつ、AIからの回答精度を高める高度な運用が可能になりました。
まとめ：AIネイティブ開発への入り口を作る
今回の「Claude Code 基礎編ハンズオン」は、単なるツールの使い方のレクチャーではありません。「日本語で指示して動くものを作る」「未知のコードにAIと飛び込む」「複数のAIを使いこなす」という3つの成功体験を通じた、開発文化のアップデートです。
AIエージェントの導入に足踏みしている組織はまだまだ多いと思われますが、ぜひ以下のハンズオン資料も参考にしてみてください！
https://drive.google.com/drive/folders/1AqdD-xnFy9H2bRcXFmzANa9zSSMpb71Y?usp=sharing
