Skip to content

Add VPN disconnection hint to free-tier and rate limit error messages #56474

Closed

Description

@JayadityaGit

Description

When using OpenCode free models through a VPN or proxy, requests commonly fail with:

  1. \Error: OpenCode's free tier can only be used from within OpenCode. Download it at https://opencode.ai and keep building.\
  2. \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.\

OpenCode version

2.0.32

Operating System

Windows 11

Activity

  1. opencode-agent commented on Oct 17, 2026

    @opencode-agent
    Contributor

    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:

  2. Tarquinen commented on Oct 20, 2026

    @Tarquinen
    Member

    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 𝕺𝖕𝖊𝖓𝕮𝖔𝖉𝖊

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions