Claude Code hooksが動かない・発火しない原因を、公式トラブルシュートとGitHub Issueの実例から全部洗い出した
Claude Codeのhooksを設定したのに動かない・発火しない原因を、公式ドキュメントの診断手順とGitHub Issueの実例をもとに整理。matcher・JSON構文・実行権限から、silentに死ぬ既知の不具合パターンまで症状別にまとめた。
#開発ツール
48 articles
Claude Code JetBrainsプラグインが「IDEを検出できない」原因を、公式ドキュメントとGitHub Issue実例で全部洗い出した
JetBrains（Rider・RustRover・PyCharm等）でClaude Codeの「No available IDEs detected」「Cannot launch Claude Code」が出る原因を公式トラブルシューティングとGitHub Issue実例から整理。WSL2ファイアウォール設定、CLAUDE_CONFIG_DIRの罠、IntelliJ 2026 devcontainerの非対応まで症状別にまとめた。
Claude Codeで「Prompt is too long」が出て詰んだ時の対処法——「usage limit reached」と誤表示される罠も含めて整理した
Claude Codeの「Prompt is too long」エラーの原因と復旧手順を解説。200kトークン制限との違い、「usage limit reached」への誤表示問題、MCPツール肥大化などの原因別チェックリスト、GitHub Issue実例つきでまとめた。
Claude Codeのサブエージェントが応答しない・固まる問題を、GitHub Issueの実例で切り分けた
Claude Codeのサブエージェント(Task tool)が応答しない・Runningのまま固まる症状を、GitHub Issueの実例から3パターンに分類。公式にタイムアウト機能がない実情と、/tasks・環境変数を使った現実的な対処法を整理した。
Claude Code statusline完全ガイド——コンテキスト・コスト・レート制限を1行監視する設定術
Claude Codeのステータスライン(statusline)をゼロから設定する方法を解説。コンテキスト圧迫・レート制限切れ・コスト超過に気づかず作業が止まる困りごとを、実際に動くbash/jqスクリプト付きで解消する。
Claude Codeのアカウント切り替え——CLAUDE_CONFIG_DIRだけでは個人用とクライアント用が完全に分離しない話
Claude Codeで個人用アカウントとクライアント案件用アカウントを切り替える方法を整理した。公式の/login切り替えとCLAUDE_CONFIG_DIRの違い、CLAUDE_CONFIG_DIRが「未公式かつ不完全」な理由をGitHub Issueベースで検証し、フリーランスが本当に分離すべき理由まで解説する。
docker system pruneしてもディスク容量が減らない時の原因と対処法【Mac/OrbStack 2026年版】
docker system pruneを実行してもMacのディスク容量が戻らない原因を解説。仮想ディスクが縮まない仕組み、OrbStack/Docker Desktopそれぞれの対処手順、Claude Codeでworktreeを並行運用してるとゴミが溜まりやすい理由まで実体験ベースでまとめた。
Claude Code MCPが「接続できない」原因を、公式ドキュメントの症状別対処表で全部洗い出した
Claude CodeでMCPサーバーが「Failed to connect」になる原因を公式ドキュメントとGitHub Issueの実例から整理。/mcp・/doctorでの一次診断から、ENOENT・パス問題・env未伝播・承認待ちまで症状別に対処法をまとめた。
Claude Codeが「process exited with code」で落ちる原因を全部洗い出した
Claude Codeの「process exited with code 1/3/127/137」エラーを原因別に整理。認証競合・Windows特有のクラッシュ・OOM・新設定sandbox.network.strictAllowlistまで、切り分け手順つきで解説する。
Codex vs Claude Code、料金と設計思想の違いを正直に比較する【2026年版】
Codex（OpenAI）とClaude Codeの違いを料金体系・コンテキスト窓・サブエージェント設計・オープンソース戦略で比較。無料プランから使えるCodex、1Mコンテキストを標準価格で提供するClaude Code。ベンチマークの数字だけで選ばない、実務目線の使い分け基準を整理する。
MCPが「ステートレス」になった。2026-07-28仕様で自作サーバーは何を直すべきか
MCP 2026-07-28仕様でinitialize/initializedハンドシェイクとセッションIDが廃止され、プロトコルが要求/応答型のステートレス設計に変わった。Claude Codeの利用者（クライアント側）とMCPサーバーを自作・自己ホストしてる人で、対応の要否がどう分かれるかを一次情報から整理する。
Claude Codeが黙ってレビューしなくなった。/code-reviewは自分で呼ぶものになった
2026年7月、Claude Codeの/code-reviewとverifyは「Claudeが自分の判断で動く」性質を失った。さらに/code-reviewはバックグラウンドのサブエージェントとして動くようになり、3月に書いた使い方ガイドはもう半分古い。v2.1.215とv2.1.218の変更点を公式ドキュメントで検証し、今の正しい使い方をまとめる。
Claude Code Desktopにブラウザ搭載、コピペ地獄が終わった
Claude Code Desktopに2026年7月、外部サイトを開いて読む・クリックする・入力できるブラウザが内蔵された。ドキュメントやFigmaを見ながらコピペ貼り付けが消える一方、クリーンなブラウザプロファイルとサンドボックス設計、書き込みを審査する安全性分類器も入っている。公式情報から実務目線で整理する。
Claude Codeのサブエージェント、禁止→解禁を1週間で繰り返した理由
Claude Codeはサブエージェントの同時実行を20体に制限した4日後、ネストの入れ子生成を既定で禁止し、さらに3日後には深さ3まで既定で解禁した。7月17日〜24日の3リリースを時系列で追い、暴走コストの正体とCLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS等の実務での調整方法を解説する。
Claude Codeの/forkが別物に。旧挙動は/subtaskへ移動した
v2.1.212でClaude Codeの/forkが別物になった。以前は在席のままサブエージェントを立ち上げる機能だったが、今はclaude agentsに独立した行として現れるバックグラウンドセッションを生成する仕様に変わった。旧動作は/subtaskとして分離、両者の使い分けを一次情報から整理する。
Claude CodeのMCP呼び出しが固まらなくなった——2026年7月アップデートで変わった3つのこと
Claude Codeで長時間かかるMCPツール呼び出しが入力欄ごと固まる問題、2026年7月アップデート（v2.1.212〜v2.1.214）で自動バックグラウンド化された。仕組みを一次情報から検証し、EndConversationツール・権限チェック強化の実務影響まで解説する。
Windsurf IDE vs Claude Code 2026 ── フリーランスエンジニアが乗り換えを判断した基準
Windsurf IDEとClaude Codeの違いをフリーランス視点で徹底比較。Cascadeエージェントとの違い、コスト、移行コスト実試算、CLAUDE.md→.windsurfrules変換まで解説。どっちを選ぶべきかの判断フレームワーク付き。
Amazon Kiro IDE 完全ガイド 2026 — Claude Codeユーザーが乗り換えるべき？フリーランスエンジニア視点
Amazon Kiro IDEをフリーランスエンジニア目線で徹底検証。Claude Codeとの料金・機能比較、steering filesとCLAUDE.mdの違い、移行コスト、AWS案件あり/なし別の乗り換え判断フロー。実際に触れてわかった正直な結論。
Cursor Background Agentの使い方完全ガイド — 料金・セットアップ・CI活用・Devinとの比較【2026年版】
Cursor Background Agentを使いこなすための完全ガイド。セットアップ手順・Slack連携・料金実測・プライバシーモードの制約・Devin/Claude Codeとの使い分けまで、実際に動かした視点で解説。
Claude Codeが突然バグる本当の理由を、実測データで特定した
Claude Codeがフリーズ・幻聴・生ログ吐き出しを起こす原因を実測データで解剖。空きメモリ103MB・スワップ2700万回の計測結果、コンテキスト自己中毒（self-poisoning）の仕組み、前兆3段階サイン、セッション引き継ぎ手順まで。
REVIEW.md の書き方ガイド——Claude Code Review をチーム仕様に合わせる設定ファイルの使い方
Claude Code ReviewのREVIEW.mdとは何か、CLAUDE.mdとの違い、実際の書き方・テンプレートを公式ドキュメントベースで解説。severity制御・スキップルール・チーム固有チェックの設計方法まで。
OrbStackの料金、"無料で使える"の落とし穴 — ライセンス必須ライン（$10k・商用）とWindows非対応の現実【2026】
OrbStack Free/Pro/Enterpriseの料金と、フリーランス・商用利用でライセンスが必要になる条件を正確に解説。年$10,000超で無料はアウト。Windows非対応の事実と代替ツール（WSL2+Docker/Podman Desktop）も整理。
OrbStack vs Docker Desktop 徹底比較 — Macのメモリを半分取り戻す方法【2026年版】
OrbStack と Docker Desktop を料金・メモリ・機能・ユースケースの4軸で比較。個人開発者が乗り換えるべきタイミング、ライセンスが必須になる条件（年$10k超・商用・フリーランス）、Docker Desktop を残すべき理由まで正直に書く。2026年6月更新。
OrbStack 設定最適化ガイド 2026 — 移行後にやるべきチューニング全12項目
OrbStack導入直後のデフォルト設定は最適ではない。メモリ上限・VirtioFS・ビルドキャッシュ・ローカルドメイン・Rosetta設定まで、移行後にやるべき12項目を実測データ付きで解説。
Claude Code をスマホ・iPad から操作する完全ガイド 2026 — Remote Control の設定から実用パターンまで
Claude Code Remote Control でスマホ・iPad・ブラウザからローカルセッションを継続する方法を解説。設定・接続手順・プッシュ通知・実用パターン3選・制限事項まで。2026年6月公式ドキュメントベース。
Claude Code の settings.json 完全ガイド 2026——スコープ・チーム設定・パーミッション管理を整理する
settings.json の4スコープ（管理/ローカル/プロジェクト/ユーザー）と settings.local.json の分離方法、チーム開発での permissions 設計、CLAUDE.md との違いを公式ドキュメントベースで整理。2026年6月版。
AI Agent 時代のシークレット管理設計 — Vault・SSO・MCP の3層アーキテクチャ
AIエージェントが増えると秘密鍵の管理が破綻する。開発者個人・Agent・CI環境の3層に分けて設計する方法と、1Password/Vault/Doppler/AWS Secrets Managerのツール選定マトリクス、MCP×Vaultパターン、SSO+Token Lifecycle設計、監査ログ、鍵流出パターン3つを網羅した設計論。
Claude Code エラー復旧パターン集——タスク失敗から立ち直る7つのテクニック
Claude Codeで本当に詰まったときの復旧手順を実体験ベースでまとめた。セッションクラッシュ・無限ループ・permission暴走・context overflow・ファイル破壊・bg agent暴走・コスト異常検知まで、7つのシナリオ別に具体的な復旧コマンドと設計を解説。
1Password CLI × Claude Code で .env を Vault化する完全ガイド — op run・シェル統合・MCP の3パターン
.envファイルの平文管理から脱却するための実践ガイド。1Password CLIを使ったop runによる実行時注入・fish/zshシェル統合・MCPサーバー経由の3パターンを解説。Claude Code SubAgentsとの組み合わせ、Doppler/Infisicalとの比較まで網羅。
Docker DesktopからOrbStackに3ヶ月乗り換えた結果レポート — メモリ・CI連携・ハマりどころの実測記録
Docker Desktop から OrbStack に乗り換えて3ヶ月が経過。メモリ使用量の実測値・Docker Composeの互換性・GitHub Actions連携・日常業務でのパフォーマンス変化を正直にレポート。移行を迷っている人向けの実体験記録。
1Password MCPをClaude Codeに導入する完全ガイド — シークレット管理をVaultに一元化する
1Password MCPサーバーをClaude Codeに接続する手順を完全解説。インストール・Vault設定・環境変数の自動注入・claude_desktop_config.jsonの設定方法から、実運用でのシークレット管理パターンまでカバー。
Claude Code の --resume でセッションを復元する——クラッシュ後のリカバリと複数セッション管理の実践
Claude Code の --resume フラグと会話履歴管理を徹底解説。クラッシュ後のセッション再開、セッションIDの特定方法、CLAUDE.md を使った状態の永続化、複数セッション並列管理まで実装例付きで解説。
Claude Codeでテストを自動生成する — Jest/Vitest/pytestの実践パターン集【2026年版】
Claude Codeを使ってテストコードを自動生成する方法を解説。Jest・Vitest・pytestのコマンド例、TDDワークフロー、カバレッジ改善のコツ、よくある失敗パターンまで。日常の開発でそのまま使える実践レシピ集。
Claude Codeのコンテキスト管理術 — /compact・/clear・CLAUDE.mdで1Mトークンを使い倒す
Claude Codeのコンテキスト管理を徹底解説。/compact・/clear・/rewindの使い分け、CLAUDE.mdでの永続化、サブエージェント分割による長時間作業の維持方法。コンテキスト汚染で品質が落ちる前にやるべき対策まとめ。
Claude Codeのeffort設定を全段階検証 — low/medium/high/maxとultrathinkの使い分け
Claude Codeのeffort設定（low/medium/high/max）を実際に検証。コード品質・処理時間・トークンコストの変化、ultrathinkとの関係、Opus/Sonnetでの挙動の差、実務での最適な使い分けを詳しく解説。
Claude Code MCP設定ガイド — サーバーの追加から実用5選まで【2026年版】
Claude Code MCPの設定方法をゼロから解説。MCPサーバーの追加・削除・スコープ管理、Filesystem・GitHub・Brave Search・Puppeteer・自作サーバーの実用5選、よくあるエラーと対処法まで網羅。
Claude Code の料金プラン選び方ガイド — Pro・Max・APIを月額実額で比較【2026年版】
Claude Code Pro（月約3,000円）・Max 5x（約15,000円）・Max 20x（約30,000円）・API直接利用を実際の使用量から逆算して比較。リミットに引っかかる頻度とストレスから判断するプラン選びの基準を、フリーランス目線で解説。
Claude Code Hooksで開発を自動化する — 実際に使える5パターンを解説【2026年版】
Claude Code Hooksの設定方法と実践的な使い方を解説。PreToolUse・PostToolUse・SessionStart・Notificationなど主要イベントを使った自動化レシピ5選。副業・フリーランスエンジニア向けに実用性重視でまとめた。
Cursor vs Claude Code どっちがいい？料金・機能・使い分けを正直に比較【2026年版】
Cursor vs Claude Code を料金・エージェント性能・コンテキスト窓・拡張性で比較。無料で使える？月額の実コストは？どっちを選ぶべきか判断フロー付き。両方使った正直な感想。
CLAUDE.mdの書き方ガイド｜実運用で分かった設計パターンとアンチパターン
CLAUDE.mdを3ヶ月間毎日書き換えながら運用して見えた設計のコツ。読み込み階層の構造、箇条書きvsコードブロックの遵守率の違い、Progressive Disclosure、Auto Memoryとの役割分担、アンチパターンまで実運用ベースで解説。
Claude Code Review の使い方と REVIEW.md 設定ガイド — マルチエージェントでバグを見つける【2026年版】
Claude Code Reviewの使い方を実務で検証。REVIEW.mdの書き方テンプレ付き。マルチエージェント構成の仕組み、GitHub Actions連携、CodeRabbit等との比較、実用的な活用法をまとめた。
Claude Code 実践テクニック15選 — 知らないと損する使いこなし術【2026年版】
Claude Codeを日常の開発で使い倒すための実践テクニック15選。CLAUDE.md設計、bash連携、自動化パイプライン構築、デバッグ技法など、公式ドキュメントだけでは分からない実用的なTipsを具体的なコマンド例付きで解説します。
Claude Codeで「副業の全自動化」を作った — Skills・Hooks・MCP・定期実行の実践構成
Claude CodeのSkills・Hooks・MCP・LaunchAgentを組み合わせて、GA4分析から記事テーマ決定・サムネ生成・note下書き投稿・X宣伝・Search Consoleへのインデックス通知まで全自動化した実践構成をコード付きで解説。
Google Apps Script × AI API 自動化レシピ7選 — コピペで動くコード付き
Google Apps ScriptとGemini・OpenAI・Anthropic APIを組み合わせた実務自動化レシピ7つを解説。メール自動分類・議事録要約・日報自動生成など、コピペで即動くコードをすべて掲載。2026年版GASでasync/awaitが使えるようになった変更点も解説。
Google Workspace CLI（gws）使い方 2026 — GitHub公開直後に試した全コマンド
Hacker Newsで427ポイントを記録したGoogle公式CLI「gws」の日本語完全ガイド。npmでインストールしてGmail・Drive・Calendar・Sheetsをコマンド1行で操作する方法、OAuth認証設定、サービス別全コマンド例、AIエージェント連携・セキュリティ対策まで網羅。
Docker Desktopのメモリ食いすぎ問題にMacエンジニアが終止符を打った話
MacのDocker Desktopが16GB RAMの半分を食う問題をOrbStack乗り換えで解決した実測レポート。アイドル時メモリ81%減、I/O 3倍、起動時間6分の1。Colima比較・docker-compose互換性・Apple Silicon対応・乗り換え手順まで全部書いた。
OpenClawを使ってみて感じたこと + ZeroClawへの期待
AIエージェントランタイム「OpenClaw」を数週間使った体験談と、Rust製の後継「ZeroClaw」に期待すること。RAM消費・コスト・セットアップの実体験をまとめました。
ZeroClaw インストール手順ガイド｜macOSでの導入と初期設定
Rust製AIエージェントランタイム「ZeroClaw」をmacOSにインストールする手順をステップ別に解説。GitHub Releasesからのバイナリ取得、Apple Silicon/Intel対応、APIキー設定、OpenClawからの設定移行まで所要10分でセットアップ完了。