To use OpenRouter models in OpenCode, create an OpenRouter API key, connect it in OpenCode with /connect, then choose a model with /models. In OpenCode Desktop, connect OpenRouter in Settings and use the model picker; if the catalog does not appear, restart the app. Configuration files are optional for a basic connection, and their syntax depends on your OpenCode version.
Connect OpenRouter to OpenCode
The terminal workflow is the shortest route: create a key, connect the provider, and select a model. OpenRouter’s OpenCode integration guide documents the same sequence, while OpenCode’s provider guide explains its credential and model commands.
- Install or launch OpenCode. Use the installation method for your operating system; the official integration guide links platform-specific options rather than prescribing one universal install command.
- Create an API key. Sign in to the OpenRouter dashboard and create a key. OpenRouter’s guide describes keys beginning with
sk-or-v1-. Treat the full value as a secret: paste your own key into OpenCode, and do not put it in shared examples or public repositories. - Open the project in OpenCode. In a terminal, change to the project directory and start OpenCode there.
- Connect the provider. Enter
/connect, select OpenRouter, and paste the API key when prompted. - Select a model. Enter
/modelsand choose an available OpenRouter model.
OpenCode stores credentials added through /connect in ~/.local/share/opencode/auth.json. That file contains authentication data; avoid sharing it or committing it to source control.
Connect in OpenCode Desktop
In the desktop app, open Settings or the provider command, choose OpenRouter, select API-key authentication, and confirm with your key. Then choose a model from the session view or command palette. OpenRouter’s integration guide says the desktop provider catalog loads at app startup, so fully quit and reopen OpenCode Desktop if the models do not appear immediately.
Recommended Free Tools
#1 Best Overall
- STEP UP TO TRUE GAMING – The Lenovo Legion LOQ is your first step into gaming, unlocking a new caliber of entertainment. Enjoy seamless AI experiences, high resolution and frame rates, with vacuum-sealed thermals to fast-track your performance.
- GAME WITHOUT COMPROMISE – Be everything you want to be, in game and out with optimized performance and new AI-enhanced features. Play harder and work smarter with the Intel Core i7-13650HX processor.
- STAY ICY, GAME SPICY – Lenovo LOQ’s Hyperchamber Cooling keeps your system from overheating with turbo fans and copper heat pipes. AI Engine+ ensures your laptop stays consistently cool while you bring the heat.
- KEYS THAT SLAY EVERY DAY – The Lenovo LOQ keyboard is built to vibe with a clean white backlight, full layout, and soft-landing switches for smooth, satisfying presses. Game, chat, flex—your way.
- GLOW UP YOUR VISUALS – The FHD IPS display is perfect for gaming and watching your favorite streams. NVIDIA G-Sync technology eliminates screen tearing, stuttering, and input lag, ensuring silky-smooth frame rates.
Choose a model that fits the task
Use /models in the terminal interface or the desktop model picker to browse the models available to your connection. Check the model’s capabilities against the work you intend to do, compare its current cost, and consider any provider-routing preferences you need. The available catalog and prices can change; consult OpenRouter’s live model catalog instead of relying on a static ranking or price list.
If you know the model you want but cannot find it, copy its exact identifier from the catalog. Model names and slugs are not necessarily interchangeable; preserve a leading ~ when the catalog’s alias uses one.
Rank #2
- AN AMAZING MAC AT A SURPRISING PRICE — With an incredibly portable and durable aluminum design, up to 16 hours of battery life,* and the A18 Pro chip, MacBook Neo is ready to go wherever school takes you.
- FOUR STUNNING COLORS. ONE DURABLE DESIGN — Choose from four beautiful colors — Silver, Blush, Citrus, or Indigo — each with a color-coordinated keyboard. And MacBook Neo is made with a durable recycled aluminum enclosure that helps it reach 60 percent recycled content by weight — the most ever in any Apple product.*
- FLY THROUGH EVERYDAY ASSIGNMENTS — Whether you’re cramming for finals, using Apple Intelligence* to summarize class notes, creating presentations, or even playing the latest Apple Arcade game,* MacBook Neo delivers the performance and AI capabilities you need to get things done.
- UP TO 16 HOURS OF BATTERY LIFE — MacBook Neo delivers all day battery life, so you can power through from early morning classes to late night study sessions without worrying about plugging in.
- A VIBRANT 13-INCH DISPLAY* — The gorgeous Liquid Retina display on MacBook Neo supports 1 billion colors, so photos and videos pop and text is crisp for easy reading.
When to add configuration
You usually do not need to edit a configuration file to connect or select a preloaded model. Configuration is useful when you need to add a model that is absent from the picker, set a default model, or specify provider-routing behavior. OpenCode’s documented examples use different structures, so follow the page matching your installed version rather than combining snippets.
OpenCode provider-guide configuration
The terminal example in OpenCode’s provider guide uses opencode.json and a provider.openrouter.models map to add models by ID. It also documents per-model routing options such as options.provider.order and allow_fallbacks. These routing settings are optional advanced controls, not prerequisites for using OpenRouter.
The Tool Desk
Outbyte Driver Updater FREEScan for outdated or missing drivers - takes under a minuteDriver Scan →Outbyte PC Repair FREERepair Windows errors before they cause bigger problemsFix Now →Rank #3
- Crisp 15.6" FHD IPS Display – Enjoy stunning 1920x1080 resolution with wide viewing angles and vibrant colors on the IPS panel. Whether you're reviewing spreadsheets, attending virtual classes, or streaming videos, every detail comes through with exceptional clarity and reduced eye strain during extended work sessions.
- Responsive Performance for Daily Productivity – Powered by the Intel Pentium Gold 6500Y processor with dual cores and four threads, boosting up to 3.4GHz. Benchmark tests show it outperforms the Core m3-8100Y in single-core performance. Paired with 16GB RAM and a 512GB SSD, this laptop handles multitasking, office applications, and online courses with smooth, lag-free efficiency.
- Ample Storage & Seamless Multitasking – 16GB of high-speed RAM lets you keep dozens of browser tabs, documents, and applications open simultaneously without slowdown. The 512GB solid-state drive delivers fast boot times, near-instant application launches, and plenty of space for your files, presentations, and course materials.
- Versatile Connectivity for All Your Devices – Equipped with HDMI for external monitors or projectors, two USB-A 3.2 Gen 1 ports for high-speed data transfer, one USB-A 2.0 port, a 3.5mm headphone jack, and a Micro SD slot. The Type-C port supports convenient charging. Stay connected with WiFi 5 and Bluetooth 5.0 for wireless peripherals and fast internet access.
- Privacy Protection & All-Day Comfort – The physical camera shutter gives you complete control over your webcam privacy—slide it closed when not in use for peace of mind. The energy-efficient Pentium processor with low TDP enables silent, fanless operation and extended battery life, making this silver laptop perfect for students, professionals, and anyone working remotely.
For the exact fields and current example, use the OpenCode provider guide. Do not assume its configuration shape applies to every OpenCode release.
OpenCode v2 provider configuration
The newer v2 provider page describes supplying OPENROUTER_API_KEY to the OpenCode server or connecting an account. Its example selects a model with a full provider-prefixed ID, such as openrouter/anthropic/claude-sonnet-4, and uses a plural providers configuration structure. The v2 page also advises retaining OpenRouter’s native runtime when overriding an endpoint or using an OpenRouter-compatible gateway, so OpenRouter-specific request and reasoning behavior remains available.
Rank #4
- 【Ryzen 5 6600H for Demanding Daily Performance】AMD Ryzen 5 6600H processor features 6 cores, 12 threads, and boost speeds up to 4.5GHz, delivering stronger performance for office multitasking, coding, content handling, and sustained daily workloads. Compared with many common thin-and-light Intel Ryzen 5 7430U, Core i3-1315U, Core i5-1334U, AMD Ryzen 5 7520U, and Ryzen 7 5825U configurations, it is a better fit for users who need more performance headroom.
- 【Radeon 660M Graphics】AMD Radeon 660M integrated graphics with RDNA 2 architecture supports everyday visual work, smooth media playback, light photo editing, and casual gaming needs like LoL or CS2 at 1080p settings. It is a balanced fit for students, remote workers, and entry-level creators who want capable graphics without the extra heat and power draw of a dedicated GPU.
- 【16GB RAM & 1TB SSD with Upgrade Room】16GB DDR5 memory and a 1TB PCIe SSD deliver smooth out-of-the-box performance for multitasking, large file handling, and daily storage needs. With dual SO-DIMM slots and an M.2 2280 design, the system still leaves room to upgrade up to 64GB RAM and up to 4TB SSD as your needs continue to grow.
- 【2 Year Warranty Support】Includes a 2-year manufacturer warranty and a 90-day hassle-free return window, with final assembly in the United States and after-sales replacement handled in the United States under this listing workflow. That added service clarity gives students, professionals, and home users more confidence when choosing a laptop for long-term daily use.
- 【53.58Wh Battery and 100W PD】A 53.58Wh smart battery paired with a separate 100W PD charger gives this laptop more flexibility for campus study, coffee shop work, and moving between rooms at home. The USB-C setup also supports convenient power and display connectivity, helping reduce the hassle of slow charging and frequent outlet hunting during a busy day.
These v2 fields are not interchangeable with the provider guide’s provider.openrouter.models example. The documentation cited here does not establish a complete release boundary for the syntax change. Check the v2 provider documentation and the documentation for your installed version before editing configuration.
Quick Recap
Best Value
- Striking 15.6-inch FHD Display — Brings visuals to life with a 250-nit sustained brightness and 45% NTSC color gamut
- Reliable AMD Ryzen 3 7320U Processor — An efficient processor that delivers reliable performance for multitasking, browsing, and light gaming with 4 cores and 8 threads
- Integrated AMD Radeon Graphics — Enjoy sharp, detailed images and smooth video playback for everyday computing tasks
- Easy Productivity With 8GB Of Memory and 256GB Of Essential Storage — Experience reliable performance for the modern everyday, whether you’re watching movies, shopping or browsing. Save files quickly and store necessary data
- Up To 11 Hours Of Battery Life — With an efficient 42Wh battery 1, minimize charging downtime while maximizing your productivity and relaxation — anytime, anywhere
Troubleshoot missing credentials or models
- OpenCode reports an authentication error: run
opencode auth listto check whether OpenCode has a provider credential, then verify that the key is valid in OpenRouter’s key settings. If the key is missing or invalid, connect again with/connect. - The desktop model picker is empty after connecting: fully quit and reopen OpenCode Desktop to reload the provider catalog.
- A specific model is not listed: verify the exact slug in OpenRouter’s model catalog, including any leading
~alias prefix. In the provider-guide configuration format, add an absent model underprovider.openrouter.modelsand restart OpenCode; use this format only if it matches your version. - A configured v2 model cannot be resolved: check that the top-level model value includes the
openrouter/prefix and the full OpenRouter model ID, as shown in the v2 provider documentation. - You are unsure which config syntax applies: do not mix the older provider-guide fields with the v2 structure. Identify your installed version and follow its matching official provider page.
Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.
