
Claude Code・Codex エラー全網羅パック|Windowsで動かない・文字化け・フック・MCP・自動実行を症状別166項目【診断スクリプト付き・2026年10月版】
「claude と打つと 'claude' is not recognized と出て、動かない」
「ログインしているのに Invalid API key と言われる」
「フックを書いたのに止まらない。逆に、何をしても hook error で止まる」
「PowerShell で日本語が ????? に化ける」
「claude -p は成功したのに、ファイルができていない」
「Codex が Not inside a trusted directory で止まる」
この記事は、そういうエラーや「動かない」を、症状から引いて、その場で直すための解決集です。Claude Code と Codex を Windows で毎日使っている私が、公式ドキュメントのトラブル対応の記載と、自分の PC で実際に動かして確かめた結果と、運用で実際に踏んだ失敗を、1つの辞書にまとめました。
量は、全部で166項目、約22.1万字です。診断と自動実行に使うスクリプトも6本付けました(M1〜M6)。そのうえで、ただ並べただけにしないよう、次のことをしました。
Windows 11 の実機で再現できたものは、再現しました。(67項目)エラー文・終了コード・出力を、動かした結果のまま載せています。たとえば「壊れた settings.json は claude -p では何も言われずに丸ごと無視され、deny も効かなかった」「フックが jq の無い環境で、止めるはずのコマンドを素通りさせた」などです
公式ドキュメントの記載だけが根拠の項目は、そう書きました。私が試したことにはしていません。出典の URL を、項目ごとに付けています
確かめていないことは、「確かめていません」と書きました。公式と実機が食い違うところは、両方書いています
運用で実際に踏んだ失敗は、症状・原因・直し方・再発させない仕掛けを、記録のとおりに書きました。記録に無い原因は足していません
先に、いちばん大事な1つを言っておきます。この記事は、頭から読むものではありません。 困ったときに、症状の言葉(エラー文)で探して、その1項目だけを読んでください。下の「全目次」が、そのための索引です。ブラウザの検索(Ctrl+F)で、エラー文の一部、または「D04」「G07」のような番号を探すと、すぐ飛べます。
「全網羅」の意味も、正直に書いておきます。起こりうる不具合の全部、という意味ではありません。公式ドキュメントに載っているトラブル対応と、私が Windows で再現できた・実際に踏んだ症状を、漏れなく項目にした、という意味です。ここに無い症状は、M1(環境の診断)と、下の「最初の3分」で切り分けてから、公式の claude doctor と --debug に進んでください。
最初の3分で切り分ける(無料)
原因を探す前に、この6つを順に見てください。どれも読むだけで、何も変えません。
claude はどこの何版が呼ばれているか。 where.exe claude と claude --version。複数あって版が違うと、新しいオプションが unknown option になります → A01・A10。M1 が全部を並べます
ログインしているか。環境変数のキーが上書きしていないか。 ANTHROPIC_API_KEY が残っていると、ログインよりそのキーが優先されます → B04・B06
設定ファイルは正しい JSON か。 末尾のカンマ1つで、claude -p は設定を丸ごと無視します。エラーも出ません → E01。M2 が検査します
Windows なら、実行ポリシーと文字コード。 running scripts is disabled → D04。日本語が ?????・縺… に化ける → D07〜D10
フックなら、止まらないのか、止まりすぎるのか。 exit 1 は止まらず、exit 2 は止まります。パスの \ が消えると、Python は終了コード 2 で終わり、Bash が全部止まります → G01・G04・G06
自動実行なら、終了コードだけで成功と決めない。 許可が足りずに飛ばされたツールがあっても、終了コードは 0 のままです → I01・I07。M5 が JSON まで読んで、終了コードに直します
この全網羅パックに入っているもの(全12章・166項目・スクリプト6本)
A. 入れる・見つからない・更新:PATH・インストールの失敗・複数の版・更新
B. ログイン・認証:Not logged in・OAuth・API キーの上書き・setup-token
C. 通信・API エラー:接続・プロキシ・証明書・429・500・529・時間切れ
D. Windows の落とし穴:Git Bash と PowerShell・実行ポリシー・WSL の bash の取り違え・文字コード(PowerShell 5.1・Python)・タスクスケジューラ
E. 設定ファイル・信頼・CLAUDE.md:壊れた JSON・優先順位・未信頼のフォルダ・読まれない CLAUDE.md
F. 権限:評価順・複合コマンド・deny の抜け道・-p で飛ばされる許可
G. フック:止まる・止まらない・動かない・日本語が化ける・jq が無い
H. スキル・サブエージェント・MCP:一覧に出ない条件・接続できない・承認待ち・タイムアウト
I. 自動実行 claude -p:終了コードの罠・上限・--resume・予約タスク
J. 使用量・モデル・コンテキスト:上限・Prompt is too long・モデル名・費用
K. Codex:Windows のサンドボックス・config.toml・codex exec・MCP・利用上限
L. 自動運用で実際に起きたこと:公開が止まる・上限・画面なしのブラウザ・同期の衝突
M. 診断と自動実行のスクリプト 6本:環境の診断・設定ファイルの検査・安全なフックの雛形・予約タスクの登録・claude -p と codex exec を安全に呼ぶ道具(動作確認の記録つき)
全目次(166項目の題名)
何が入っているかを、題名だけ全部並べます。題には、検索されるエラー文をそのまま入れました。
A. 入れる・見つからない・更新(14)
A01 「'claude' is not recognized」「command not found: claude」で claude が動かない(PATH の設定)
A02 「'irm' is not recognized」「The token '&&' is not a valid statement separator」で入らない
A03 インストールスクリプトの代わりに HTML が返る(syntax error near unexpected token '<'・403)
A04 「Failed to fetch version from downloads.claude.ai」でインストールが止まる(接続・プロキシ)
A05 「The connection dropped while downloading the update」「Download timed out」で更新が失敗する
A06 npm で入れたのに「claude native binary not installed」と出る
A07 npm の更新で「npm error code ENOTEMPTY」が出る
A08 「The process cannot access the file」でインストーラーが止まる(別のプロセスが使用中)
A09 claude と打つと Claude Desktop が開く
A10 「unknown option」で新しいフラグが通らない(PATH の claude が古い版)
A11 自動更新を止める・特定の版に固定する(claude update・DISABLE_AUTOUPDATER・WinGet)
A12 更新の直後に「'claude' is not recognized」(claude.exe.old.* が残っている)
A13 「Exec format error」(WSL1)・「does not support 32-bit Windows」(32 ビットの PC)
A14 VS Code の拡張だけ入れた。ターミナルで「'claude' is not recognized」と出る
B. ログイン・認証(8)
B01 「Not logged in · Please run /login」と出て claude が動かない(未ログイン・ログイン切れ)
B02 「OAuth error: Invalid code」でログインが終わらない(ブラウザが開かない・コードの貼り付け)
B03 ログイン後に「API Error: 403 Request not allowed」が出る(契約・ロール・プロキシの確認)
B04 「This organization has been disabled」と出る(古い ANTHROPIC_API_KEY が上書きしている)
B05 「Invalid API key · Fix external API key」と 401 が出る(キーが拒否された・無効)
B06 「connectors are disabled because ANTHROPIC_API_KEY」(環境変数のキーがログインより優先される)
B07 ログインしているかを確かめる・認証情報の保存場所(claude auth status)
B08 ブラウザが使えない環境(CI・スクリプト)でログインする「claude setup-token」
C. 通信・API エラー(10)
C01 「Unable to connect to API. Check your internet connection」で接続できない
C02 社内プロキシの裏で claude が動かない(HTTPS_PROXY・HTTP_PROXY・NO_PROXY)
C03 「unable to get local issuer certificate」(社内プロキシの証明書を信頼していない)
C04 「TLS connect error」・「CRYPT_E_NO_REVOCATION_CHECK」(TLS の握手に失敗する)
C05 「Socket is closed」・「Streaming response ended」(通信が途中で切れる)
C06 「API Error: No response from API」・「Waiting for API response」(応答が来ない)
C07 「API Error: 500 Internal server error」(API 側の一時的な失敗)
C08 「Request rejected (429)」・「Server is temporarily limiting requests」(流量の制限)
C09 「Repeated 529 Overloaded errors」・「Opus is experiencing high load」(API が混んでいる)
C10 「Request timed out」(既定の 10 分の期限を過ぎた・途中で切れた)
D. Windows の落とし穴(18)
D01 「Claude Code on Windows requires either Git for Windows (for bash) or PowerShell」と出る
D02 「Git Bash was not found」と出る・Git Bash があるのに使われない
D03 「Denying Bash also turns off the PowerShell tool」で PowerShell が使えない
D04 「running scripts is disabled on this system」で claude が動かない(PowerShell の実行ポリシー)
D05 「command not found」と出る・Python から bash を呼ぶと WSL の bash が起動する
D06 「C:/Program Files/Git/usage」に化ける(Git Bash が / を書き換える)
D07 「?????」と化ける・PowerShell 5.1 で日本語をパイプから外部プログラムに渡す
D08 PowerShell 5.1 の > は UTF-16 で書く・Set-Content -Encoding UTF8 は BOM 付き
D09 「UnicodeEncodeError: 'cp932' codec can't encode character」で止まる・パイプやファイルへの print
D10 「UnicodeDecodeError: 'cp932' codec can't decode byte」で止まる・UTF-8 の日本語ファイルを読むとき
D11 環境変数を設定したのに効かない(PowerShell の $env と setx・永続化の違い)
D12 タスクスケジューラで動かすと作業フォルダが C:\Windows\System32 になる
D13 「is a network path, which cannot be added as a working directory」・共有フォルダ(UNC パス)で起動できない
D14 「Claude Code can't read the keyboard here」と出る・パイプや別のプログラムから起動したとき
D15 「EBADF: bad file descriptor, read」・セッションの記録が読めない(セキュリティソフト)
D16 統合ターミナルで文字が箱になる・にじむ・違う字形になる
D17 Bash ツールで書いたファイルの「\」が消える・「\t」が TAB になる(ヒアドキュメント)
D18 WebFetch で日本語のページが文字化けする(cp932 のページ)
E. 設定ファイル・信頼・CLAUDE.md(12)
E01 settings.json の末尾カンマで deny が効かない(claude -p は何も言わない)
E02 設定を書いたのに変わらない(上の階層が同じキーを決めている)
E03 「Error: Settings file exceeds the 2MiB limit」で --settings のファイルが読まれない
E04 「this workspace has not been trusted」で、プロジェクトの allow が無視される
E05 ユーザーの settings.json(bypassPermissions・フック)が試験の結果を汚す
E06 CLAUDE.md が読まれない(場所・CLAUDE.md.txt・/context で確かめる)
E07 CLAUDE.md に書いたのに守られない(曖昧・矛盾・フックに移す)
E08 CLAUDE.md の @ で書いたファイルの中身が入らない(空白・引用符・相対パス)
E09 「Instruction file not loaded (a Read deny rule covers it)」で CLAUDE.md の参照先が読まれない
E10 AGENTS.md が読まれない(CLAUDE.md があると AGENTS.md は読まれない)
E11 BOM や CRLF で設定や CLAUDE.md が読まれないと疑ったが、原因ではなかった
E12 DISABLE_TELEMETRY=0 でも送信が止まる・設定の不具合を claude doctor と --safe-mode で切り分ける
F. 権限(permissions)(9)
F01 deny・ask・allow の評価順。allow では deny の例外を作れない
F02 allow に書いたのに確認が出る(&& や ; でつないだコマンド)
F03 deny で git push を止めたのに通る(git -C . push などの書き方)
F04 Invalid permission rule was skipped(権限ルールの書き方が違って無視される)
F05 権限ルールの Windows のパスの書き方(UNC パス・is a network path)
F06 deny で .env の読み取りを禁止したのに、Python スクリプト経由で読めた
F07 -p で許可が足りないツールは、終了コード 0 のまま拒否される
F08 dontAsk で cd と && をつないだコマンドが止まった(狭い許可のまま自動実行)
F09 this workspace has not been trusted(許可は信頼してから効き、禁止は未信頼でも効く)
G. フック(hooks)(14)
G01 フックで止めたのに Bash が実行される(exit 1 は止まらない。止めるなら exit 2)
G02 「No stderr output」で Bash が止まる(フックが理由を書いていない)
G03 フックが一度も動かない(matcher の大文字・小文字と、古い書き方)
G04 hook error の「can't open file」(パスの \ が消える。引用符で囲む)
G05 hook error の「%CLAUDE_PROJECT_DIR%」が展開されない(Windows の書き方)
G06 フックのスクリプトが開けないと、echo も止まる(hook error で止まる)
G07 jq が無いと、止めるはずのシェルのフックが素通りする
G08 フックが受け取った日本語のコマンドが化ける(標準入力が cp932)
G09 フックの理由の日本語が化けて Claude に届く(stderr と JSON の ensure_ascii)
G10 フックがタイムアウトすると止まらずに Bash が通る
G11 permissionDecision を書いても効かない(hookSpecificOutput の中に入れる)
G12 Stop フックが 8 回で打ち切られる(stop_hook_active と BLOCK_CAP)
G13 フックが動いているか分からない(/hooks・Only hooks from managed settings run here・disableAllHooks)
G14 「blocking because Git Bash wasn't found」で Bash が止まる(Windows)
H. スキル・サブエージェント・MCP(16)
H01 スキルが呼ばれない(description の前半に使う場面を書く・1,536 字で切られる)
H02 スキルが一覧に出ない(SKILL.md の frontmatter・入れ子のフォルダ・予約名)
H03 同じ名前のスキルが二つあると、どちらが動くか(個人とプロジェクトの衝突)
H04 「Git Bash was not found」で shell: bash のスキルが動かない(Windows)
H05 サブエージェントが見つからない(name や description が無い・frontmatter の書き間違い)
H06 「subagent_type is required」「zero tools」でサブエージェントが起動しない(tools の綴り違い)
H07 disallowedTools に Bash(git push *) と書くと、Bash 全体が外れる
H08 「Error: Invalid --agents configuration」と説明文の「15.0k-token limit」
H09 自作コマンドの $1 が記号のまま渡る・! の埋め込みが黙って止まる
H10 MCP の「disconnected」「✘ Failed to connect」で接続できない
H11 MCP を Windows で起動するとき「cmd /c npx」が要るか(公式に記載なし)
H12 MCP の「Pending approval」のまま .mcp.json のサーバーが動かない
H13 MCP の「sign in again」・401・空のままの ${VAR}
H14 MCP が時間切れで止まる・結果が途中で切れる(MCP_TIMEOUT・MAX_MCP_OUTPUT_TOKENS)
H15 MCP のツールが Claude に送られない・見えない(JSON schema is invalid・128 字超)
H16 MCP ツールの許可が効かない・毎回確認が出る(mcp__<server>__* の書き方)
I. 自動実行 claude -p(15)
I01 claude -p の終了コードだけでは成功か失敗か分からない(is_error・subtype)
I02 Input must be provided either through stdin or as a prompt argument(claude -p に入力が無い)
I03 Warning: no stdin data received in 3s(claude -p が標準入力を待つ)
I04 argument 'xml' is invalid/stream-json requires --verbose(出力形式の指定)
I05 Reached maximum number of turns(claude -p の --max-turns に達した)
I06 Reached maximum budget(claude -p の --max-budget-usd に達した)
I07 permission_denials(許可の無い Write は終了コード 0 のまま拒否される)
I08 claude -p の --continue と --resume の違い(前の会話が続かない)
I09 No conversation found with session ID(claude -p の --resume で会話が見つからない)
I10 Error: --json-schema is not a valid JSON Schema(claude -p の JSON 出力の項目)
I11 claude -p で /コマンド が動かない(綴りの間違い・端末専用のコマンド)・Git Bash が / を書き換える
I12 claude -p は信頼していないフォルダでもフックと .mcp.json を読む(--bare)
I13 Waiting for background work to finish(claude -p が返ってこない)
I14 予約タスクで claude -p を動かす型(作業フォルダ・標準入力・文字コード・終了コード)
I15 claude -p は何も頼まなくても 1 回に約 2.5 万トークンを使う(道具を切ると縮む)
J. 使用量・モデル・コンテキスト(16)
J01 「You've hit your session limit」で止まる(プランの使用量の枠を使い切った)
J02 週の枠が減って、長い依頼が途中で止まる(枠を食う作業を減らす)
J03 上限で止まったあと、リセット後に自動で続く(Continuing automatically)
J04 「You've hit your monthly spend limit」で使えない(使用量クレジットの支出の上限)
J05 /cost と /usage の表示の見方(Total cost・Usage by model の意味)
J06 長く休んだあとの 1 通目が遅く、費用が多い(プロンプトキャッシュの切れ)
J07 「Prompt is too long」「Context limit reached」(文脈が一杯で送れない)
J08 「Autocompact is thrashing」(自動圧縮が何度も続けて失敗する)
J09 「Request too large (max 32MB)」と「Not enough messages to compact.」(送る量が多すぎる)
J10 自動圧縮が早すぎる・遅すぎる(autoCompactWindow・CLAUDE_CODE_AUTO_COMPACT_WINDOW)
J11 何も指定しない claude -p が、想定と違うモデルで動いた(モデルの優先順位)
J12 「There's an issue with the selected model」「Model 'X' not found」(モデル名が違う・使えない)
J13 「is restricted by your organization's settings」「not available with the Claude Pro plan」
J14 「does not support this model; version 2.1.255 or newer is required」(Claude Code の版が古い)
J15 「Effort 'xhigh' isn't available with thinking turned off on this model」
J16 費用がどこで増えるか(起動時の土台・CLAUDE.md・長い会話・サブエージェント)
K. Codex(OpenAI)(24)
K01 Codex を Windows で動かす。ネイティブの PowerShell か WSL2 か
K02 VS Code in WSL can't find codex(導入と、WSL の中の codex が見つからない)
K03 「The IDE extension is installed but unresponsive」で Codex の拡張が応答しない(Windows)
K04 ChatGPT でログインする(codex login・codex login status)
K05 API キーでログインする・認証情報の保存先(auth.json)
K06 ブラウザのない PC・SSH 先で codex login を終えられない(device-auth・ポート 1455)
K07 「401 Unauthorized: Missing bearer or basic authentication」で Codex が止まる(未ログイン)
K08 config.toml が効かない(置き場所・読む順番・信頼していないプロジェクト)
K09 「Error loading config.toml」・unclosed table・approval_policy の値の間違い
K10 Codex がファイルを書けない(sandbox_mode と approval_policy の値・既定)
K11 作業フォルダの外に書けない(writable_roots・--add-dir・%TEMP% の罠)
K12 ネットワークに出られない(network_access・許可するドメイン)
K13 「.git」「.codex」に書けない(Codex の保護されるパスと /tmp の既定)
K14 承認もサンドボックスも外す --yolo・danger-full-access は最後の手段
K15 WSL2・Linux で Codex のサンドボックスが動かない(bubblewrap・bwrap が無い)
K16 Windows の Codex サンドボックスで「Error 1385」・"Everyone" の警告・子プロセスが止まる
K17 AGENTS.md の指示が効かない(読まれる順番・32 KiB の上限・ほかのファイル名)
K18 「Not inside a trusted directory」で codex exec が止まる(Git でないフォルダ)
K19 「Reading additional input from stdin...」が出る・codex exec の結果をファイルに残す(-o・--json)
K20 「error: unexpected argument '--full-auto' found」と出る(--full-auto は削除された)・codex exec の終了コードの見方
K21 Codex の MCP サーバーが起動しない・時間切れになる(codex mcp add・startup_timeout_sec)
K22 「is not supported when using Codex with a ChatGPT account」と出る(モデル名の間違い・利用上限・プラン)
K23 Codex の画像で日本語の文字が崩れる・「Selected model is at capacity」で 1 枚だけ落ちる
K24 「If a chat appears stuck」(Codex が止まって見える)・ログの場所と環境変数の絞り方
L. 自動運用で実際に起きたこと(10)
L01 「要確認: 公開してよいか」で自動実行が止まり続けた(依頼文の禁止)
L02 決定ログを上から読むと、古い答えに先に当たった
L03 見張りが午前3時に止まった・予約タスクが手動の公開とぶつかった
L04 Gumroad は 1 日 10 件まで・KDP は週の冊数の上限(Title creation limit reached)
L05 reCAPTCHA・受け取り方法の登録・メール認証で自動操作が止まる
L06 note の下書きが socket hang up・ECONNRESET で落ちた・公開がタイムアウトした
L07 「有料ラインが見つからない」・公開後の検査が誤検知した
L08 画面なしの Edge で、ポートの取り合い・前の画面が残る・クリックが効かない
L09 ロボット確認(/punish)・ログイン切れ(401)で自動操作が止まる
L10 *.sync-conflict-* ができた・CSV の追記で行が一時消えた
無料で全文を読める6項目
よくある症状から6つを選んで、中身を全文載せます。有料部分の項目も、この形(症状・原因・直し方・確かめ方・確かさ)で書いてあります。
A01 「'claude' is not recognized」「command not found: claude」で claude が動かない(PATH の設定)
症状
'claude' is not recognized as an internal or external command
claude : The term 'claude' is not recognized as the name of a cmdlet
Native installation exists but C:\Users\you\.local\bin is not in your PATH.インストールの後で新しく開いたターミナルに claude と打つと出ます。1 行目は CMD、2 行目は PowerShell の表示です。3 行目はインストーラーが出す注意です。
原因
公式ドキュメントによると、Windows のネイティブ版は %USERPROFILE%\.local\bin\claude.exe に置かれます。この場所が PATH に入っていないと、どのフォルダで打っても claude は見つかりません。ファイルはあるのに見つからないなら PATH の問題で、ファイルが無いならネイティブ版が入っていません。
直し方
PowerShell で、claude.exe があるかを確かめます。
Test-Path "$env:USERPROFILE\.local\bin\claude.exe"2)結果が True なら、ユーザーの PATH に %USERPROFILE%\.local\bin を足します。
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')3)ターミナルを開き直します。VS Code などエディタの中のターミナルは PATH をエディタから受け継ぐので、エディタを閉じて開き直します。
4)結果が False なら、ネイティブ版が無いので、インストールのやり方を選び直します(A02 を見てください)。
確かめ方
claude --version版の番号が表示されれば、PATH は通っています。where.exe claude で見つかったファイルの場所も確かめられます。INFO: Could not find files for the given pattern(s). と出たら、PATH に claude がありません。CMD で PATH を見るなら echo %PATH% | findstr /i "local\bin" を使います。
確かさ: 【公式ドキュメントの記載】2026年10月18日に確認
出典: https://code.claude.com/docs/en/troubleshoot-install#verify-your-path
D04 「running scripts is disabled on this system」で claude が動かない(PowerShell の実行ポリシー)
症状
File C:\Users\<ユーザー>\AppData\Roaming\npm\claude.ps1 cannot be loaded because running scripts is disabled on this system. For more information, see about_Execution_Policies at https:/go.microsoft.com/fwlink/?LinkID=135170.npm で入れた Claude Code を、PowerShell で claude と打ったときに出ます。私の試験では、実行ポリシーが Restricted のときに出ました。npm を打ったときは、npm.ps1 の名前で同じ文が出ます。
原因
npm が作る claude.ps1 と npm.ps1 は PowerShell のスクリプトです。実行ポリシーが Restricted だと、スクリプトは実行されずに止まります。ネイティブ版(irm | iex で入れたもの)はスクリプトファイルではないので、影響を受けません。同じフォルダにある claude.cmd と npm.cmd は、実行ポリシーの対象外です(公式の記載)。会社の PC でグループポリシーが実行ポリシーを決めているときは、ユーザーの設定を変えても直らないことがあります(公式の説明では、プロセス単位の回避もグループポリシーは上書きしません)。
直し方
PowerShell で、現在のユーザーだけ RemoteSigned にします。これは、そのユーザーがローカルで作ったスクリプトを許可する設定です(公式の記載)。
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser2)実行ポリシーを変えたくないなら、claude.cmd を呼びます。
3)npm を使わず、PowerShell のインストーラーで入れ直す方法もあります(公式の記載)。
irm https://claude.ai/install.ps1 | iex確かめ方
Get-ExecutionPolicy -ListCurrentUser の行が RemoteSigned になっていれば、設定は入っています。そのあと claude --version で版の番号が出れば、起動できています。
確かさ: 【実機で再現】Windows 11・Claude Code 2.1.301・2026年10月18日(文言と、RemoteSigned による直し方。公式ドキュメントの記載とも同じ内容)
出典: https://code.claude.com/docs/en/troubleshoot-install#running-scripts-is-disabled-on-this-system
B04 「This organization has been disabled」と出る(古い ANTHROPIC_API_KEY が上書きしている)
症状
API Error: 400 ... "This organization has been disabled"
Your ANTHROPIC_API_KEY belongs to a disabled organization · Unset the environment variable to use your subscription insteadサブスクリプションでログインしているのに、このエラーになります。
原因
公式ドキュメントによると、ANTHROPIC_API_KEY の環境変数が残っていると、サブスクリプションでログインしていても、そのキーが優先されます(対話モードでは一度承認したあと、-p ではキーがあれば常に、そのキーが使われます)。前の職場やプロジェクトの古いキーが、PowerShell の設定やユーザーの環境変数に残っていることが多いと書かれています。同じ原因で Credit balance is too low が出ることもある、と公式の要約にあります。
直し方
PowerShell で次を実行して、この画面からキーを外します。
Remove-Item Env:ANTHROPIC_API_KEY
claude2)次に開いたときも出るなら、PowerShell のプロファイル($PROFILE)と、Windows のユーザー環境変数の ANTHROPIC_API_KEY からも消します。
3)/status を開いて、どの認証方法が使われているかを見ます。
確かめ方
Get-ChildItem Env:ANTHROPIC* を実行して、ANTHROPIC_API_KEY が出なければ、この PowerShell には残っていません。/status の認証方法がまだキーのままなら、消し忘れた場所があるということです。
確かさ: 【公式ドキュメントの記載】2026年10月18日に確認(Credit balance の文は要約)
出典: https://code.claude.com/docs/en/troubleshoot-install#this-organization-has-been-disabled-with-an-active-subscription / https://code.claude.com/docs/en/errors
D09 「UnicodeEncodeError: 'cp932' codec can't encode character」で止まる・パイプやファイルへの print
症状
UnicodeEncodeError: 'cp932' codec can't encode character '\u2705' in position 5: illegal multibyte sequenceprint('done ✅') の結果をパイプかファイルに出したときに出ます。終了コードは 1 でした(私の試験)。
原因
この PC では、Python の既定の文字コード(locale.getpreferredencoding())が cp932 でした(sys.getdefaultencoding() は utf-8)。パイプやファイルに出すとき、出力が cp932 になり、cp932 にない ✅ を書けずに止まります。日本語は cp932 のバイトで出るため、UTF-8 として読む側では化けます。
直し方
PowerShell の窓だけで直すなら、Python を起動する前に次を実行します。
$env:PYTHONUTF8 = "1"2)ずっと有効にするなら、次を実行してから、新しいターミナルを開きます(D11 と同じ仕方です)。
[Environment]::SetEnvironmentVariable("PYTHONUTF8", "1", "User")3)1 つのスクリプトだけ直すなら、python -X utf8 で起動します。
確かめ方
まず $env:PYTHONIOENCODING を見ます。値が入っていると、この症状は出にくくなります。Claude Code の PowerShell ツールの中では、この変数に utf-8:surrogateescape が入っていました(この記事を作った PC で確認)。そのため、Claude Code から実行した Python では症状が出ず、普通の PowerShell の窓で初めて出ることがあります。普通の窓で次を実行し、$LASTEXITCODE が 0 なら通っています。
$env:PYTHONUTF8 = "1"
python -c "print('done ✅')" | Out-Null
$LASTEXITCODE確かさ: 【実機で再現】Windows 11・Python 3.14・2026年10月18日(症状と終了コード 1)。PYTHONUTF8=1 で日本語の出力が直ったことは、フックの試験でも確かめています
J01 「You've hit your session limit」で止まる(プランの使用量の枠を使い切った)
症状
You've hit your session limit · resets 3:45pmプランの使用量の枠を使い切ると、表示されたリセット時刻まで依頼が送れなくなります。週の枠なら You've hit your weekly limit、モデル別の枠なら You've hit your Opus limit のように、表示の語が変わります。
原因
公式の説明を要約すると、プランのローリングの使用量の枠を使い切ったため、表示された時刻まで依頼が止められています。セッションの枠と週の枠は、どのモデルを選んでも共通です。そのため、モデルを切り替えても枠は増えません。Opus と Sonnet の枠は、その系統のモデルにだけ効きます。
直し方
表示されたリセット時刻まで待ちます。対話の画面では、リセット後に自動で続けさせることもできます(J03 を見る)。
/usage で、各枠の残りとリセット時刻を見ます。
Opus か Sonnet の枠だけに当たっているなら、/model でその系統以外のモデルに変えます。セッションと週の枠は共通なので、これでは直りません。
Pro・Max なら、/usage-credits で追加の分を買えます(お金がかかります)。Team・Enterprise は管理者に頼みます。
確かめ方
リセット時刻を過ぎてから /usage を開き、枠の表示が戻っていることを見ます。そのあとに短い依頼を 1 つ送って、返事が来れば直っています。
確かさ: 【公式ドキュメントの記載】2026年10月18日に確認
出典: https://code.claude.com/docs/en/errors / https://support.claude.com/en/articles/11145838-using-claude-code-with-your-pro-or-max-plan
E06 CLAUDE.md が読まれない(場所・CLAUDE.md.txt・/context で確かめる)
症状
エラーは出ません。CLAUDE.md の内容が、Claude の答えに反映されません。
原因
公式によると、作業フォルダと、その上の各フォルダにある CLAUDE.md と CLAUDE.local.md は起動時に読まれます。サブフォルダの CLAUDE.md は、そのフォルダのファイルを扱うときに読まれます。--add-dir の先は、既定では読まれません。
私の試験では、親フォルダの CLAUDE.md を子フォルダで起動しても読まれ、.claude/CLAUDE.md も読まれました。小文字の claude.md も読まれました(Mac・Linux は未確認)。CLAUDE.md.txt は読まれませんでした。
直し方
拡張子が付いていないか、次で名前を見ます。
dir CLAUDE*2)名前が CLAUDE.md.txt なら、CLAUDE.md に直します。
3)セッションで /context を開き、「Memory files」に CLAUDE.md が出ているかを見ます。出ていなければ、Claude からも見えていません。
確かめ方
CLAUDE.md に合言葉を書き、ツールを全部切って 1 ターンで聞きます。ツールが使えると、Claude がフォルダを探して答えてしまうことがあります。読まれていなければ、私の試験では UNKNOWN と答えました。
確かさ: 【実機で再現】Windows 11・Claude Code 2.1.301・2026年10月18日(親フォルダ・.claude/CLAUDE.md・CLAUDE.md.txt)。サブフォルダと /context は【公式ドキュメントの記載】2026年10月18日に確認
出典: https://code.claude.com/docs/en/memory
動作確認について(正直に)
実際に動かして確かめたもの
環境:Windows 11・Windows PowerShell 5.1・Python 3.14(一部 3.12)・Git for Windows 2.55・Node v24・Claude Code 2.1.301・Codex CLI 0.162.0-alpha.17.2(ChatGPT サインイン)。確かめた日は 2026年10月18日
設定ファイル・CLAUDE.md・スキル・サブエージェント・MCP・フック・claude -p の終了コードとエラー文・PowerShell 5.1 と Python の文字コード・タスクスケジューラ・codex exec のエラー文と出力の形。項目の「確かさ」に 【実機で再現】 と書いたものです
M1〜M6 のスクリプトは、すべて動かして確かめました(記録は M の章に書いてあります)。claude -p を使う試験は、Haiku で1回 約 0.002 ドルでした
公式ドキュメントの記載だけが根拠のもの
インストール・ログイン・通信・使用量・Codex の設定の大部分です。2026年10月18日に公式ドキュメントを読んで書き、項目に出典の URL を付けました。下調べは、小さなモデルの要約を通して読んだものもあったので、公開の前に別の検証をしました。公式を根拠にした記述を、公式ページの原文と1項目ずつ照らし合わせ(139項目)、保存先の間違い・存在しない続きの行・引用符の中の文が原文に無い・条件の抜けなど、53項目の食い違いを直しています。それでも、版が上がると公式の文言は変わります。エラー文を貼り付けて探すときは、出典の URL のページと照らしてください
確かめていないもの
Mac・Linux、WSL2 の中での動き。私の環境は Windows 11 です
会社のプロキシ・グループポリシー・セキュリティソフトが絡む項目の再現(公式の記載で書いています)
対話の画面でしか出ない表示の多く(/doctor・/status の画面など)。claude -p(画面なしの実行)で確かめたものが中心です
Claude Code や Codex の古い版・新しい版。オプションの名前や挙動は、版で変わることがあります。動かないときは claude --help、公式ドキュメント、M1 で確かめてください
実物の出どころ
この記事の中身は、私が実際に運用している作業場(複数のプロジェクトを1か所にまとめ、依頼を書くと裏で Claude Code が動く仕組み)で起きたことと、この記事のために行った試験から取り出して、一般化したものです。失敗の記録は、決定ログと作業の記録から書きました。個人の情報(メールアドレス・アカウント名・パスワード・個人のパス)は、載せていません。パスは C:\Users\<ユーザー>\… のように書き換えてあります。
向いている人・向いていない人
向いている人
Claude Code や Codex を Windows で使っていて、エラーや「動かない」で止まった人
自動実行(claude -p・codex exec・タスクスケジューラ)を始めたい、または始めたが成功か失敗かが分かりにくい人
設定ファイルやスクリプトを、自分用に直せる人(深い経験は要りません。Claude Code に直させることもできます)
向いていない人
Claude Code・Codex を、まだ一度も入れていない人。先に、無料の入門記事(下にリンクがあります)で、インストールと最初の依頼までを済ませてください
「これを買えば、確実に直る」を探している人。この記事は、直ることを保証しません。版・環境・会社の設定で、結果は変わります。確かめていないことは、確かめていないと書いてあります
エラーが出ていなくて、読み物としてだけ読みたい人
使い方
困ったら、まず「最初の3分」を6つ見る
エラー文の一部、または症状の言葉を「全目次」から探して、番号(例:G04)でこの記事の中を検索する
その項目の「直し方」を上から行い、「確かめ方」で直ったかを見る
原因が分からないときは、M1(環境の診断)と M2(設定ファイルの検査)を動かす
自動実行を始めるときは、M5・M6 の道具から入る
前提の環境は、上の「動作確認」のとおりです。公式ドキュメントを読んだ日は 2026年10月18日です。
先に読んでおくと役に立つ無料記事
Claude Codeの使い方・始め方入門:インストールから最初の依頼まで
Codexの使い方・始め方入門:Codex を入れて最初の依頼まで
ターミナルの使い方:PowerShell の開き方と最低限のコマンド
MCPとは?Claude Codeにつなぐ方法:H の章の基本
Claude Codeのフック(hooks)の使い方:G の章の基本
Claude Codeの権限設定(パーミッション):F の章の基本
Claude Codeを自動実行する方法:I の章の基本
Codexの承認モードとサンドボックスの設定:K の章の基本
Claude Codeの使用量を確認する方法:J の章の基本
メンバーシップ まさのAI実務ラボ|Codex・Claude Code に入ると、この記事を含む有料記事を、まとめて読めます。新しい記事が出たときに届くよう、このアカウントのフォローもどうぞ。
ここから先が、有料の本編です。A の章(入れる・見つからない・更新)から始まり、最後の M の章(スクリプト6本)で終わります。