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 CLI 0.163: Instant Steering Is Now the DefaultCodex CLI 0.163.0 makes mid-response steering the default and adds searchable /config and a leader key. What changed and what to check before upgrading.
- Tool Calling Under the Hood: Claude Messages vs OpenAI ResponsesHow tool calling works on the wire: JSON schema tools, parallel calls, tool_choice, strict mode and streaming deltas in Claude Messages vs OpenAI Responses.
- Codex 'gpt-5.5 Model Is Not Supported' Error: The FixCodex says gpt-5.5 is not supported with a ChatGPT account because OpenAI retired it from ChatGPT sign-in on October 14. The fix and what still works.
- Codex CLI Background Daemon: How to Turn It OffCodex CLI starts a persistent, self-updating background daemon since 0.157.0. What it does, why it hit Hacker News and the reported workaround to turn it off.
- Codex CLI 0.162: Managed Worktrees and Pinned TasksCodex CLI 0.162 lets the agent create and list its own Git worktrees, adds pinned tasks and custom provider capability overrides. What to change this week.
- ChatGPT Free vs Go vs Plus After GPT-6: Which Model You GetFree and Go ($8) both get GPT-6 Luna in Chat. Plus ($20) is the cheapest plan with GPT-6 Sol and full Codex. What each ChatGPT plan buys now.
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.