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 フォールバック・スマートクリーンアップの実装パターンを実体験から解説します。
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してしまった時の緊急対応手順。Claude Codeを使ったgit履歴からの完全削除、APIキーのローテーション、再発防止まで実践的に解説します。
Claude Code の Glob と Grep が0件を返すときの原因切り分け
Claude Code の Glob/Grep ツールがファイルを見つけられないとき、.gitignore除外・隠しファイル・パターン記法の落とし穴を切り分け、適切な代替手段で確実に発見する手順をまとめます。
Claude Code の Read ツールで大きなファイルが途中で切れる — offset と limit の使い分けと bash 併用の判断基準
Claude Code の Read ツールが2000行で切り捨てたまま気づかず、grep結果がズレた経験から得た offset/limit の使い分けと、bash で代替すべきケースの判断基準をまとめます。
何度直しても同じ間違いをするClaudeへの対処法 — 「指摘しても治らない」の正体と根本解決策
Claudeに何度注意しても同じ間違いが繰り返される問題の仕組みを解説。会話の流れで修正が消える理由と、Projectsやシステムプロンプトで永続的に直す方法を具体例とともに紹介します。
Claude Code MCP 接続トラブル完全診断ガイド
Claude Code の MCP サーバーが繋がらない・途中で切れる・ツールが見つからない問題を根本から診断する。設定ファイルの構造から通信ログの読み方、よくある落とし穴まで、実際のエラーパターンをもとに体系的に解説します。