OpenCode error
OpenCode: Error: The socket connection was closed unexpectedly
Error: The socket connection was closed unexpectedly. For more information, pass `verbose: true` in the second argument to fetch()Status: Fixed in releaseLast verified 2 documented fixes2 sources
What it means
The connection to the model provider dropped during a request. A maintainer: "This issue is from the provider dropping connection".
Causes
- The provider's server closed the connection. A maintainer: "this error is when the server closes the connection on us which we dont automatically retry" (#1692, before the fix).
How to fix it
- Fix 1.
Upgrade. v1.0.194 made "The socket connection was closed unexpectedly" errors retryable. A maintainer: "I added retries for this error last night".
Terminalopencode upgrade - Fix 2.
Before the fix, a maintainer's workaround was to send a follow-up message such as "continue".
More OpenCode errors
All 17 OpenCode errorsProviderModelNotFoundErrorStatus: By designProviderInitErrorStatus: WorkaroundAI_APICallErrorStatus: WorkaroundThis credential is only authorized for use with Claude Code and cannot be used for other API requests.Status: By designAI_APICallError: messages.13: `tool_use` ids were found without `tool_result` blocks immediately after: toolu_01CfJCsh21fK1pAXsXWYJYBA, toolu_01NoqnwsaxoK3AYM2FyrxmjN. Each `tool_use` block must have a corresponding `tool_result` block in the next message.Status: Fixed in releasemessages.3.content.0.type: Expected `thinking` or `redacted_thinking`, but found `tool_use`. When `thinking` is enabled, a final `assistant` message must start with a thinking block (preceeding the lastmost set of `tool_use` and `tool_result` blocks). We recommend you include thinking blocks from previous turns. To avoid this requirement, disable `thinking`.Status: WorkaroundError: Unexpected error, check log file at [user-home]/.local/share/opencode/log/2025-08-26T215857.log for more detailsStatus: WorkaroundAI_RetryError: Failed after 4 attempts. Last error: Too Many RequestsStatus: Workaround
Related reading
- OpenCode Hacked: What the Console Breach Means for Your API KeysOpenCode disclosed a breach of its Console that may have exposed provider keys. Who is affected, what to rotate today, and why hosted key gateways are the real risk.
- OpenCode 2: How to Upgrade From v1 Without Breaking Your SetupOpenCode 2 upgrade from v1: what the migration guide says breaks (plugins, server API, TUI config), what carries over, and a safe checklist before you switch.
- Run Your Coding Agent as an API: OpenCode Server on RailwayOpenCode server on Railway: run opencode serve in a container as a password-protected HTTP API with a persistent volume, reachable from any machine or webhook.
- Give Every Agent PR a Live Preview: Railway Environments for AI Pull RequestsRailway preview environments for agent pull requests: an isolated copy of your whole stack for every PR, so you verify agent changes by running them.
- GPT-6 Astra Release Guide: Benchmarks, $10/$50 Pricing, and How to Run It in Codex and OpenCodeGPT-6 Astra release guide: OpenAI's max-capability model, its $10/$50 pricing and 1.05M context, what the benchmarks do and do not say, and commands to try it.
- Put an AI Reviewer on Every Pull Request: A Webhook Build with OpenCode and RailwayBuild an AI pull request reviewer on Railway: a webhook service runs OpenCode headless on every PR diff and posts findings as a review, never touching the code.
FAQ
What does "Error: The socket connection was closed unexpectedly" mean in OpenCode?
The connection to the model provider dropped during a request. A maintainer: "This issue is from the provider dropping connection".
How do I fix "Error: The socket connection was closed unexpectedly"?
There are 2 documented fixes. Start with the first: Upgrade. v1.0.194 made "The socket connection was closed unexpectedly" errors retryable. A maintainer: "I added retries for this error last night".
Is this OpenCode error fixed?
Status: Fixed in release. A release fixed this. The affected versions note says where the fix landed. Affected versions: Reported from Aug 2025. Retries added in v1.0.194 (2025-12-24).
Sources
Last verified against 2 sources: official docs, maintainer replies and release notes.
Newsletter
Fixes for the tools you use, weekly
One email per week. New coding agent releases, what broke, and how developers are working around it.