Claude CodeでパーソナルAIエージェントを構築：Wizの6か月間の教訓

開発者が、開発環境とランタイムの両方としてClaude Codeを使用して個人用AIエージェント「Wiz」を構築した6ヶ月間の旅を共有しました。このプロジェクトは野心的な「アイアンマンのジャービス」というビジョンから始まりましたが、実用的な日常使用システムへと進化しました。

Wizが実際に行うこと

Wizは、日常的なタスクを自律的に実行するClaude Code上に構築された個人用AIエージェントです。このシステムは、朝のレポート、夜のサマリー、受信箱の仕分け、および様々な実験を処理します。創造的または品質に敏感な作業については、開発者が引き続き関与しています。

技術的実装

アーキテクチャは意図的にシンプルに設計されています：

• Claude Codeがハーネス/フレームワークとして機能
• CLAUDE.mdが指示ファイルを含む
• メモリはマークダウンファイルに保存
• ツールはフォルダ内のスクリプトとして実装

Claude Codeを使用した開発プロセス

開発者はプロジェクト全体を通じてClaude Codeを広範囲に使用しました：

• /initコマンドが最初のCLAUDE.mdファイルを一発で生成
• デバッグが必要な場合、エラーをClaude Codeに貼り付けて診断
• Claude Codeがほとんどのコードを書き、開発者が各ファイルをレビューして問題を修正

主な間違いと教訓

開発者は問題を引き起こした9つの具体的な間違いを特定しました：

• 注意深いレビューなしでClaudeに最初のCLAUDE.mdを生成させたこと - たった一つの悪い文から数時間のデバッグを招いた
• ガードレールなしで自己改善にコア指示の書き換えを許可したこと - システムが複数の方向に漂流する原因となった
• 昼食前に使用制限に達するまで、すべての小さなクエリにOpusを実行していたこと - モデルルーティングを実装することで修正（単純なタスクにはsmall/local、一般的な作業にはSonnet、複雑な呼び出しにはOpus）
• 段階的にではなく、初日から「ジャービス」を構築しようとしたこと - 約3ヶ月の開発時間を費やした
• ほとんどのパイプラインのすべてのステップにLLM呼び出しを配置したこと（多くはプレーンなスクリプトであるべきだった）

実用的な出発点

開発者は、野心的なシステムではなく、小さく機能するエージェントから始めることを推奨しています。最初のプロジェクトとして、夜間のメールを読み取り、1段落の朝のサマリーを書くものを構築することを提案しています。

完全な投稿には、最初のエージェントを構築する段階的なウォークスルーと、9つの間違いすべての詳細が含まれています。開発者は、Wizは公開リリースされるものではなく、個人プロジェクトのままであると述べています。