AI開発

AIコーディングで変更してはいけないファイルを守る方法|権限・ルール・Read Only設計

Claude CodeのPermission・Hook・Sandbox、GitHub CopilotのCustom Instructions、Docker Read Only Mount、GitやCIまで、AIコーディングツールに変更してほしくないファイルを複数の層で守る設計を解説します。
AI開発

GitHub Copilotがcopilot-instructions.mdを無視する原因|配置場所と適用範囲を確認

GitHub Copilotがcopilot-instructions.mdの指示を無視しているように見えるとき、配置場所・Workspace Root・References・VS Code設定・Path-specific Instructions・機能ごとの対応差という観点から原因を切り分ける方法を解説します。
AI開発

Claude CodeのHooksが動かない原因|matcher・exit code・JSONの確認方法

Claude CodeのHooksが実行されない、またはexit codeやJSONによる制御が効かないとき、matcher・Hook Event・exit code(0/1/2)・stdin/stdoutのJSON形式・Script Pathという観点から原因を切り分ける方法を解説します。
AI開発

Claude Codeのsettings.jsonが反映されない原因|User・Project・Localの優先順位

Claude Codeのsettings.jsonを変更しても権限やHook、環境変数が反映されないとき、User・Project・Localの優先順位、settings.local.jsonとの競合、~/.claude.jsonとの混同、/status・/doctorでの確認方法という観点から原因を切り分ける方法を解説します。
AI開発

Claude CodeがCLAUDE.mdを読まない原因|配置場所・優先順位・読み込み範囲を確認

Claude CodeがCLAUDE.mdの指示を無視しているように見えるとき、/contextでの確認方法、配置場所ごとの読み込み範囲、優先順位、サブディレクトリや@インポートの読み込みタイミングという観点から原因を切り分ける方法を解説します。
AI開発

MCPのProtocol Loggingが非推奨になった理由|stderrとOpenTelemetryでのログ設計

MCP 2026-07-28でProtocol Level Loggingが非推奨になった背景と、stdio・Streamable HTTPを問わないログ設計、OpenTelemetryへの移行方針を解説します。
AI開発

MCPのstdioサーバーが接続できない原因|stdoutにログを出してはいけない理由

MCPのstdioサーバーが起動するのに接続できない原因を、stdoutとstderrの役割の違い・安全なログ出力の設計(log_level・マスキング・ログファイル)・バッファリング・Wrapper Scriptやsubprocessの出力混入という観点から解説します。
AI開発

MCPサーバーが起動するのにツール一覧が表示されない原因|tools/listを確認

MCPサーバーは正常に起動しているのにツール一覧が表示されない原因を、tools/listのレスポンス・Tool登録・Capability・動的Tool・キャッシュという観点から切り分ける方法を解説します。
AI開発

MCPサーバーで「Invalid Params」が出る原因|JSON Schemaと引数を確認

MCPサーバーのTool実行で発生するInvalid Params(-32602)エラーの原因を、tools/callのparams構造・inputSchemaの型やenum・SDKごとのエラー返却方式という観点から切り分ける方法を解説します。
AI開発

MCPサーバーが「Method not found」になる原因|tools/list・tools/callを確認

MCPサーバーで発生するMethod not found(-32601)エラーの原因を、tools/list・tools/call・Capability宣言・Protocol Versionの不一致という観点から切り分ける方法を解説します。
AI開発

AIエージェントのコンテキストが長くなりすぎる原因|履歴を圧縮・分割する設計

AIエージェントのコンテキスト肥大化を、会話履歴の圧縮(Compaction)・Tool Resultの整理・RAGの取得件数・サブエージェント分割・長期記憶の分離によって防ぐ設計をOpenAI Agents SDKとAnthropic APIの例で解説します。
AI開発

AIエージェントが存在しないツールを呼び出す原因|Tool Callingのハルシネーション対策

AIエージェントが登録していないツール名を呼び出す「Tool Callingのハルシネーション」を、ツール設計・description・allowed_tools・Tool Searchによるツール数増加対策・実行前検証・評価テストによって未然に防ぐ方法を解説します。
AI開発

Structured OutputsでJSON Schemaエラーになる原因|required・additionalPropertiesの直し方

OpenAI APIのStructured Outputsで発生するJSON Schemaエラーを、required全項目指定・ネストしたobjectへのadditionalProperties: false・ルートの制約・Schemaサイズ上限から切り分けて解決する方法を解説します。
AI開発

Function Callingで「tool not found」になる原因|ツール名・登録漏れ・スキーマを確認

OpenAI APIのFunction Callingで発生する「tool not found」エラーを、ツール名の不一致・登録漏れ・条件付き無効化・Responses/Chat Completionsの形式混同・strict modeのSchema不備から切り分けて解決する方法を解説します。
AI開発

AIにテストを書かせても意味がない?実装をそのまま写すテストを防ぐ方法

AIが実装コードをそのままテストへ書き写す「追認テスト」を防ぐため、仕様起点の期待値設計、境界値、Testing Library・Playwrightの振る舞いベース設計、Property-Based Testing、Mutation Testingを使う方法をTypeScriptで解説します。
AI開発

AIに大規模リファクタリングを任せる方法|差分を小さく分割して壊さない手順

Claude Code・Codex・Gemini CLIを使った大規模リファクタリングを、Plan Mode・Worktree・小さなCommit単位・Diff Reviewによって安全に進める手順をGit操作とプロンプト例とともに解説します。
AI開発

AIコーディングツールにAPIキーを読ませない方法|.env・deny設定・秘密情報対策

Claude Code・OpenAI Codex・Gemini Code Assist/Gemini CLIを例に、.gitignoreだけでは防げないAPIキー漏えいを、permissions.deny・Sandbox・Permission Profile・.aiexclude・.geminiignoreなど複数の層で防ぐ方法を解説します。
AI開発

AIが生成したコードをレビューするチェックリスト|動くのに危険な実装を見抜く

ChatGPTやClaude、AIコーディングエージェントが生成したコードは、正常に動いても安全とは限りません。OWASP Top 10:2025・CWE Top 25:2025を踏まえ、アクセス制御・SQLインジェクション・SSRF・秘密情報の扱い・冪等性・依存パッケージまで、本番採用前に確認すべきポイントをTypeScript/Node.jsのコード例で解説します。
AI開発

MCP Inspectorの使い方|ツールを単体テストして接続エラーを調べる

MCP公式のInspector(Web・CLI・TUI)を使い、stdio・Streamable HTTPサーバーのtools/callを単体実行して接続エラーとTool内部エラーを切り分ける方法を、Protocol Era設定やCLI終了コードとともに解説します。
AI開発

MCPツールがタイムアウトする原因|再試行・キャンセル・冪等性の設計

MCP 2026-07-28仕様のCancellation・Progress・Tasks拡張を踏まえ、tools/callのタイムアウト原因とTypeScript SDK v2でのAbortSignal連携、operationIdによる冪等な再試行設計を解説します。