
Claude Code でつまずいたときの切り分けメモ
QiitaClaude Code 利用時に複数ユーザーが報告する不具合(セッション未返却、編集状態不整合、データ共有制限、コンテキスト圧縮停止、モデル利用不可、メッセージ数ずれ、出力ファイル置き換え失敗)ごとに、GitHub Issues を基に実際に検証した対処手順と切り分けポイントをまとめたメモ。各症状の原因判定フロー、確認項目、回避策を実例ベースで紹介。
全 1778 件 (Qiita で絞り込み) · 20 / 89 ページ

Claude Code 利用時に複数ユーザーが報告する不具合(セッション未返却、編集状態不整合、データ共有制限、コンテキスト圧縮停止、モデル利用不可、メッセージ数ずれ、出力ファイル置き換え失敗)ごとに、GitHub Issues を基に実際に検証した対処手順と切り分けポイントをまとめたメモ。各症状の原因判定フロー、確認項目、回避策を実例ベースで紹介。

ユーザーがバズ記事をスライド化するため x_to_pptx コマンドを実行したところ、Claude Code は記事に含まれるコピペ用プロンプトを要約に置き換えるよう求め、30分間にわたって長文プロンプトのそのまま使用を拒否し続けた。6つの連携ツールを跨いだ自動ワークフローで、X 取得失敗・Claude in Chrome フォールバック・疑わしい指示検出など複数の判断が発生した事象の記録。

Claude Code v2.1.260 が v2.1.259 で導入された Read() deny ルールの Bash 適用を取り消し、npm run build が誤って拒否される問題を解決。同バージョンでは括弧を含むパスの permission ルールパース不具合、正規表現コンパイル失敗、zsh の抜け道塞ぎなどの修正も実施。/diff コマンドと /skill-doctor コマンドが新たに追加された。


SES の案件管理の課題(チャットでの埋もれ、進捗把握の困難さ)を解決するため、Claude にプロンプトを投げて案件管理システムを開発。FastAPI + React で構築し、営業・エンジニア・管理の 3 ロールで異なる権限を実装。実装中のログアウトバグも Claude の指摘で迅速に修正。

Claude Code は Fable 5、Fable 5.1、Opus 5 で異なるシステムプロンプトを使用しており、サブエージェント使用の有無や作業報告方法など振る舞いを決める指示がモデルによって入ったり入らなかったりする。さらに Anthropic サーバーからの配信で同じモデル・バージョンでも指示が動的に切り替わる仕組みになっている。




Anthropic認定資格 CCDV-F を 970/1000 で合格した学習方法の実例。公式 Prep Course と Matthew Purcell 氏の無料模試を活用し、Applications and Integration、Production Engineering など 8 ドメインを 3 日間で習得。AI・クラウド実務経験者向けの合格戦略と各領域の重点ポイントを解説。

Claude Code v2.1.259 では MCP サーバーの組織一元管理機能が追加される一方で、allowedMcpServers の適用範囲変更と管理設定ファイル解析失敗時の挙動変更という2つの破壊的変更が含まれた。管理配布サーバーを除外する場合は deniedMcpServers への移行、管理設定ファイルの事前検証、CI環境での --permission-prompts none オプション導入が必須対応となる。




Claude Code を組織導入する際、利便性と安全性を両立させるために managed-settings.json による権限設定が必要。rm -rf や git push --force のような破壊操作、認証情報の流出、プロンプトインジェクション攻撃の 3 つのリスクに対し、allow / ask / deny の 3 層構造で制御する仕組みを解説。

Claude Code の --model フラグと環境変数を使い OpenRouter の :free モデルにリクエストをルーティングすることで、AI コーディングの月額コストをゼロに削減できる。Qwen/Qwen3-235B-A22B:free など複数モデルを用途別に使い分け、.claude/settings.json でコンテキスト消費を最小化することで、品質とコストの両立が可能。

Claude Code v2.1.259 では、Bash のオプション値や複合コマンド経由で Read() deny ルールをすり抜けていた脆弱性を修正し、managedMcpServers による組織向け MCP 配布機能を追加。複数セッション間の設定上書き問題やフロントマター model: の無視など運用面の修正も合わせて対応。

Slack AI は有料プラン(プロ以上)に組み込まれた AI 機能で、要約・AI 検索・Slackbot・ワークフロー生成などを段階的に解放する。フリープランは AI 機能なし。別系統として Anthropic 提供の Claude Tag(旧 Claude in Slack)はチャンネルに常駐する共有 AI エージェントとして機能し、GitHub などのツール操作や文脈蓄積に対応する。

Claude Code の 5日間連続学習の最終回。README自動生成、CLIツール化、pytest テストコード整備という実務的なタスクを実行し、それぞれの過程でClaude自身が環境不足や文字化けに気づいて対処する様子を記録。5日間を通じた気づき(Plan Mode の有用性、CLAUDE.md による記憶持続、デバッグの聞き方の工夫)を整理し、Claude Code と通常チャットの使い分け基準を明示。
