docs: flag that the default model needs paid AI Gateway credits

SH
4mo ago
+17-5

Why

Deploy verification surfaced this: a fresh deploy builds and the app runs, but the default anthropic/claude-opus-4.8 routes through the Vercel AI Gateway, which returns "Free tier users do not have access to this model" at request time unless the account has paid gateway credits. So a new deployer can't browse out of the box and the cause isn't obvious.

Changes (docs only)

  • docs/ENVIRONMENT.md — restructures the model-credential section into two clear paths: A) AI Gateway (with a callout that it needs paid credits) and B) direct provider (ANTHROPIC_API_KEY, no gateway/credits).
  • README.md — adds a note under the Deploy step pointing at the same.

No code changes.

🤖 Generated with Claude Code


Summary by cubic

Clarifies that the default model anthropic/claude-opus-4.8 runs through the Vercel AI Gateway and requires paid credits, which otherwise triggers “Free tier users do not have access to this model.” Updates README.md and docs/ENVIRONMENT.md to show two setup paths: A) AI Gateway (paid credits) and B) direct provider using ANTHROPIC_API_KEY with a one-line model change.