メインコンテンツへスキップ
見出し画像

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つを順に見てください。どれも読むだけで、何も変えません。

    1. claude はどこの何版が呼ばれているか。 where.exe claude と claude --version。複数あって版が違うと、新しいオプションが unknown option になります → A01・A10。M1 が全部を並べます

    2. ログインしているか。環境変数のキーが上書きしていないか。 ANTHROPIC_API_KEY が残っていると、ログインよりそのキーが優先されます → B04・B06

    3. 設定ファイルは正しい JSON か。 末尾のカンマ1つで、claude -p は設定を丸ごと無視します。エラーも出ません → E01。M2 が検査します

    4. Windows なら、実行ポリシーと文字コード。 running scripts is disabled → D04。日本語が ?????・縺… に化ける → D07〜D10

    5. フックなら、止まらないのか、止まりすぎるのか。 exit 1 は止まらず、exit 2 は止まります。パスの \ が消えると、Python は終了コード 2 で終わり、Bash が全部止まります → G01・G04・G06

    6. 自動実行なら、終了コードだけで成功と決めない。 許可が足りずに飛ばされたツールがあっても、終了コードは 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 の問題で、ファイルが無いならネイティブ版が入っていません。

    直し方

    1. 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 でグループポリシーが実行ポリシーを決めているときは、ユーザーの設定を変えても直らないことがあります(公式の説明では、プロセス単位の回避もグループポリシーは上書きしません)。

    直し方

    1. PowerShell で、現在のユーザーだけ RemoteSigned にします。これは、そのユーザーがローカルで作ったスクリプトを許可する設定です(公式の記載)。

    Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

    2)実行ポリシーを変えたくないなら、claude.cmd を呼びます。
    3)npm を使わず、PowerShell のインストーラーで入れ直す方法もあります(公式の記載)。

    irm https://claude.ai/install.ps1 | iex

    確かめ方

    Get-ExecutionPolicy -List

    CurrentUser の行が 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 が出ることもある、と公式の要約にあります。

    直し方

    1. PowerShell で次を実行して、この画面からキーを外します。

    Remove-Item Env:ANTHROPIC_API_KEY
    claude

    2)次に開いたときも出るなら、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 sequence

    print('done ✅') の結果をパイプかファイルに出したときに出ます。終了コードは 1 でした(私の試験)。

    原因
    この PC では、Python の既定の文字コード(locale.getpreferredencoding())が cp932 でした(sys.getdefaultencoding() は utf-8)。パイプやファイルに出すとき、出力が cp932 になり、cp932 にない ✅ を書けずに止まります。日本語は cp932 のバイトで出るため、UTF-8 として読む側では化けます。

    直し方

    1. 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 の枠は、その系統のモデルにだけ効きます。

    直し方

    1. 表示されたリセット時刻まで待ちます。対話の画面では、リセット後に自動で続けさせることもできます(J03 を見る)。

    2. /usage で、各枠の残りとリセット時刻を見ます。

    3. Opus か Sonnet の枠だけに当たっているなら、/model でその系統以外のモデルに変えます。セッションと週の枠は共通なので、これでは直りません。

    4. 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 は読まれませんでした。

    直し方

    1. 拡張子が付いていないか、次で名前を見ます。

    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 を、まだ一度も入れていない人。先に、無料の入門記事(下にリンクがあります)で、インストールと最初の依頼までを済ませてください

    • 「これを買えば、確実に直る」を探している人。この記事は、直ることを保証しません。版・環境・会社の設定で、結果は変わります。確かめていないことは、確かめていないと書いてあります

    • エラーが出ていなくて、読み物としてだけ読みたい人

    使い方

    1. 困ったら、まず「最初の3分」を6つ見る

    2. エラー文の一部、または症状の言葉を「全目次」から探して、番号(例:G04)でこの記事の中を検索する

    3. その項目の「直し方」を上から行い、「確かめ方」で直ったかを見る

    4. 原因が分からないときは、M1(環境の診断)と M2(設定ファイルの検査)を動かす

    5. 自動実行を始めるときは、M5・M6 の道具から入る

    前提の環境は、上の「動作確認」のとおりです。公式ドキュメントを読んだ日は 2026年10月18日です。

    先に読んでおくと役に立つ無料記事

    メンバーシップ まさのAI実務ラボ|Codex・Claude Code に入ると、この記事を含む有料記事を、まとめて読めます。新しい記事が出たときに届くよう、このアカウントのフォローもどうぞ。

    ここから先が、有料の本編です。A の章(入れる・見つからない・更新)から始まり、最後の M の章(スクリプト6本)で終わります。

    あなたへのおすすめ