Setup guide - Documented by Roo Code
Use OpenAI in Roo Code
Roo Code connects directly to the official OpenAI API with an API key via the "OpenAI" provider, and supports all models available through OpenAI's API. A separate "OpenAI - ChatGPT Plus/Pro" provider signs in via OAuth instead of a key.
Last verified 3 steps2 official sources
Steps
- Step 1.
Create a key on the OpenAI Platform API keys page (https://platform.openai.com/api-keys) and copy it immediately.
- Step 2.
Open Roo Code Settings (gear icon), choose "OpenAI" from the "API Provider" dropdown, paste your key into the "OpenAI API Key" field, and choose a model from the "Model" dropdown. Optionally set a custom Base URL.
- Step 3.
For reasoning models, set reasoning effort (low / medium / high, plus minimal on GPT-5 models) and verbosity in the provider settings.
Caveats
- Roo Code's page points to OpenAI's models documentation for the up-to-date list and describes GPT-5-era reasoning controls; it does not name GPT-6 models. The ids shown come from OpenAI's model catalog.
- Roo Code docs now live at roocodeinc.github.io/Roo-Code (docs.roocode.com redirects there).
- Azure OpenAI should be configured through Roo Code's OpenAI-compatible provider.
More setup guides
Same tool, other providers
Related reading
- Codex Training Setting Re-Enabled? Two Switches to CheckDevelopers report Codex model training turning itself back on. What OpenAI documents, the second "Include environments" switch most people miss, and a five-minute check.
- OpenAI Pando: The Git Backend Built for Codex-Scale PushesOpenAI built Pando, a Git-compatible backend, after Codex flooded its monorepo with pushes. What it changed, the trade-offs, and what it means for your agent fleet.
- GPT-6.1 Terra: $1/$5 Pricing, Benchmarks, and When to Pick ItGPT-6.1 Terra is OpenAI's new $1/$5 per million token model: 50.3% on Terminal-Bench 4.0 (vendor-reported), half Sol's price, and who should route to it.
- Codex CLI 0.164: /presets and Inline /model FlagsCodex CLI 0.164.0 adds ten /presets slots, inline /model and /permissions arguments, and credential masking for remote commands. What to try and what to check.
- Codex Reset: Banked vs Automatic vs Paid, and When to Use EachCodex has three kinds of usage reset - banked, automatic and paid - and they move your weekly refresh date in different ways. What OpenAI documents, the 80% rule, and what to do Monday.
- OpenAI Models on Google Cloud: What Changes for DevelopersOpenAI and Google Cloud put GPT-6 Astra, GPT-6.1 Sol and GPT-6 Luna into Model Garden in private preview, with Codex pointed at Gemini inference. What is live, what is "coming soon", and what to do before general availability.
FAQ
How do I use OpenAI in Roo Code?
Roo Code connects directly to the official OpenAI API with an API key via the "OpenAI" provider, and supports all models available through OpenAI's API. A separate "OpenAI - ChatGPT Plus/Pro" provider signs in via OAuth instead of a key.
Which OpenAI model ids work in Roo Code?
The official docs read for this guide list gpt-6.1-sol, gpt-6-astra and gpt-6-luna.
Is this an official OpenAI and Roo Code setup?
Roo Code documents this setup in its own docs. It was last checked against 2 official pages on October 17, 2026.
Sources
Last verified against 2 official pages.
- roocodeinc.github.iohttps://roocodeinc.github.io/Roo-Code/providers/openai/
- developers.openai.comhttps://developers.openai.com/api/docs/models
Newsletter
New models, set up the day they ship
One email per week. New model releases, the coding tools that support them and how to wire them up.