Author

claudehowto

Unable to connect to API (ConnectionRefused) が出るときにまず見ること

この症状は、Claude Code が API への接続に失敗したときに出ています。今回の材料の中では、同じ文言が出ている issue は 2 件あり、Windows の報告 #71485 と、macOS の報告 #75897 です。どちらも「接続できない」こと自体は共通していますが、切り分けの材料は少し違います。

最初に見るべきなのは、Claude Code 以外では API に届いているかどうかです。#71485 では、claude auth status はログイン済みで、api.anthropic.com:443 への TCP テストも成功しています。さらに HTTPS は HTTP 401 まで返っており、少なくともネットワーク経路そのものが完全に死んでいるわけではありません。加えて、WSL 上の Ubuntu では Claude Code が正常に動いていて、VSCode 拡張も WSL のプロジェクトでは問題ありませんでした。なので、この報告だけを見る限り、Windows 側の Claude Code だけが詰まっているように見えます。

その Windows 事例では、再インストールしても、v2.1.150 に下げても同じエラーでした。NODE_TLS_REJECT_UNAUTHORIZED=0 を試すと、今度は Execution error が即座に出ています。これは回避策として成立しなかった、という事実だけが分かります。少なくとも、この issue からは「TLS 証明書検証を弱めれば直る」とは読めません。

macOS 側の #75897 は、毎回 Unable to connect to API (ConnectionRefused) になり、無限リトライに入るという報告です。再インストール、safe-mode、再起動でも残っています。コメントでは「ターミナルの Claude Code だけが壊れている」「203 に戻してもだめだった」という追記があり、別 issue への確認依頼も出ています。ただし、この時点で確定した解決策は本文からは確認できませんでした。

手元で確認できる実測値としては、検証環境の Node.js は次の通りです。

$ node --version
v16.15.0

ここから言えるのは、少なくとも今回の材料だけでは、ConnectionRefused の原因を 1 つに絞れないことです。Windows の報告ではネットワーク疎通は部分的に確認できていて、WSL では同じ系統のツールが動いています。一方で macOS の報告は再インストールや再起動でも残っています。つまり、単純な「通信断」ではなく、Claude Code 側の実行環境か、ランタイム層のどこかで止まっている可能性が高そうですが、現時点では断定できません。

同じ症状に当たったら、まずは Claude Code 以外で api.anthropic.com:443 に届くか、別の環境では動くかを見てください。そこが通っているなら、ネットワーク全体ではなく、その実行環境の Claude Code に問題が閉じている可能性があります。逆に、どこでも同じなら、アカウントやローカル環境より前の段階を疑う必要があります。ただし、どの確認が決定打になるかは、この 2 件だけではまだ分かりません。

検証環境

OS          : Linux 3.10.0-1160.76.1.el7.x86_64 (x86_64)
Python      : 3.8.13
検証日時    : 2026-09-02T08:50:51+09:00

参照した Issue（anthropics/claude-code）: #75897, #71485

同じ著者の記事

TelemetrySafeError: VirtualMessageList: itemKeys/messages le で始まる desync は、いま報告されている同型の症状です

