個人開発者のためのClaude Code完全ガイド
Claude Codeをこれから使い始める人向けに、導入から最初のセッション、許可の仕組み、CLAUDE.mdの書き方までを順に解説します。実際に踏んだ課金の落とし穴とWindows固有のつまずきも、エラーの実文つきで載せています。
ARTICLES
記事一覧
AIエージェント運用の実践記事を公開日順に掲載しています。
全体ガイド
実践記事
全6本
529 Overloadedと429：AIのAPIが落ちる前提で組む
サーバー混雑の529と、自分の枠を使い切った429は、同じリトライで扱ってはいけません。日次バッチが2日分止まった実データと、そのあと書いたリトライ実装のコードを載せます。
Claude Code vs Codex：役割分担の実践論
設計をClaude Code、実装をCodexに分ける運用に落ち着くまでに、Windowsで書き込めない問題、WSL越しにgitが壊れる問題、未コミットの変更を消した事故を踏みました。実測ログとともに、なぜこの分担なのかを書きます。
効果レベル（effort）を実測する：xhighは4.4倍考えて、短い答えを返した
Claude Codeのeffortレベルを実際に測りました。同じ質問をlowとxhighで投げたところ、xhighは4.4倍のトークンを消費しながら、lowより短い回答を返しました。測定データと、そこから導いた使い分けの基準を書きます。
MCPサーバーは何トークン食うのか：6台つないで実測した
MCPサーバーを6台つないだ状態と切った状態でコンテキスト消費を測ったところ、差は476トークンでした。ただしツールを使うタスクでは、処理するトークンの累計が桁違いになります。「つなぐコスト」と「使うコスト」は別物です。
Claude Codeで定期実行する3つの方法と、GitHub Actionsを選んだ理由
Routines・Desktop scheduled tasks・/loop は別物です。3つの違いを公式仕様で整理したうえで、私が実際に動かしている日次バッチにGitHub Actionsを選んだ理由と、そこで測った遅延・停止の実データを書きます。
