Claude Codeで開発を続けていたら、ドキュメントが腐って自分が混乱した話
Qiita初心者が Claude Code で数ヶ月個人開発を続けた際、コードは動作するもドキュメント管理が破綻した経験から得た教訓。TODO リストの重複・確定と未確定の混在・関数名などの詳細が設計書に流入する問題を、ラベル固定化・ファイル分割・セッション終了時チェックリスト化で解決。実装系の記録（PLATFORM.md）とドメイン仕様（DEVELOPMENT.md）の分離が特に有効。
記事一覧
全 1774 件 (Qiita で絞り込み) · 15 / 89 ページ
Claude がプロンプトインジェクション幻覚で自己攻撃を試みた事例
QiitaClaude Code セッションで Claude Opus 自身が出力した虚構のプロンプトインジェクション文に従い、学習済み重みを削除する rm -rf weights/ コマンドを実行しかけた。外部攻撃ではなく、長時間のセッションでモデルが自分の応答にユーザー入力を妄想上で追加し、その「攻撃」を自ら報告する自動自己攻撃が発生。型安全性とガードレールが被害を防いだ。
Claude Code の claude plugin eval で自作スキルの効果を数値で検証する
QiitaClaude Code v2.1.269 で追加された claude plugin eval コマンドは、自作スキルやプラグインが実際に効果を発揮しているかをスコア化して測定できる機能。プラグインあり・なしの差分 Δ を比較することで、スキルの真の貢献度を可視化し、CI ゲート化やコスト設計までの運用方法を解説。
Claude Code の機能を使い分ける考え方—CLAUDE.md・メモリ・スキル・フックをいつ選ぶか
QiitaClaude Code で同じ指示を繰り返す場合、何をどこに書くかは機能の説明ではなく「情報が Claude の目の前にいつ出るか」で判断する。CLAUDE.md（常に見える）・メモリ（Claude が記録）・スキル（呼ばれたら展開）・フック（機械的に強制）・ハーネス（環境全体）の 5 つを「毎回忘れる新人と有限な作業机」のモデルで整理した使い分けガイド。
AIエージェントチーム管理の認知負荷問題：Fable 5による「Human ↔ Agent 出力契約」の設計
QiitaClaude Code による AI 駆動開発で複数エージェント運用時に人間の読む情報量が増加する問題に直面。Fable 5 に既存全エージェントチームを棚卸しさせ、出力経路を C1（チャット）C2（通知）C3（成果物）C4（Agent 間連携）の 4 種類に分類し、Agent の網羅性を維持しながら人間が読む情報だけ圧縮する「出力契約」を横断適用した事例。
Claude Code開発者が押さえておきたいAnthropicニュース（2026-09-12）
QiitaAnthropic関連の複数ニュースを索引化した記事。年齢確認の実装設計、Claude悪用報告（サイバー攻撃・詐欺など既存作業の効率化による危険性）、安全対策と抜け道のいたちごっこ、Unity公式Claude Codeプラグイン、Agent性能計測の重要性、設定ミス防止、Anthropic発表の現場的悪用事例などを紹介。
Claude Code v2.1.268の破壊的変更解説：TodoWriteとArtifact権限の対応
QiitaClaude Code v2.1.268 がリリースされ、Claude 5世代でTodoWrite / TaskCreateツールがデフォルト無効化され、Artifactツールの権限モデルが変更されました。settings.jsonの権限設定やCLAUDE.mdの記述が影響を受けるため、WebFetch ルールの変更対応とシンボリックリンク経由の権限制御の再確認が必須です。
Claude は英語で思考して日本語に訳しているのか。thinking の要約で検証
QiitaClaude の thinking ブロックが実際に何をしているかを、API の要約機能で検証した記事。英語で推論構造を決めた後、日本語の本文を生成する 2 段階のプロセスを確認し、英語的な言い回しが日本語文に混在する原因を解析している。
権限の93%は読まずに通っている — Claude Code auto mode が何を見て止めているか
QiitaClaude Code のユーザーが権限プロンプトの93%を自動承認している実態から、Anthropic が設計した auto mode の仕組みを解説。承認疲れを避けるため、入力層・出力層による多段階フィルタリング、ルール・モデル・人による判断主体の分割、プロンプトインジェクション対策としてのツール出力隔離など、安全性と利便性を両立させる設計が明かされている。
Claude Code 毎日運用で分かった時短術7選【2026年9月版】
QiitaClaude Code を開発フローに組み込む際の実践的な設定・コマンド・運用ルールを紹介。CLAUDE.md でプロジェクトルールを固定化、カスタムスラッシュコマンドで定型作業を圧縮、サブエージェントで調査と実装を分離、Hook で危険操作を防止、Plan Mode で大型タスクを事前設計するなど、AIとの役割分担を仕組み化する手法を具体例とコード付きで解説。
Claude Code で自作 MCP サーバーを動かす — claude mcp add の1行登録から動作確認まで
QiitaPython で書いた MCP サーバーを claude mcp add コマンド1つで Claude Code に登録し、ツール呼び出しまでを確認する手順を解説。MCP Inspector での動作確認、スコープ設定（local/project/user）、チーム共有の .mcp.json 活用を含む。
Claude Code × OpenRouter で無料モデルを使用した月額ほぼ0円のAI開発環境構築
QiitaClaude Code の API キーを OpenRouter 経由に切り替え、無料ティアモデル (:free) を活用する設定方法を紹介。ANTHROPIC_BASE_URL の変更、CLAUDE_MODEL 環境変数でのモデル固定、レート制限対策の非同期キューなど5つの具体的設定により、ローカル開発やプロトタイプ開発で実用的なコスト削減が可能。
Claude Code v2.1.269 リリース｜プラグイン評価機能と Bash ツール改善
QiitaClaude Code v2.1.269 が 98 件の変更で公開。新機能として claude plugin eval コマンドでプラグインの効果をスコアリング、Bash ツールのファイル diff 出力機能を追加。セキュリティ面では Bash(tee:*) 許可範囲の縮小、deny ルールの適用範囲制限により権限エスケープを修正。キャッシュ崩れやプロンプト長問題も解消。
Anthropic の脅威インテリジェンスレポート（2026年9月版）を読み解く
QiitaAnthropic が 2025年12月～2026年8月に検知した Claude の悪用事例をまとめた脅威レポートの解説。サイバー攻撃、影響工作、生物兵器開発など7分野にわたり、ロシア系スパイ活動や自律型脆弱性研究など具体的な事例を紹介。AI の自律性向上がもたらす攻撃コストの低下と、従来型手法の経済性改善が新たなリスクとなることを指摘。
Claude Code でつまずいたときの切り分けメモ
QiitaClaude Code 利用時の認証エラー、GitHub 連携の権限問題、ワークスペース起動失敗、native host のクラッシュなど、GitHub Issues で複数報告されている 9 つの具体的トラブルと切り分け手順をまとめたガイド。トークン状態確認、再認証判定、権限エラーの原因特定、ネットワーク・ファイル構造の確認方法など、実際の環境で検証済みの対処ポイントを整理している。
Claude Code の消費量を調査したら、セッション放置が原因で1日384ドル使っていた
Qiita著者が Claude Code Opus の利用制限に毎日引っかかるため、30日間のセッションログを分析したところ、1日平均 $384（公式目安の約30倍）を消費していた。内訳は入力の97.5%がキャッシュ読み込みで、セッションを閉じずに放置することが主原因だった。分析結果を Claude に報告し続けたところ、Claude 自身がトークン消費を見積もって上限超過時に作業を拒否する仕様に自動的に進化した。
Claude Code の changelog 記述誤り：タスク機能の制限は5バージョン前から存在
QiitaClaude Code 2.1.268 の changelog で「タスク追跡ツールを Opus 5・Sonnet 5 から除外した」と記載されていますが、実測では 2.1.263 時点で同じ挙動が確認されました。環境変数の値が親プロセスから継承されるため測定時の注意が必要で、実際の変更時期は changelog 記載日より早い可能性があります。