この症状は、`TelemetrySafeError: VirtualMessageList: itemKeys/messages length desync` を含むエラーとして、少なくとも 2 件の issue に出ています。報告された環境はいずれも Windows で、Claude Code の Version は `2.1.257` でした。現時点で解決済みの issue は 0 件です。 まず、自分のケースかどうかを見分けるなら、エラー文字列がほぼそのまま一致するかを確認するのがいちばん早いです。報告内容では、`keys=115 messages=114 range=[58,115)` と `keys=370 messages=369 range=[328,370)` のように、`keys` と `messages` の件数が 1 ずれていました。つまり、見えているのは「メッセージ一覧の内部整合性が崩れた」タイプの障害で、少なくとも issue 上は入力文そのものより、表示・追跡しているメッセージ列の不整合に寄っています。 関連する報告は [#91323](https://gi

papoo.work

`Remote Control disconnected — Your terminal's Claude Code session stopped responding. Check your terminal for errors, then resend your message.` が出るときに見るところ

この症状は、少なくとも issue [#79057](https://github.com/anthropics/claude-code/issues/79057) と [#76954](https://github.com/anthropics/claude-code/issues/76954) で報告されています。 どちらも共通しているのは、Desktop 側でセッションを開き直したときに Remote Control 接続が失敗し、同じ文言のエラーが出ることです。 まず、自分のケースがこの系統かを切り分けると話が早いです。 同じ issue のコメントでは、これは cloud-sandbox の routine 実行ではなく、ローカルホストの scheduled-task session だと補足されています。つまり、セッション一覧にはアカウント単位で出てくるが、実体は最初に動いた端末側にあった、ということです。 > `Remote Control disconnected — Your terminal's Claude Code session stopped res

papoo.work

`Subprocess initialization did not complete within 60000ms — ` が出るときに見るべきこと

この症状は、少なくとも issue 報告上では、Claude Code の subprocess 起動後に初期化が 60 秒で打ち切られたときに出ています。該当する報告は [#72315](https://github.com/anthropics/claude-code/issues/72315) と [#91149](https://github.com/anthropics/claude-code/issues/91149) です。どちらもエラーメッセージは同じで、ホスト側は「authentication and network connectivity」を疑う文言を出しています。 まず切り分けたいのは、「認証やネットワークそのものが壊れている」のか、「subprocess は立ち上がるが、その後のホスト側 handoff で止まっている」のかです。後者は [#91149](https://github.com/anthropics/claude-code/issues/91149) の報告内容にかなり近く、そこでは IDE extension host から起動した Claud

papoo.work

Error: 429 {"type":"error","error":{"type":"rate_limit_error","message":"Rate limited"} で止まる Claude Code の 429

この症状は、GitHub Issue 上では少なくとも [#71635](https://github.com/anthropics/claude-code/issues/71635) と [#71504](https://github.com/anthropics/claude-code/issues/71504) で報告されています。どちらも、`API Error: Server is temporarily limiting requests (not your usage limit) · Rate limited` という説明と、同じ 429 系のエラー文字列が付いていました。報告内容だけを見る限り、利用者側の使用量上限ではなく、サーバー側の一時的な制限として扱われています。 実際の報告では、次のように出ています。 ```text 報告されたエラー: Error: 429 {"type":"error","error":{"type":"rate_limit_error","message":"Rate limited"},"request_id":"req_011CcQs8

papoo.work

Claude Code で `HTTP 500` が返るときに見えていること

まず切り分けると、この症状は少なくとも 2 件の報告で同じ文言が出ています。ひとつは VS Code 拡張で Claude Code を使っているときに、もうひとつはターミナルからのリクエストで、どちらも `500 Internal server error` です。報告内容だけを見る限り、特定のファイル操作に限られた失敗ではなく、Claude Code への要求そのものが通らない状態に見えます。 該当する issue は [#70336](https://github.com/anthropics/claude-code/issues/70336) と [#59784](https://github.com/anthropics/claude-code/issues/59784) です。 ```text API Error: 500 Internal server error. This is a server-side issue, usually temporary — try again in a moment. If it persists, check https://st

papoo.work

`Improved the Read tool to return a truncated first page with` が見えても、読み方によってはまだ落ちる

まず切り分けたいのは、`Read` が「全部読む」ときに途中まで返してくるケースなのか、`offset` や `limit` を指定したケースなのかです。今回の issue 群は同じ症状クラスタですが、挙動が少し違います。 ```text File content (84502 tokens) exceeds maximum allowed tokens (25000). Use offset and limit parameters to read specific portions of the file, or search for specific content instead of reading the whole file. ``` ここで引っかかるのは、文面だけ見ると「offset と limit を使え」と言われているのに、まさにその `offset` / `limit` 指定で失敗している点です。issue の報告では、2.1.145 で導入された「whole-file read を PARTIAL view で返す」改善は、あくまで `offset` / `li

papoo.work

Error: 401 The socket connection was closed unexpectedly. Fo で止まるときにまず見るところ

この症状は、Claude Code 側の issue 報告では 2 件とも closed になっており、しかも両方が duplicate 扱いでした。参照できる報告は [#70557](https://github.com/anthropics/claude-code/issues/70557) と [#70753](https://github.com/anthropics/claude-code/issues/70753) です。 最初に切り分けたいのは、「同じ 401 系の文面が出ているだけ」なのか、それとも「本当に会話の流れを壊しているのか」です。issue #70557 では、`.172` 以降にほぼ毎日このエラーが出るという報告があり、メッセージは `Please run /login · API Error: 401 The socket connection was closed unexpectedly. For more information, pass \`verbose: true\` in the second argument to fetch()` でし

papoo.work

`Session creation failed` が出るときに見えているのは、たぶん「古い状態が残っている」こと

この症状に近いのは、Remote Control のセッション作成が失敗し、再接続や再登録をしてもすぐには直らないケースです。報告されている issue では、iOS の Claude app から Remote Control セッションを作ろうとすると `Session creation failed — see debug log` が出る一方で、ローカル側の `claude-remote@*` systemd サービスは healthy に見えていた、と書かれています。しかも、別のマシンから新しく Remote Control セッションを登録すると、影響を受けていた環境全体で復旧したそうです。これは [#57715](https://github.com/anthropics/claude-code/issues/57715) にある報告です。 別の報告では、macOS で `claude --remote-control ketobaza` を開始したあとに Remote Control が切断され、`Session creation failed` が出たとされています。

papoo.work

The model's tool call could not be parsed (retry also failed) が出るときに見えていたこと

まず、自分のケースかどうかを切り分けるなら、実行中にこの文言で止まるかを見ます。 > `The model's tool call could not be parsed (retry also failed)` 今回の症状クラスタで参照できる issue は、どちらも Claude Code 側で tool call の構造が壊れていたケースでした。[#62467](https://github.com/anthropics/claude-code/issues/62467) では、`claude-opus-4-7` と extended thinking の組み合わせで、`tool_use` ブロックが parse できずに hard-stop していたと報告されています。[#74620](https://github.com/anthropics/claude-code/issues/74620) では、Opus 4.8 の tool call で、開始タグが `court` や `call`、`count`、`caught`、`co` のような近い文字列に崩れ、harness

papoo.work

exit code 143 が出る Claude Code の切り分けメモ

まず、手元の症状がこのクラスタに当てはまるかを見るなら、出方がかなり重要です。issue #62985 では、デスクトップアプリのサイドバーでセッションを切り替えただけで、動作中の `claude` プロセスが SIGTERM で止まり、`exit code 143` になっています。`Session was interrupted` の表示が出て、実行中の agent や tool call、応答途中の処理が止まる、という報告です。参照元は [#62985](https://github.com/anthropics/claude-code/issues/62985) です。 もう一つの [#62202](https://github.com/anthropics/claude-code/issues/62202) は、Desktop app と VS Code extension でだけ、ちょうど 300 秒ごとに `exit code 143` で落ちるという報告です。terminal CLI の `claude` では起きず、ラッパー側に限って再現している、と書かれています。こ

papoo.work