Cowork の Bash で pip install が externally-managed-environment エラーで止まるとき — PEP 668 環境を乗りこなす実装メモ
Cowork の Bash サンドボックスで pip install が externally-managed-environment エラーで止まる原因と、--break-system-packages・venv・pipx の3つの対処パターンを実体験から整理します。
Claude の『このモデルは現在利用できません』が出る時に効くモデル選択フォールバックの設計
Claude API で時折出る『このモデルは現在利用できません（this model is currently unavailable）』は、529 Overloaded ともレート制限とも違う性質のエラーです。個人開発で運営している6サイトの自動投稿パイプラインで実際に観測した発生条件と、リクエスト単位で動的に切り替えるフォールバック実装をまとめました。
Claude Code Hook が `command timed out` で失敗するときの timeout 設定と分割実行のコツ
Claude Code の Hook が `command timed out` で発火しても完了しない問題を、timeout 設定の見直し・分割実行・バックグラウンド化の3アプローチで実用的に解決する手順をまとめます。
Claude Code の WebFetch が 403 や空ページを返す時の原因と対処
Claude Code の WebFetch が 403 を返したり、本文が抜けた空のページを返す現象には、いくつか定番の原因があります。Cloudflare のボット検知、クライアントレンダリング、ドメイン許可リスト、キャッシュの4点を切り分けながら、それぞれの実用的な対処法を整理します。
Claude API の Tool Use でスキーマ定義ミスが出たとき：実際に遭遇した3つのパターンと診断手順
Claude API の Tool Use でよく起きるスキーマ定義ミス・invalid_tool_use・Claude がツールを呼ばない問題を、実際のアプリ開発で遭遇したケースをもとに診断手順と修正パターンで解説します。
Cowork スケジュールタスクで git clone が失敗するとき — /tmp 権限とディスク不足を素早く診断する
Cowork の自動タスクで git clone が Permission denied や No space left on device で失敗する原因と、/tmp の所有者確認・$HOME フォールバック・掃除コードの安全化を、VM 上で実測しながら整理します。
Claude Code の Bash ツールで `npm run dev` や `docker run` が止まる — 長時間実行プロセスの正しい扱い方
Claude Code で npm run dev や docker run を実行すると Bash ツールがハングする問題の原因と解決策。バックグラウンド実行・タイムアウト設定・プロセス管理の実践的な手順を解説します。
APIキーを誤って git commit してしまった時の緊急対応手順 — Claude Code を使った履歴削除とキーローテーション
.envのAPIキーを誤ってgit commitしてしまったときの緊急対応手順です。最初の5分で行うキーのローテーション、被害範囲の確認、git履歴からの完全削除、GitHubのシークレットスキャンニングアラートの解除、.gitignore整備を含む再発防止までClaude Codeを使って実践的に解説します。
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への対処法 — 「指摘しても治らない」の正体と根本解決策
何度指摘してもClaudeが同じ間違いを繰り返すのは、会話の流れの中で修正指示が薄れていくためです。一時的な修正と永続的な修正の違いを整理し、即効性のある対処法3つと、Claude Projectsやプロフィール設定を使って根本的に直す方法を具体例とともに紹介します。
Claude Code MCP 接続トラブル完全診断ガイド
Claude Code の MCP サーバーが繋がらない・途中で切れる・ツールが見つからない問題を根本から診断する。設定ファイルの構造から通信ログの読み方、よくある落とし穴まで、実際のエラーパターンをもとに体系的に解説します。