運用Tips・トラブルシュート
コスト増、権限事故、無限ループ、テスト失敗など、運用で詰まりやすい問題を解決します。
24 件の記事
最初に読む3本
-
JSON差分の読み方：キー欠落・null・0・型変更を6件の例で区別する
API応答や設定のJSONを変更前後で比較するとき、キーがない、null、数値0、文字列の0を区別する手順。通信しない比較ツールの架空サンプル6件と期待結果、配列の並び、上限で停止した場合の確認方法を解説します。
-
AIエージェントに「原因調査だけ」を任せる依頼テンプレート
CodexやClaude Codeに修正を許可せず、再現条件・根拠・反証・影響範囲まで調査させるプロンプトと受け入れ基準を解説します。
-
法令をAIで扱うときの安全境界：出典・施行日・改正履歴の確認チェックリスト
法令調査をAIやMCPで補助するとき、何を自動化し、どこで人が確認するかを整理。法令ID、公布日、施行日、基準日、改正履歴、引用位置を残す実務チェックリストです。
続けて読む記事
21 件-
EDINETの書類種別コード一覧と絞り込み：docTypeCode・formCodeで半期報告書・大量保有報告書を分ける
EDINET API v2の書類一覧を書類種別コード（docTypeCode）で絞る方法を、金融庁の仕様書と様式コードリストで確認して整理。変更報告書は350のまま様式コードで分かれる、半期報告書には043A00がある、大量保有はissuerEdinetCodeで引く、の3点を架空JSONと通信しないNode.jsコードで再現します。
確認日 #edinet #public-data #nodejs #mcp -
EDINETの保存JSONから有報の取得候補を作る：Node.jsで訂正・取下げ・不開示を分ける
EDINETの書類一覧JSONをローカルで読み、有価証券報告書と訂正報告書のCSV取得候補を整理するNode.jsサンプル。架空10行を候補2・除外5・要確認3に分け、親docID、操作情報、欠損フラグを確認します。API接続や財務値の抽出は行いません。
確認日 #edinet #public-data #nodejs #mcp -
Claude Codeのログイン・OAuthエラー対処：/loginが通らない・APIキーが勝つ・組織違い
Claude Codeで/loginが失敗する、ブラウザが開かない、ANTHROPIC_API_KEYが勝ってサブスクが使われない、組織アカウントを取り違えるといった認証トラブルを、公式docsの認証優先順位とclaude auth系コマンドの実出力で整理します（2026-09-14確認）。
確認日 #claude-code #troubleshooting -
Claude Codeの使用上限（5時間・週次）の仕組み、Pro/Max別の枠と止まった時の対処
Claude Codeの5時間セッション上限と週次上限の仕組み、Pro・Max 5x・Max 20x・Team・API従量の料金と枠の違い、上限で止まった時の選択肢、/usageの読み方、枠を延ばす実務を公式docsで整理。
確認日 #claude-code #troubleshooting #tips #anthropic #個人開発 -
Claude Codeのアップデートが反映されない：自動更新の仕組み・claude update・二重インストール
Claude Codeのバージョンが古いまま、claude updateしても変わらない、警告が出続ける原因(自動更新の反映タイミング、DISABLE_AUTOUPDATER、ネイティブとnpm/WinGetの混在、PATH順序)と対処を、公式ページと2.1.261の実出力で整理(2026-09-14確認)。
確認日 #claude-code #troubleshooting #npm -
Claude Code Windowsネイティブのトラブル：Git Bash・PowerShell実行ポリシー・パス・改行
Windows 11でClaude Codeをネイティブ実行したときの詰まりどころ(Git Bashが見つからない、実行ポリシー、パス区切りと改行、ネイティブ版とnpm版の混在、WSLとの使い分け)を、公式ページと手元Windows 11 Proの実測で整理(2026-09-14確認)。
確認日 #claude-code #windows #troubleshooting -
Codex CLI エラー集：ログイン失敗・サンドボックス拒否・MCP・Windows・モデル指定
Codex CLI 0.144.1で実際に再現したエラー(モデル未対応、要アップグレード、required MCP server failed)と公式ドキュメント(auth / sandboxing / MCP / Windows)をもとに、症状別の原因と直し方を整理。codex doctorでの一次切り分けから(2026年9月14日確認)。
確認日 #codex-cli #codex #troubleshooting -
e-Gov法令API v1からv2への移行ガイド：エンドポイント対応表と労基法での応答比較
e-Gov法令API v1（lawlists・lawdata・articles・updatelawlists）からv2への移行を、エンドポイント対応表とパラメータの読み替えで整理。労働基準法を両方で取得してXMLとJSONの差を比べ、v1提供終了の公式告知の有無も2026年9月14日に確認しました。
確認日 #egov #japanese-law #legal-tech #mcp -
e-Gov法令API v2のエラーコードと制限：404・400の実測一覧と504の切り分け、Base64、巨大法令のサイズ
e-Gov法令API v2で存在しないID・不正なasof・不正なパラメータを実際に叩き、ステータスコードとエラー本文を一覧化。Base64と文字コード、Accept と response_format の優先順位、民法・会社法・所得税法の取得サイズと所要時間を2026年9月14日のcurl実測で記録しました。504 Gateway Time-out は、実測した1例と未確認の範囲を分けて切り分け手順を載せています。
確認日 #egov #japanese-law #legal-tech #api #troubleshooting #json #windows -
e-Gov法令API v2のキーワード検索：検索式・ページング・ヒットしない語の実例
e-Gov法令API v2の keyword エンドポイントで条文本文を全文検索する方法を解説。AND・OR・NOT・括弧・ワイルドカードの書き方、total_countが文の数である点、next_offsetによるページング、半角英字がヒットしない実例を2026年9月14日のcurl実測で確認しました。
確認日 #egov #japanese-law #legal-tech #api #troubleshooting #tips #mcp -
e-Gov法令API v2のlawsで法令一覧を絞り込む：公布日・種別・分類・廃止状態の実例
e-Gov法令API v2の /laws で使える21個のクエリパラメータをOpenAPI定義から一覧化。公布日の範囲・法令種別・事項別分類・廃止状態・改正法令IDでの絞り込みを2026年9月14日にcurlで実行し、件数と応答の読み方、orderの並び方の注意点を確認しました。
確認日 #egov #japanese-law #legal-tech #api #json #mcp -
OllamaがWindowsでGPUを使わない・遅いときの確認手順：ollama psとログ
OllamaがWindowsでGPUを使わない、急に遅くなったときの確認手順です。ollama psのPROCESSOR列、server.logのGPU検出行、nvidia-smiの見方を整理し、RTX 3090でnum_ctxを上げてCPUへ一部オフロードされる様子を2026年9月14日に再現しました。
確認日 #local-llm #ollama #windows #troubleshooting -
MCPサーバーをJSON-RPCでテストする｜stdio最小ハーネス
MCP 2026-07-28のstdioサーバーをLLMクライアントなしで検査するNode.js最小ハーネスです。server/discover、必須_meta、tools/list、改行区切り、stdout汚染を切り分けます。
確認日 #mcp #json-rpc #stdio #testing #nodejs #troubleshooting -
e-Gov法令API v2のasof：2時点の条文を比較して保存する
e-Gov法令API v2のasofを使い、同じ法令IDの2025年6月と2026年1月の版を比較。Pythonの実行コード、履歴ID・XML差分・出典の保存、失敗時の確認手順を2026年9月26日の実測で解説します。
確認日 #mcp #egov #python #japanese-law #legal-tech #troubleshooting -
「下請法」で法令検索すると0件になる｜通称と現行法令名のズレをMCPで埋める
e-Gov法令MCP(@codeagentjp/egov-law-mcp)のsearch_lawsは法令名マッチのため、下請法・電帳法・景表法といった通称は0件で返ります。実測ログをもとに、通称→正式名称の解決手順と、改題された法令の扱いを整理します。
確認日 #mcp #claude-code #cursor #egov #japanese-law #troubleshooting -
egov-law-mcpが動かない時の対処法｜npx・Node.js・Windows接続エラー
e-Gov法令MCP(@codeagentjp/egov-law-mcp)がClaude CodeやCursorで接続失敗する時の切り分け手順を、npx解決、Node.jsバージョン、Windows固有、e-Gov API側の4段階で解説します。
確認日 #mcp #claude-code #cursor #egov #japanese-law #npm #troubleshooting -
AIエージェントに秘密情報を読ませない — .gitignore・権限・sandboxの実務
鍵やトークンをAIエージェントとログから守る方法を、読ませない・コミットさせない・残さないの3層で解説します。
確認日 #security #secrets #claude-code #permissions #tips -
Claude Codeのコンテキストが壊れた時の復旧 — /clear・/compact・/rewindの使い分け
Claude Codeが指示を忘れる・同じ失敗を繰り返す時は、積み増しより作り直しが速いです。/clear・/compact・/rewindが何を消すかで選びます。
確認日 #claude-code #context #tips #troubleshooting -
Claude Codeの権限プロンプトを減らす設定 — allowlist・autoモード・sandboxの使い分け
Claude Codeの確認プロンプトが多すぎる時の安全な減らし方。allowlist・autoモード・sandboxの違いと向き不向き、settings.jsonの設定例、非対話実行の注意までを実務目線で整理します。
確認日 #claude-code #permissions #settings #sandbox #tips -
MCPサーバーが繋がらない時のチェックリスト — claude mcp add・stdio・HTTP・環境変数
MCPサーバーが繋がらない原因の多くはコマンドパス・作業ディレクトリ・環境変数・トランスポート種別の取り違えです。stdioとHTTPの違いから切り分け手順までまとめます。
確認日 #mcp #claude-code #troubleshooting #stdio #tips -
ローカルLLMの失敗と負の結果：J-WorkBenchの保存出力7ケース
2026年6月6日のJ-WorkBench保存出力から、JSON崩壊、根拠のない断定、二重計上などの失敗、ローカルが高得点だった例、長文課題で失敗を観測できなかった例を紹介します。人工課題の結果で、一般的な故障率の測定ではありません。
確認日 #local-llm #ollama #troubleshooting #rag #benchmark