Skip to content

Free tier issues: read this first, then post your report here #59387

Open

Description

@neriousy

This is the main issue for free tier problems. If you see any of these, you're in the right place:

  • Free usage exceeded, subscribe to Go
  • Free usage limit reached
  • You've used today's free messages. They reset at ... and the reset never happens
  • This version of OpenCode Desktop no longer supports free models
  • OpenCode's free tier can only be used from within OpenCode
  • OpenCode 1.18.0 or newer is required to use the free tier

Please comment here instead of opening a new issue. We're closing duplicates and pointing them here so everything is in one place.

1. Make sure you're on the latest OpenCode v2

Most free tier reports come from OpenCode v1 (versions 0.x and 1.x, for example Desktop or CLI 1.19.5). v1 no longer supports free models and only gets fixes for critical bugs. Updating to v2 has fixed this for many people.

Check your version:

  • Terminal: opencode --version
  • Desktop: Settings → About

The latest v2 release is 2.2.1.

Important

The v1 Desktop app's built-in updater keeps you on 1.x. Download v2 manually from https://opencode.ai/v2/docs.

Desktop

Download v2 Desktop for macOS, Windows or Linux from https://opencode.ai/v2/docs, or on macOS:

brew install --cask opencode-desktop

Terminal (TUI / CLI)

All install options are listed at https://opencode.ai/v2/docs. The quickest on macOS and Linux:

curl -fsSL https://opencode.ai/v2/install | bash

Or use a package manager:

npm install -g @opencode/cli
bun install -g --trust @opencode/cli
brew install anomalyco/tap/opencode-v2
paru -S opencode-beta

v1 and v2 both use the opencode command. If you installed v1 with a package manager, remove it first, for example npm uninstall -g opencode-ai. Windows package managers (Chocolatey, Scoop) don't support v2. On Windows, use the Desktop app, npm, or a standalone binary.

Useful docs

2. Other things to check

  • Free models only work inside OpenCode. Other clients, proxies and direct API calls can't use them. Use a paid model or Go there instead.
  • Subscribed to Go but still seeing free limits? Run /connect, sign in with OpenCode Console in your browser (make sure you authorize the workspace with your Go subscription, or choose OpenCode Go if you use a Go API key), then pick a Go model (opencode-go/...) with /models rather than a free model (opencode/...-free).
  • Hit the real daily limit? Wait for the reset time shown, subscribe to Go, or connect another provider with /connect.

3. Still broken on the latest v2? Comment with:

  • OpenCode version, and whether you use Desktop, TUI, CLI or web
  • Operating system
  • The free model you used
  • The exact error message (a screenshot is fine)
  • When it started and the reset time you were shown
  • Whether you have Go or Console credits

Warning

Don't post email addresses, payment details or other account information here. This issue is public.

4. Still don't know what's going on?

If you're on the latest v2 and none of the above helps, or the problem is about your account, billing or Go subscription, email help@anoma.ly with the details from step 3. Billing and account issues can't be fixed in GitHub issues.

