开源AI工作流

💰 OpenCode Zen — Paid models (requires balance)

Add a payment method to your Zen account to unlock these models at pay-as-you-go rates.

Set opencodego.freeOnly: false to show paid Zen models in the picker (default shows only free models).

<details> <summary><b>🔬 How model metadata is resolved (3-tier fallback)</b></summary>

Limits and capabilities resolve in this priority order:

1. Live metadata from OpenCode /models endpoint
2. 6-hour models.dev snapshot cached in VS Code globalState
3. Bundled fallback catalog shipped with the extension (works offline)

Deprecated/unavailable models are filtered before registration. Per-provider limits tracked separately (Go vs Zen) so shared models (e.g. glm-5.1, qwen3.6-plus) use correct values for each.

</details>

<details> <summary><b>🛣️ Endpoint routing per model family</b></summary>

All Qwen models use /chat/completions because they use OpenAI-native tool-calling format. Routing to Anthropic /messages broke tool calls.

</details>

---

⚡ Quick Start (60 sec)

1.  Install GitHub Copilot Chat (free) ──────────────────────────── ✓
2.  Install this extension ──────────────────────────────────────── ✓
3.  Get an OpenCode Zen API key → opencode.ai/auth ─────────────── ✓
4.  Open Copilot Chat → click model → "Add Models" → OpenCode Zen ── ✓
5.  Paste API key → pick a free model → CHAT 🎉

<details> <summary><b>📖 Detailed step-by-step with screenshots</b></summary>

1. Install GitHub Copilot Chat — free, requires only a GitHub account. 2. Install this extension from the VS Code Marketplace (or press F5 in this repo for dev mode). 3. Get an API key: - Free models: Sign up at opencode.ai → grab an OpenCode Zen key. 2-5 models are truly free (Big Pickle is always free; DeepSeek V4 Flash Free, MiMo-V2.5 Free, and others rotate). - Paid Zen models (optional): Add a payment method to your Zen account to unlock Claude Opus, GPT-5.5, Gemini, and other paid models at pay-as-you-go rates. Adding $20+ balance also improves rate limits on free models. - OpenCode Go (optional): Subscribe to OpenCode Go ($10/mo, $5 first month promo) for curated open models like DeepSeek V4 Pro, Kimi K2.6, GLM-5.1, Qwen3.7 Max, MiMo V2.5 Pro. 4. Open Copilot Chat (Cmd/Ctrl+Shift+I, or click the Copilot icon). 5. Click the model picker (current model name) → Add Models… 6. Select OpenCode Go or OpenCode Zen. 7. Press Enter to accept the default group name. 8. Paste your API key when prompted (stored securely in VS Code SecretStorage). 9. Pick the models you want enabled. 10. Select any OpenCode model from the picker and start chatting. 🚀

💡 Tips: - Go and Zen are separate provider groups — both can be active simultaneously. Switch anytime from the picker. - If a model shows in Language Models view but not the chat picker, hover its row and click the eye icon (👁) to enable it. - Set opencodego.freeOnly: false to reveal paid Zen models in the picker.

</details>

---

📊 Usage Tracking

• Go Usage Tracker — real-time burn-rate of OpenCode Go subscription:
• Tracks 5-hour rolling ($12), weekly ($30), monthly ($60) tiers.
• Client-side cost calc: token usage × per-model pricing (input/output/cache_read).
• Status bar: Go: 27%·62%·75% — ⚠ warning when any tier exceeds 80%.
• Persisted in VS Code globalState — survives restarts.
• Response usage bar — latest prompt/output/total/cache summary after each response.
• Normalized usage DataPart — emits usage MIME so Copilot Chat's context widget shows accurate token counts.

🎬 Demo

<p align="center"> <img src="docs/screenshots/model-picker.gif" alt="Copilot Chat model picker showing OpenCode models" width="480" /> </p>

Selecting an OpenCode model from the Copilot Chat model picker.

---

🔧 Settings

<details> <summary><b>📜 Full settings reference with descriptions</b></summary>

