Claude Code
ターミナルで動く AI コーディング支援ツール Claude Code の実践記事です。導入手順、CLAUDE.md の設計、サブエージェント、フック、CI 連携、詰まりやすいエラーの解決まで扱います。自動化やヘッドレス運用の記事も揃えています。
Claude Code の Glob と Grep が0件を返すときの原因切り分け
Claude Code の Glob/Grep ツールがファイルを見つけられないとき、.gitignore除外・隠しファイル・パターン記法の落とし穴を切り分け、適切な代替手段で確実に発見する手順をまとめます。
Claude Code の Read が大きなファイルを最後まで読まないとき — PARTIAL view の受け取り方と offset / limit の設計
Read が大きなファイルを途中までしか返さないとき、Claude Code は PARTIAL view の通知を出しています。通知の受け取り方と、行数ではなくバイト予算で offset / limit を決める方法を、実測値とともにお伝えします。
Claude Code Skill を無人で動かす設計 — 許可ダイアログで止まらない3つの実装パターン
Claude Code のスキルをスケジュール実行や CI で動かしたとき、許可ダイアログが出て途中で固まる現象に何度もぶつかってきました。Read/Write 系ツールに依存せず bash で完結させる、3つの実装パターンを実体験から共有します。
Claude Code と husky/lint-staged で『変更ファイルだけ』AIレビューさせる Pre-commit ガイド
git commit の直前に、ステージング済みファイルだけを Claude Code に渡して軽量レビューを走らせる方法。lint-staged で対象を絞ることで、コストと待ち時間を最小化する個人開発者向けのレシピです。
複数のリポジトリをClaude Codeで並行開発するコツ — 3プロジェクトを同時に動かして学んだこと
複数のリポジトリをClaude Codeで同時に進めると、コンテキストの混乱やコスト増加が起きやすい。CLAUDE.mdの設計、セッション管理、--add-dirの活用など、3プロジェクト並行で機能した設定と習慣をまとめました。
gh skillで実現するマルチエージェント開発体制 — SKILL.mdのバージョン管理・CI/CD連携・エージェント別最適化の設計
gh skillを使ったSKILL.mdのチーム横断配布を本番運用する方法。バージョン管理戦略、GitHub Actions連携、エージェント別スキル最適化、モノレポ対応まで、実際の設計パターンを詳しく解説します。
react-native-permissions か Expo か — Claude Code で迷わず実装する React Native 権限管理ガイド
react-native-permissionsとExpoパーミッションAPIの使い分け基準を解説。Claude Codeを活用してiOS・Android両対応の権限管理を最短で実装するパターンと、よくある実装ミスへの対処法を紹介します。
Claude Code で個人 SaaS を 90 日運用した記録 — 設計判断と、後から一次情報で訂正した箇所
Claude Code を中心に個人 SaaS を90日間つくった作業ノートです。設計対話の使い方、モデルの使い分け、Cloudflare Workers の制約への対処を記録し、公開後に一次情報で洗い直して誤っていた3点を訂正しました。
SKILL.mdをClaude Code以外でも使えるようにする「gh skill」の仕組みと使い方
GitHubのgh skillコマンドを使うと、Claude Code向けに書いたSKILL.mdをGitHub Copilot・Cursor・Gemini CLIなど30以上のAIエージェントで共有できます。仕組みと実践的な使い方を解説します。
Claude Code × MCP で構築する個人開発 AI 自動化ハブ — 複数サービス横断の設計と実装
Claude Code と MCP を組み合わせ、GitHub・Notion・Slack を横断する個人開発向けの AI 自動化ハブを設計・実装します。サービス間の文脈維持・エラーハンドリング付きコード例・トークンコスト削減の実測までまとめました。
Claude Code で振る舞い駆動開発（BDD）を本番実装する — Gherkin シナリオ自動生成からチーム横断テスト文化の醸成まで
Claude Code を使った振る舞い駆動開発（BDD）の本番実装ガイド。Gherkin シナリオ自動生成、ステップ定義の自動化、Playwright/Cucumber 連携、非エンジニアとの協業体制まで、動作確認済みコードで解説します。
Claude Code SDK で本番品質の自律エージェントを作る7つの設計原則 — スタミナ・エラー回復・コスト管理の実装
自律エージェントを「動かす」ことと「本番品質で動かし続ける」ことの間には大きな溝があります。ループ深度の上限、2層のタイムアウト、重複ツール呼び出しの検知、エージェントレベルのコスト予算、エラーの回復可否分類、構造化ログ、グレースフルデグレードの7原則を実装パターンで解説します。
Claude Code に拡張思考を組み込む 2026
Claude 4 の拡張思考（Extended Thinking）を Claude Code と API で活用する実践ガイド。思考バジェットの設定、ストリーミング処理、本番環境での適切な使いどころを解説します。
設計書の質がClaude Codeの速度を決める：AIに「考えさせない」仕様書設計
16人日の開発が2時間で終わった事例の本質は「AIがすごい」ではなく「設計書がAIに考えさせなかった」ことにあります。考えさせない設計書の3つの条件、スコープ外の明示、DESIGN.md・TASK.md・DECISION.mdの3ファイル体制まで、Claude Codeの速度を引き出す仕様書設計を解説します。
Claude Code MCP 接続トラブル完全診断ガイド
Claude Code の MCP サーバーが繋がらない・途中で切れる・ツールが見つからない問題を根本から診断する。設定ファイルの構造から通信ログの読み方、よくある落とし穴まで、実際のエラーパターンをもとに体系的に解説します。
Claude Code で「継続収益型」受託開発ビジネスを作る — 月商100万円を目指す実践ロードマップ
単発案件を積み上げても手元に残らない収益構造から抜け出し、継続月額契約へ移行するための設計方法です。継続収益モデルの3つのパターン、移行提案の実際のスクリプト、クライアント管理の自動化、よくある失敗と対処、6ヶ月でMRR100万円を目指すロードマップまで扱います。
Claude Code フックで作るゼロタッチ・コードレビュー環境
Claude Code のフック機能を使い、コミットのたびに自動でコードレビューが走る仕組みを構築します。PreToolUse・PostToolUse・Stop の組み合わせ方と、実運用で見えてきた落とし穴も含めて紹介します。
Claude Codeデスクトップ版が大きく変わった：並列エージェント時代に合わせた新UI
2026年4月14日に大幅リニューアルされたClaude Codeデスクトップ版を解説します。並列エージェント対応の新サイドバーやRoutinesなどの新機能、セッションを2〜3個並べるときの実践的な配り方、利用できるプラン、並列時代の開発者の役割の変化までを実際に触りながら確かめました。
Claude Code × Ollama でコストを抑える — ローカルLLM 使い分け
Claude Code のAPI コストが気になる方へ。Ollama（ローカルLLM）と litellm プロキシを組み合わせてコストを抑える設定手順と、どのタスクをどちらに振るかの判断軸を実践的に解説します。
Claude Code でMCPサーバーが突然動かなくなったとき：5ステップ診断ガイド
昨日まで動いていたMCPサーバーが突然「接続できない」と表示される——そんなときの5ステップ診断ガイドです。/mcpコマンドでの状態確認、stderrログの読み方、設定ファイルの構文チェック、認証トークンと環境変数の確認、再起動まで、すぐ使える対処コマンドとともに解説します。
Claude Code でよく出るエラー5選と即解決策
Claude Code 開発中によく遭遇するエラー5種類を原因と解決策のセットで解説。Permission denied・レート制限・MCP接続・コンテキスト超過など、詰まりがちなポイントを実体験をもとに整理しました。
コードが変わるたびにドキュメントも自動更新される仕組みを Claude Code で作る
README・CHANGELOG・API仕様書をコードの変更に連動して自動生成するCI/CDパイプラインを構築します。Claude Haiku 4.5とSonnet 4.6を役割別に使い分け、コスト70%削減と品質の両立を実現する実践ガイドです。
Claude Code vs OpenCode × Gemma 4 — クラウドAIとローカルOSSの戦略的使い分け
OpenCode と Google Gemma 4 を組み合わせた『無料Claude Code』が話題ですが、Claude Code を本気で使い込んでいる立場から両者の使い分けを整理します。コスト・品質・運用負荷・セキュリティの4軸で実務的に判断するためのガイドです。
Claude Code のコンテキスト上限に実用的に対処する5つのアプローチ
Claude Codeが「コンテキスト上限に近づいています」と警告を出し始めたときの実践的な対処を5つのアプローチで解説します。/clearでのリセットと/compactでの要約圧縮の使い分け、常に参照すべき情報をCLAUDE.mdへ外出しする方法、作業をスコープで分割する設計を扱います。
Claude Code でテストカバレッジを段階的に改善する
カバレッジが低いプロジェクトでClaude Codeを活用し、テストを段階的に増やすワークフローを解説します。カバレッジレポートの解析、未テスト関数の一括検出とテスト生成の依頼方法、TypeScriptとVitestでの実践手順、よく詰まるポイントと対処法までを具体例で示します。
Claude Code の GitHub PR トリガーを設定して自動コードレビューを構築した記録
Claude CodeのGitHub PRトリガー機能を使い、プルリクエスト作成時にClaude Codeが自動でコードレビューを実行する仕組みを構築した手順と、実際に運用して分かったポイントをまとめます。
Claude Code を『便利な道具』から『開発の中心』へ — 運用設計5つの軸
Claude Code は単なる補助ツールではなく、開発プロセスそのものを駆動する基盤になり得ます。CLAUDE.md・MCP・skills・hooks・サブエージェントの5つを運用設計の柱として整理します。
Claude Code で MCP サーバーを実践活用する — 設計から運用まで
Claude CodeのMCPサーバー連携を実際のプロジェクトで使い始めるための実践ガイドです。役立つサーバーの選び方、.claude/settings.jsonの実践的な書き方、接続時によくあるエラーと対処法、実際のプロジェクトで使っている構成例まで、設計から運用の勘所を解説します。
Claude Code 受託開発で単価を倍にする実践戦略 — 個人開発者が法人案件を獲るまで
Claude Code を業務に組み込んで受託開発の単価を実際に倍にした個人開発者の視点から、見積もり、ヒアリング、納品スピード、契約条件、信頼の作り方までをまとめた、独立志向の方向けの実践ガイドです。
Claude Code × Fastlane で iOS/Android 自動デプロイパイプラインを0から構築する
Claude Code と Fastlane を組み合わせてiOS・Androidアプリのリリース作業を完全自動化する方法を解説。Appfile・Fastfile の設計から証明書管理、App Store Connect API 連携まで動作するコード付きで紹介します。
Claude Code 時代の受託開発で単価を倍にする — 提案・見積・納品の実践戦略
開発が速くなったから安くする、は間違いです。Claude Codeを使い込むフリーランスが単価を維持・向上させるための、工数ベースから価値ベースへの見積もり転換、提案書の作り方、AI利用をクライアントに伝えるかの判断、単価交渉で使える具体的なフレーズまで実例で解説します。
Claude × Stripe Meter Events で従量課金 SaaS を構築する実装ガイド
Claude API のトークン消費量を Stripe Meter Events で従量課金として回収する、本番運用可能なアーキテクチャと実装コードを公開します。冪等性・上限制御・ダッシュボード可視化までカバーします。
Claude Code のネットワーク・接続エラーを5分で診断して解決する方法
Claude Codeで接続エラーやタイムアウトが出たとき、闇雲に再インストールする前に原因を特定しましょう。よく見るエラーメッセージと原因の早見表、5分で終わる診断フロー、エラー別の解決策、企業ネットワークやVPN環境の注意点、エラー後のセッション回復までを体系的に解説します。
git pushが詰まるVM環境でGitHub REST APIを使ってcommit/pushする方法
index.lockや所有権エラーでgit CLIが動かないVM・サンドボックス環境で、GitHub REST API（blobs→trees→commits→refs）を使ってファイルをpushする実践ガイドです。
Claude Code × データサイエンス — pandas・scikit-learn・機械学習プロジェクトをAIペアプログラミングで加速する
Claude Code をデータサイエンス・機械学習プロジェクトで活用する実践パターンを解説。EDA・特徴量設計・モデル評価・ハイパーパラメータチューニングまで、動作するコード例とともに本番レベルのMLワークフローを構築する方法を紹介します。
Claude Code 個人開発で迷う7つの分岐 — 1年運用で確立した判断基準
Claude Code を個人開発で使い始めた頃、毎日のように悩んでいた7つの分岐点について、1年運用して見えてきた判断基準をまとめました。技術的な解説だけでなく、なぜその判断に落ち着いたのかという背景まで踏み込んでいます。
Claude Code でゼロダウンタイム DB マイグレーションを設計する本番運用ガイド
Claude Code でゼロダウンタイム DB マイグレーションを設計する本番運用ガイド。Expand-Contract、NOT NULL 追加、カラムリネーム、バックフィル、サブエージェントレビューまで、本番で詰まらない手順をお伝えします。
Claude Code が途中で止まる・フリーズする問題の完全診断ガイド
作業を任せていたClaude Codeがぴたりと止まったとき、中断すべきか待つべきかは症状で判断できます。最多ケースのコンテキストバジェット枯渇、ツールやサブエージェントの無応答、無限ループとタスク放棄という原因カテゴリ別に、見分け方と即効性のある対処法を整理しました。
Claude Code の Edit ツールで「old_string is not unique」エラーを止める実践的な書き換え戦略
Claude Code の Edit ツールで「old_string is not unique」が頻発するのは、編集ターゲットの一意性をプロンプト側で保証していないことが根本原因です。再発を防ぐ書き換え戦略を解説します。
Claude Code のステータスラインを自分好みに作り変える — モデル名・残コンテキスト・Git 状態を1行で見せる設定例
現在のモデル・残コンテキスト・Gitブランチを1行で確認できるClaude Codeのステータスライン設定例を紹介します。シェルスクリプトとNode.jsの両方の実装、エラーを握りつぶして会話を壊さない工夫、アスキーで描く残コンテキストバー、プロジェクトごとの表示切り替えまで扱います。