{{ message }}
Repository navigation
Error: OpenCode's free tier can only be used from within OpenCode. Download it at https://opencode.ai and keep building. #55432
Description
Description
Plugins
none
OpenCode version
2.0.27
Steps to reproduce
open opencode cli
select space bunny free model
send prompt
it throw a error
Screenshot and/or share link
No response
Operating System
No response
Terminal
No response
Activity
opencode-agent commentedon Oct 14, 2026
Thanks for the report! This error has a few different known causes on v2, so we need a bit more detail to work out which one you're hitting:
@opencode/cli, install script, Homebrew, AUR, etc.). Please also paste the exact output ofopencode --version.build/planagent or a custom agent? Do you have anypermissionor tool settings in your config (global or projectopencode.json, or.opencode/agents/*.md), especially rules that denyshell/bash,readoredit? If so, please paste them.opencode auth listshow anopencodecredential? Does the error go away after runningopencode auth login opencode(or/connect)?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 by likelihood):
opencode auth login opencode//connectfixes itshellgets this error on free models, even for trivial prompts (also [BUG] Free models fail whenshellorreadpermissions are denied #51241, agents: config-defined shell deny on free-model agent fails session with misleading free-tier error #51193, tui: free-tier model rejected for custom primary agent while build works #55266)Introvert-Byte commentedon Oct 14, 2026
"opencode auth login opencode"
the command fix this for me , thanks
rroblf01 commentedon Oct 17, 2026
the same thing happens to me
Version: opencode v2.0.32
OS: Arch Linux x86_64
Kernel: Linux 6.18.57-1-lts
Terminal: Kitty
SamMasHack207 commentedon Oct 17, 2026
Same error here on v2.0.32 (and v2.0.22), Windows 11, installed via
npm i -g @opencode/cli.opencode auth list-> OpenCode Console / Personal / storedopencode run --standalone, from an empty directory, and with my opencode.jsonc (plugins + MCP) removedIs there a server-side requirement for the free tier on accounts without billing/credits, or a known client regression in 2.0.x?
opencode-agent commentedon Oct 17, 2026
Closing this for now because we haven't heard back. This error has several different causes on v2, so we can't tell which one you're hitting without the details we asked for: your OS and install method, whether it happens on the first message, your agent and permission config, and your login state.
In the meantime, these issues cover the most common causes and may help:
opencode auth login opencodeor/connectfixes itshellor other tools triggers this error on free modelsIf it still happens, reply here with those details and we'll reopen it. Thanks!