OpenCode's free tier can only be used from within OpenCode. Download it at https://opencode.ai and keep building. #55616

Activity

1. opencode-agent commented on Oct 15, 2026

   

   opencode-agentBot

   on Oct 15, 2026 – with OpenCode Agent

   Contributor

   More actions

   Thanks for the report! This error has several known causes, so we need a few details to work out which one you're hitting:

   1. Version and platform: the exact OpenCode Desktop version (shown in the app, or the output of opencode --version) and your operating system.
   2. Model: which free model you had selected.
   3. When it happens: on the very first message of a new session, partway through a session (e.g. during compaction), when a subagent is spawned, or in an imported session.
   4. Config: whether your opencode.json / opencode.jsonc (e.g. ~/.config/opencode/) contains a provider entry pointing to https://opencode.ai/zen/v1. Other users fixed this error by removing that entry, or by running opencode auth login opencode. Please let us know if either of these helps.

   You can reply here with the details, or edit the issue. If you edit it, please also leave a comment saying you've updated it, so we know when you're done.

   These existing issues may already cover your problem, ordered from most to least likely:

   • OpenCode's free tier can only be used from within OpenCode. Download it at https://opencode.ai and keep building. #55435: the same error in OpenCode Desktop 2.0.29 on Windows with a free model; the thread includes the config workaround
   • OpenCode's free tier can only be used from within OpenCode. Download it at https://opencode.ai and keep building. #55426: the same error in OpenCode Desktop on Windows, appearing mid-session with Muse Spark
   • Error from provider (Console): OpenCode's free tier can only be used from within OpenCode #50366: the same error from the Desktop app on Windows, appearing partway through a session or during compaction
   • Error: OpenCode's free tier can only be used from within OpenCode. Download it at https://opencode.ai and keep building. #55432: the same error in the CLI with a free model; fixed for one user by opencode auth login opencode
   • subagent: spawn always fails with "free tier can only be used from within OpenCode" on stock install #55471 / subagent: free-tier restriction triggers incorrectly when spawning from within OpenCode #55569: the error appears when a subagent is spawned
   • policy: deny shell * on custom agent breaks free tier with "can only be used from within OpenCode" #50627: a deny shell * policy on a custom agent triggers the error
   • session import succeeds but the session is unusable: every continuation gets 'free tier can only be used from within OpenCode' #55476: the error appears on every continuation of an imported session
2. opencode-agent

   added

   triaging

   on Oct 15, 2026
3. Gaurav-Wankhede commented on Oct 15, 2026

   

   Gaurav-Wankhede

   on Oct 15, 2026

   More actions

   The version is opencode v2.0.29; here we are facing the issues
4. smashrvmco commented on Oct 15, 2026

   

   smashrvmco

   on Oct 15, 2026

   Last edited by smashrvmco

   More actions

   same problem here as of last night, using opencode web, 1.18.25
   edit: had to make an api key, after that it is able to use the free tier models again
5. opencode-agent

   closed this as not plannedon Oct 18, 2026
6. opencode-agent commented on Oct 18, 2026

   

   opencode-agentBot

   on Oct 18, 2026 – with OpenCode Agent

   Contributor

   More actions

   We haven't heard back, so I'm closing this for now. This free-tier error has several different causes, and without your OpenCode Desktop version, OS, model and when the error appears, we can't tell which one you're hitting.

   If you're still affected, first try the workarounds that fixed it for other users: remove any provider entry pointing to https://opencode.ai/zen/v1 from your opencode.json / opencode.jsonc, or run opencode auth login opencode. You can also follow #55435 or #50366, which track the same error in OpenCode Desktop. If none of that helps, reply here with those details and we can reopen this. Thanks!