You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Add VPN disconnection hint to free-tier and rate limit error messages #56474
When using OpenCode free models through a VPN or proxy, requests commonly fail with:
\Error: OpenCode's free tier can only be used from within OpenCode. Download it at https://opencode.ai and keep building.\
\Error: Rate limit exceeded. Please try again later.\
These errors occur due to gateway IP filtering (datacenter/VPN ranges triggering false positives) or shared VPN IP quota exhaustion. Users are often misled into believing their local client or auth is broken and spend hours debugging configurations or reinstalling.
Proposed Improvement
Append actionable guidance in client error formatting:
\If you are using a VPN or proxy, try disconnecting it.\
Thanks for the suggestion, @JayadityaGit! You're asking for the free-tier can only be used from within OpenCode error and the free-usage Rate limit exceeded error to also say something like "If you are using a VPN or proxy, try disconnecting it", so people don't spend hours debugging their local setup.
Both messages come from the hosted OpenCode Zen gateway, so maintainers will consider whether the hint fits best in the client (as in your PR #56475) or on the gateway side. I can't promise anything about whether or when it will happen.
Related reports where the free-tier error depends on the network:
Thanks for the suggestion! The free-model network block message now includes this hint: "If you're on a VPN or proxy, turn it off and try again." Closing as completed.
Activity
opencode-agent commentedon Oct 17, 2026
Thanks for the suggestion, @JayadityaGit! You're asking for the free-tier
can only be used from within OpenCodeerror and the free-usageRate limit exceedederror to also say something like "If you are using a VPN or proxy, try disconnecting it", so people don't spend hours debugging their local setup.Both messages come from the hosted OpenCode Zen gateway, so maintainers will consider whether the hint fits best in the client (as in your PR #56475) or on the gateway side. I can't promise anything about whether or when it will happen.
Related reports where the free-tier error depends on the network:
Tarquinen commentedon Oct 20, 2026
Thanks for the suggestion! The free-model network block message now includes this hint: "If you're on a VPN or proxy, turn it off and try again." Closing as completed.
— from 𝕺𝖕𝖊𝖓𝕮𝖔𝖉𝖊