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は公開リリースされるものではなく、個人プロジェクトのままであると述べています。
📖 Read the full source: r/ClaudeAI
👀 See Also

Slack用OpenClawのセルフホスティング:3つの失敗モードとマネージドな代替案
ある開発者が、Slack用OpenClawのセルフホスティングに3度失敗した経験を記録しました。WebSocketの切断、API障害時の処理問題、トークンローテーションのサイレント失敗に直面した後、マネージドサービスであるSlackClaw.aiに切り替えました。

非開発者がClaudeとeBay APIを使って転売スコアリングツールを構築
ソフトウェアエンジニアリングのバックグラウンドを持たない探偵が、eBayの販売済みデータを分析し、転売アイテムの信頼度スコアを生成するローカルのFlask/SQLiteツール「FlipIQ」を構築しました。このツールには写真識別機能が含まれており、eBay APIキーとOllamaを使用して無料で実行できます。

OpenClawは、AIエージェントを介した自動食料品買い物のためにKroger APIと統合します。
開発者がOpenClawとKroger APIを使用して、レシピの材料を自動的にショッピングカートに追加しました。Qwen3.5をレシピ生成に、Gemini 3.1 Proをセットアップに活用しています。この統合には6時間の作業が必要で、単一のカート生成で359Kトークンを消費しました。

Claude Codeで20K行以上の本番SaaSプラットフォームを構築:大規模エージェント工学からの教訓
開発者がLastSaaSをオープンソース化しました。これはClaude Codeとの対話を通じて完全に構築されたプロダクションレディのSaaSボイラープレートで、Goバックエンド、Reactフロントエンド、マルチテナント認証、Stripe請求、組み込みMCPサーバーを備えています。このプロジェクトは、大規模開発にAIエージェントを使用する際に何が機能し、どのような規律が必要かを明らかにしています。