Activity

  1. pinned this issue on Oct 26, 2026
  2. opencode-agent commented on Oct 26, 2026

    @opencode-agent
    Contributor

    Thanks for setting up this thread. Every problem listed here is decided by the hosted free tier service: usage limits, reset times, version checks and blocks on clients other than OpenCode. Reproducing any of them takes a real OpenCode account calling the free models, and this automated sandbox has no access to one. So none of them were reproduced here. Each report posted in this thread will need a maintainer with account access to look at it.

  3. leostacowskicompasso commented on Oct 26, 2026

    @leostacowskicompasso

    Here is my report:

    OpenCode v2.1.4 TUI on Windows 11 Pro 25H2

    • opencode/nemotron-3.5-lightning-free
    • opencode/mimo-v2.6-flash-free
    • opencode/deepseek-v4.1-flash-free
    • opencode/big-pickle

    You've used today's free messages. They reset at 21:00.
    Upgrade to OpenCode Go → /connect · Switch model → /models

    Image Image Image Image

    Error message started on the first time I used OpenCode today (10-26-26).
    Tried with my two Zen accounts, same errors on all models I've tried so far.
    Did not use OpenCode in two full days, was working fine on friday.

    I don't have any credits. Only Zen free-tier.

    Already tried without success:

    1. Running /connect and authenticating both my Zen accounts again;
    2. Installed OpenCode Desktop for Windows and got same behavior;
    3. Restarted machine;
    4. Tried to /connect OpenCode with API Key public.

    My current setup since migrating from v1 is pretty bare-bones, no custom plugins no custom codebase.

    All of my tracked requests on Zen's Logs have inference_failed errors with 429:

    Image

    Love this tool, would greatly appreciate any feedback/workaround for this.

  4. neriousy commented on Oct 26, 2026

    @neriousy
    MemberAuthor

    @leostacowskicompasso update to v2 please!

  5. leostacowskicompasso commented on Oct 26, 2026

    @leostacowskicompasso

    5. @leostacowskicompasso update to v2 please!

    Mentioned on my report!

    OpenCode v2.1.4 TUI on Windows 11 Pro 25H2

    Screenshot:

    Image
  6. kenjaku-dev commented on Oct 26, 2026

    @kenjaku-dev
    Image

    opencode v2.1.4
    arch lunix

  7. tomatomario45-sys commented on Oct 26, 2026

    @tomatomario45-sys
    Image

    Opencode TUI v2.1.4 on Windows 11 Pro 26H2
    Deepseek V4.1 Flash Free

    This error started yesterday at 7-8pm.

    I've tried everything, but nothing worked.

    I don't have any credits, just a free zen account.

  8. micy99 commented on Oct 27, 2026

    @micy99
    Image
    1. waiting for reset time: 6:59 AM today
    2. on 7:01 AM, just typing "cek"
    3. immediately got to wait another 24 hour.

    Opencode 2.1.4 confimed.

  9. monbooo090 commented on Oct 27, 2026

    @monbooo090

    I was previously advised to use v2, as the issue where the OpenCode Console free
    tier was exhausted after just a single request had reportedly been fixed there.

    Following this instruction, I switched to v2. While it worked as expected for
    the first day, the issue unfortunately recurred the very next day. After sending
    just one request, I was blocked again with the following message:

    You've used today's free messages. They reset at 2026/10/28 9:00.

    It appears the underlying problem has not been completely resolved in v2. Could
    you please investigate the root cause and provide a permanent fix?

    Thank you for your help.

    opencode/latest/2.1.4/desktop

  10. Kapie77 commented on Oct 27, 2026

    @Kapie77

    I hit the 24-hour limit and waited for 24 hours to pass, then I sent ONE message and got the 24-hour limit message again. This happened to me TWICE.
    It seems that if, after 24 hours, I send a message in an old session, I hit the limit again instantly; I have to create a new session to avoid this bug, but then I lose all my work.
    I’ve already tried switching models (I use the free ones) and it didn’t work; I’ve already switched computers, restarted the modem, tried resetting the sent message and sending it again, and created new sessions, but nothing works.
    I use the standard free version of OpenCode (2.1.4, desktop version for Windows) and some free models.

  11. NthanLim commented on Oct 27, 2026

    @NthanLim

    i have a same problem as @Kapie77, how to resolve this problem?

    Image
  12. JackChen890311 commented on Oct 27, 2026

    @JackChen890311

    Opencode Version: 2.1.4
    OS: MacOS 27.0.1
    Model: DeepSeek v4.1 Flash Free / MiMo v2.6 Flash Free / Big-Pickle

    This starts today and I haven't sent any message yet.
    Yesterday was fine.

    Image
  13. vaibhavpandeyprayag commented on Oct 27, 2026

    @vaibhavpandeyprayag

    13. I hit the 24-hour limit and waited for 24 hours to pass, then I sent ONE message and got the 24-hour limit message again. This happened to me TWICE.
    It seems that if, after 24 hours, I send a message in an old session, I hit the limit again instantly; I have to create a new session to avoid this bug, but then I lose all my work.
    I’ve already tried switching models (I use the free ones) and it didn’t work; I’ve already switched computers, restarted the modem, tried resetting the sent message and sending it again, and created new sessions, but nothing works.
    I use the standard free version of OpenCode (2.1.4, desktop version for Windows) and some free models.

    Same thing happened with me, after 24 hours, sending single request hits the limit again (message of reset after 24 hr)

  14. bilibili-CLY commented on Oct 27, 2026

    @bilibili-CLY

    Same problem as @leostacowskicompasso :
    Opencode v2.1.4 TUI on macOs 26.2. Every Zen Free Model returns the same message. First time found out on 10-25-26 at 10pm. No credits on my account. Have tried the methods above.
    Image

  15. 488 remaining items

  16. Wkrotik commented on Nov 7, 2026

    @Wkrotik

    I have not been able to use the free tier for a weeks now, this is so frustrating

  17. LoveyGoo commented on Nov 8, 2026

    @LoveyGoo

    OpenCode Desktop version 2.2.6
    Windows 11 25H2 (OS Build 26200.9711)
    Free model: Deekpseek 4.1 Flash
    Error message : "You've used today's free messages. They reset at Nov 8, 2026, 2:45 AM"
    Error message2 : "You've used today's free messages. They reset at Nov 9, 2026, 2:05 AM"

    Image Image

    same prompt 2 limits none executed

  18. kuzeyguldal commented on Nov 8, 2026

    @kuzeyguldal

    opencode v2.2.6 on MacBook Air Tahoe v26.6.2
    opencode/GLM-5.3-Flash Free

    Image
  19. crias-solutions commented on Nov 8, 2026

    @crias-solutions

    Same issue in Codespace with Opencode v2.2.6 and different models, many days in a row.

    Image
  20. willianholtz commented on Nov 8, 2026

    @willianholtz

    This is getting annoying. Regardless of which agent I use, I keep getting the same message. I’ve tried numerous versions (git, stable, bin, etc.). Since I use Arch Linux, I generally prefer the 'git' version, but with all these issues, it’s becoming quite difficult. Even though I only use a single agent—and I’m not doing anything particularly intensive—I keep getting the "Free usage limit reached" message, and it persists even after I switch agents.

  21. Zeyadd455 commented on Nov 8, 2026

    @Zeyadd455
    Image I'm using this mode; Image windows 11

    After the reset, I use it for about 10-20min only, and the reset message shows again

    Image
  22. Ka1zex commented on Nov 8, 2026

    @Ka1zex

    с 31.10.2026 перестал работать Opencode, Постоянно пишет "исчерпан лимит", хотя я ничего не писал ему уже 2 недели. Пишет, что обновится в 3:00 следующего дня, а все равно не обновляется. Я пробовал инструкции из этого issue #59387. Помогите пожалуйста

    Plugins
    none

    OpenCode version
    v2.2.6

    Steps to reproduce
    No response

    Operating System

    Windows 11

    Terminal
    PowerShell

    Image Image
  23. alhasan-alnagem commented on Nov 8, 2026

    @alhasan-alnagem

    Ok i have done something that i think fixed this issue for me
    Background i asked big pickle to see how can i keep the browser session info persistent and i don't need to log in to the email and it to reply to the emails in my stead it said to copy the app data and rename the folder by adding the word backup to it
    And then the free tier problems started to happen
    So i did the following
    Asked it to generate a .bat file that removes all app data and uninstalls open code for me
    Went to the website and downloaded the latest Opencode version i was on 2.4 or 2.3 cant remember
    And ran the bat restarted my pc installed opencode waited for the limit to reset and continued using it

    One important thing to note
    I had a lot of compaction done every session and now i dont since all data for open code are fresh data and i stopped compacting since my use case is a website features and i just pointed it in the right direction instead of relying on the compacting that was being done at every request because I wanted it to know the stuff I had it do before implementing this feature

    I am using the desktop app
    On Windows 11 Pro

  24. awarnock3 commented on Nov 9, 2026

    @awarnock3

    Running Ubuntu 24.04 on a virtual host at DigitalOcean. I've got Opencode v2.2.6. All prompts return this:

        You've used today's free messages. They reset at 12:03 AM · 11/10/2026.                                                                                
         Upgrade to OpenCode Go → /connect · Switch model → /models                                                                                             
    

    I've tried several models - both free and paid with the same response. It does respond to '/' commands but not to anything I enter as a prompt. IIRC, it also was happening after I upgraded to v2.2.5 and I was hoping it would be fixed in v2.2.6.

  25. awarnock3 commented on Nov 9, 2026

    @awarnock3

    For comparison with my comment above, I tested v2.2.5 on a MacMini, running MacOS Golden Gate v27.0.1 with no issue. I updated it to v2.2.6 and still no problems.

  26. marked time free plan #62783 as a duplicate of this issue on Nov 9, 2026
  27. tim-mcdonald commented on Nov 9, 2026

    @tim-mcdonald

    v2.2.6 CLI/TUI, macOS 27.0.1, opencode/*-free

    First message of the day blocked since ~Oct 22, 2026: "You've used today's free messages. They reset at 5:27 PM. Upgrade to OpenCode Go → /connect · Switch model → /models"

    Last free success Sep 26, 2026. Logs show Free usage limit reached repeatedly (Nov 1, 2, 3, 4, 6, 9).

    Works on phone hotspot, blocked on home network (single household, no other users). No active Go subscription yet — interested in subscribing if Go is per-account and not IP-limited.

    Emailed help@anoma.ly with account details. Please check IP bucket for my network.

  28. Shahabs2004 commented on Nov 9, 2026

    @Shahabs2004

    I understand that free-tier limits are handled by the hosted OpenCode Zen service and that quota may be based on public IP rather than individual accounts.

    However, I noticed some unusual behavior on my Windows machine that may be relevant to this issue.

    When repeatedly running:

    curl -4 --noproxy "*" https://opencode.ai/cdn-cgi/trace

    I received different public IP addresses, even though I did not intentionally enable or configure a VPN or proxy.

    The results included:

    • 205.252.135.x addresses, with colo=LHR and loc=DE
    • 2.147.255.78, with colo=FRA and loc=IR

    The 205.252.135.x addresses appeared to belong to the same address range, while the other address was completely different.

    I also noticed that my Windows network interface has two default IPv4 gateways configured:

    • 192.168.1.1
    • 192.168.11.1

    I cannot yet determine whether this is caused by my local routing configuration, my ISP, or an upstream network mechanism.

    My questions are:

    1. Does OpenCode Zen identify the client using the public IP observed by its own service, or another mechanism?
    2. If my public egress IP changes between requests, could I end up using different IP-based quota buckets?
    3. Could this behavior explain why a newly opened OpenCode session sometimes reports that the daily free-message limit has already been reached?

    I understand that curl results alone do not prove what IP OpenCode itself uses. I am sharing these observations because they may help investigate unexpected free-tier quota exhaustion.

    users can use this command to check if also their ip address changes just like mine ?
    start->run->cmd->ok
    C:\WINDOWS\system32> for /L %i in (1,1,100) do @(echo ==== %time% ==== & curl -s --noproxy "*" https://opencode.ai/cdn-cgi/trace | findstr "ip= loc= colo=" & timeout /t 3 >nul)

    Please let me know if there are additional diagnostics I should collect.

    Environment: Windows
    VPN/proxy: None intentionally configured

    This approach (IP-based quotas) disappoints new users before they even get a chance to enjoy your application. 😢😢

  29. AlvaroMolinaSanz26 commented on Nov 9, 2026

    @AlvaroMolinaSanz26

    Hello,

    I'm experiencing the same free-tier usage limit issue reported by several users in this thread.

    My environment:

    • OpenCode version: 2.2.6
    • Platform: OpenCode Desktop
    • Operating System: Windows 11
    • Model: DeepSeek (free tier)
    • Provider: OpenCode Zen (free tier)

    Exact error message:

    "You've used today's free messages. They reset at 10 Nov 2026, 1:41."

    Problem description:

    OpenCode tells me that I have used all my daily free messages, even though I cannot continue using the model.

    The reset time is displayed as 1:41 AM on November 10, 2026.

    I'm concerned that this might be the same issue reported by other OpenCode 2.2.6 users, where the daily reset does not properly restore free-tier access.

    What I've observed:

    • I'm already using OpenCode v2.2.6.
    • I'm using the OpenCode Desktop application.
    • The affected model is DeepSeek.
    • The application displays the daily free usage limit message.
    • The displayed reset time is November 10, 2026, at 1:41 AM.

    Questions:

    1. Is this a known issue with the OpenCode Zen free-tier quota system?
    2. Is the quota reset actually being processed on the backend?
    3. Is there any workaround other than waiting for the next reset?
    4. Could this be related to an account-level quota issue rather than the local application?

    I would appreciate it if the maintainers could investigate this, as several users appear to be experiencing the same problem, including users on the latest v2.2.6 release.

    Thank you for your help.

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

    zenRelates to Zen

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions