Repository navigation
OpenCode Free Tier Error in Desktop App on Windows: “Free tier can only be used from within OpenCode” #56338
Description
I'm experiencing an issue with the OpenCode Desktop application on Windows.
When I send my very first message in a new conversation using the free OpenCode model, the following error appears immediately:
OpenCode's free tier can only be used from within OpenCode. Download it at https://opencode.ai/ and keep building.
I'm already using the official OpenCode Desktop application, so I would expect the free tier to work without this restriction.
Steps to Reproduce
Launch OpenCode Desktop on Windows.
Start a new conversation.
Select the free OpenCode model.
Send the first message.
The error appears immediately.
Expected Behavior
The free model should respond normally when used within the official OpenCode Desktop application.
Actual Behavior
The request fails immediately with the error stating that the free tier can only be used from within OpenCode.
Environment
Operating System: Windows
Application: OpenCode Desktop
Model: OpenCode Free Tier
When it occurs: On the very first message
Application version: Unknown
Additional Information
The issue occurs before any successful interaction with the model. Please investigate whether this is related to authentication, client identification, or free-tier access validation in the desktop application.
Thank you for your help.
Activity
opencode-agent commentedon Oct 17, 2026
Thanks for the report, @moaiedi! I think this is a duplicate of #55435. It's the same error with a free model in the official OpenCode Desktop app on Windows, and reinstalling doesn't fix it.
Possible duplicates and closely related issues, most likely first:
opencodeprovider entry pointing athttps://opencode.ai/zen/v1from~/.config/opencode/opencode.jsonoropencode.jsonc. Another is the workaround linked from OpenCode's free tier can only be used from within OpenCode. Download it at https://opencode.ai and keep building. #55443.opencode auth login opencode(or using/connect) has fixed it for several people.If none of these fixes it, please share your app version and say whether you have any custom
providersettings in your config or are behind a VPN or proxy.The bot will close this issue as a duplicate in 1 day unless you reply explaining how your problem is different.
HyperZTeam456 commentedon Oct 18, 2026
Im experiencing this as well.
HyperZTeam456 commentedon Oct 18, 2026
opencode-agent commentedon Oct 18, 2026
Closing this as a duplicate of #55435, since we haven't heard back about how this is different. That issue covers the same free-tier error in OpenCode Desktop on Windows, and its comments list fixes that have worked for people. Please follow it there.
If those fixes don't work for you, and your problem turns out to be different (for example, it depends on your network as in #56334), please reply here with your app version and setup and we can reopen it. Thanks for reporting!