All settings live under the OpenCode namespace in VS Code Settings. Run Preferences: Open Settings (UI) and search opencode.

</details>

---

📊 GitHub Copilot vs This Extension

GitHub Copilot has four tiers now — Free, Pro ($10/mo), Pro+ ($39/mo), and Max ($100/mo). Here's how BYOK via OpenCode compares:

Not a replacement — this extension extends Copilot Chat. You still need the (free) Copilot Chat extension + a GitHub account. BYOK models bypass the Copilot subscription billing entirely — you pay OpenCode directly (or nothing, on Zen free).

❓ FAQ

<details> <summary><b>Do I need Copilot Pro, Pro+, or Max?</b></summary>

No. You only need the free GitHub Copilot Chat extension and any GitHub account — even the Copilot Free tier works. BYOK models bypass Copilot's subscription billing entirely.

If you already pay for Copilot Pro ($10), Pro+ ($39), or Max ($100), you can still use this extension alongside it — keep Copilot for autocomplete, switch to OpenCode models in chat when you want variety, free tier, or specific models GitHub doesn't offer.

</details>

<details> <summary><b>Is it really free? What's the catch?</b></summary>

OpenCode Zen offers 2-5 rotating free models — no balance required. Big Pickle is always free; other models rotate (DeepSeek V4 Flash Free, MiMo-V2.5 Free, Nemotron, etc.). Without a balance, rate limits are low. Adding $20+ to your Zen balance significantly improves rate limits on free models. Paid Zen models (Claude Opus, GPT-5.5, Gemini, etc.) require adding a payment method — they're pay-as-you-go.

OpenCode Go is a subscription — $10/mo ($5 first month promo) — with generous usage limits (5h/$12, weekly/$30, monthly/$60). It unlocks curated open models like DeepSeek V4 Pro, Kimi K2.6, GLM-5.1, Qwen3.7 Max, MiMo V2.5 Pro. When you hit the limit, you can continue using the free Zen models.

This extension is free and open source — you never pay us. You pay OpenCode directly (or nothing, on Zen free).

</details>

<details> <summary><b>Does Agent Mode / tool-calling work?</b></summary>

Yes — fully. The extension forwards VS Code tool schemas in the correct format for each endpoint (OpenAI tool_calls or Anthropic tool_use). Copilot Agent can read files, search, edit, and run terminal commands through any OpenCode model.

</details>

<details> <summary><b>Where is my API key stored?</b></summary>

In VS Code's SecretStorage — the same encrypted store used by GitHub auth. It never leaves your machine and is never sent anywhere except directly to opencode.ai.

</details>

<details> <summary><b>Can I use Go and Zen at the same time?</b></summary>

Yes. They're separate provider groups. Add both via Language Models → Add Models…, enter each key separately, and switch between them from the chat model picker anytime.

</details>

<details> <summary><b>A model shows in Language Models but not the chat picker — why?</b></summary>

Hover its row in the Language Models view and click the eye icon (👁) to toggle visibility.

</details>

<details> <summary><b>Tool calls loop forever on Qwen — help?</b></summary>

Known issue with qwen3.6-plus-free on broad agent tasks (see issue #1). Workaround: set opencodego.thinking.qwen: "off" and use a narrower task scope, or switch to a paid Qwen model.

</details>

<details> <summary><b>How do I use OpenCode models in the Agents window (Copilot CLI)?</b></summary>

Agent models are enabled by default (opencodego.agentsWindow: true). Just add this to your VS Code settings.json:

"extensions.supportAgentsWindow": {
  "ltmoerdani.opencode-copilot-chat": true
}

Then reload the window, open the Agents window, start a Copilot CLI session, and pick any OpenCode model from the picker. See the Agents Window section above for details.

</details>

<details> <summary><b>How do I report a bug or request a model?</b></summary>

Open an issue — pick the Bug Report or Feature Request template. Include the diagnostics report (OpenCode Go: Diagnostics or OpenCode Zen: Diagnostics).

</details>

---