diff --git a/packages/web/src/content/docs/index.mdx b/packages/web/src/content/docs/index.mdx
index 293950eb..86aa2e78 100644
--- a/packages/web/src/content/docs/index.mdx
+++ b/packages/web/src/content/docs/index.mdx
@@ -87,7 +87,7 @@ You can also install it with the following:
   npm install -g opencode-ai
   ```
 
-Support for installing opencode on Windows using the bun package manager is currently in progress.
+Support for installing opencode on Windows using Bun is currently in progress.
 
 You can also grab the binary from the [Releases](https://github.com/sst/opencode/releases).
 
@@ -101,19 +101,22 @@ If you are new to using LLM providers, we recommend using [opencode zen](/docs/z
 It's a curated list of models that have been tested and verified by the opencode
 team.
 
-1. Sign in to **<a href={console}>opencode zen</a>** and put in your billing
-   details.
-2. Copy your API key.
-3. Run `opencode auth login`, select opencode, and add your API key.
+1. Run `opencode auth login`, select opencode, and head to [opencode.ai/auth](https://opencode.ai/auth).
+2. Sign in, add your billing details, and copy your API key.
+3. Paste your API key.
 
    ```bash
    $ opencode auth login
 
    ┌  Add credential
    │
-   ◆  Select provider
-   │  ● opencode
-   │  ...
+   ◇  Select provider
+   │  opencode
+   │
+   ●  Create an api key at https://opencode.ai/auth
+   │
+   ◆  Enter your API key
+   │  _
    └
    ```
 
diff --git a/packages/web/src/content/docs/providers.mdx b/packages/web/src/content/docs/providers.mdx
index ab4ac3ed..6f96465e 100644
--- a/packages/web/src/content/docs/providers.mdx
+++ b/packages/web/src/content/docs/providers.mdx
@@ -57,9 +57,25 @@ tested and verified to work well with opencode. [Learn more](/docs/zen).
 If you are new, we recommend starting with opencode zen.
 :::
 
-1. You sign in to **<a href={console}>opencode zen</a>** and get your API key.
-2. You run `opencode auth login` and select opencode and add your API key.
-3. Run `/models` in the TUI to see the list of models we recommend.
+1. Run `opencode auth login`, select opencode, and head to [opencode.ai/auth](https://opencode.ai/auth).
+2. Sign in, add your billing details, and copy your API key.
+3. Paste your API key.
+
+   ```bash
+   $ opencode auth login
+
+   ┌  Add credential
+   │
+   ◇  Select provider
+   │  opencode
+   │
+   ●  Create an api key at https://opencode.ai/auth
+   │
+   ◆  Enter your API key
+   │  _
+   └
+   ```
+4. Run `/models` in the TUI to see the list of models we recommend.
 
 It works like any other provider in opencode. And is completely optional to use
 it.
diff --git a/packages/web/src/content/docs/zen.mdx b/packages/web/src/content/docs/zen.mdx
index b40dedd1..b43801b5 100644
--- a/packages/web/src/content/docs/zen.mdx
+++ b/packages/web/src/content/docs/zen.mdx
@@ -49,8 +49,9 @@ opencode zen is an AI gateway that gives you access to these models.
 
 opencode zen works like any other provider in opencode.
 
-1. You sign in to **<a href={console}>opencode zen</a>** and get your API key.
-2. You run `opencode auth login` and select opencode and add your API key.
+1. You sign in to **<a href={console}>opencode zen</a>**, add your billing
+   details, and copy your API key.
+2. You run `opencode auth login`, select opencode, and paste your API key.
 3. Run `/models` in the TUI to see the list of models we recommend.
 
 You are charged per request and you can add credits to your account.
@@ -75,8 +76,7 @@ You can also access our models through the following API endpoints.
 
 ## Pricing
 
-Below are the models that we currently support and their prices **per 1M
-tokens**.
+We support a pay-as-you-go model. Below are the prices **per 1M tokens**.
 
 | Model                           | Input  | Output | Cached Read | Cached Write |
 | ------------------------------- | ------ | ------ | ----------- | ------------ |
@@ -95,6 +95,10 @@ Credit card fees are passed along at cost; we don’t charge anything beyond tha
 
 Grok Code Fast 1 is currently free on opencode for a limited time. The xAI team is using this time to collect feedback and improve Grok Code.
 
+:::tip
+Subscription plans and a free tier are coming soon.
+:::
+
 <a href={email}>Contact us</a> if you have any questions.
 
 ---