From 74c24a3dd8fed6342c9e03eec8cc6f32b03c3421 Mon Sep 17 00:00:00 2001 From: Hannes Rudolph Date: Thu, 15 Jan 2026 12:56:58 -0700 Subject: [PATCH 1/5] docs: add ChatGPT Plus/Pro provider setup guide --- docs/providers/index.json | 6 ++ docs/providers/openai-chatgpt-plus-pro.md | 76 +++++++++++++++++++++++ docs/providers/openai.md | 4 ++ 3 files changed, 86 insertions(+) create mode 100644 docs/providers/openai-chatgpt-plus-pro.md diff --git a/docs/providers/index.json b/docs/providers/index.json index 0dd9933a..25485f5d 100644 --- a/docs/providers/index.json +++ b/docs/providers/index.json @@ -126,6 +126,12 @@ "extension": true, "cloud": true }, + { + "id": "providers/openai-chatgpt-plus-pro", + "title": "OpenAI – ChatGPT Plus/Pro", + "extension": true, + "cloud": false + }, { "id": "providers/openai-compatible", "title": "OpenAI Compatible", diff --git a/docs/providers/openai-chatgpt-plus-pro.md b/docs/providers/openai-chatgpt-plus-pro.md new file mode 100644 index 00000000..ecd36b87 --- /dev/null +++ b/docs/providers/openai-chatgpt-plus-pro.md @@ -0,0 +1,76 @@ +--- +sidebar_label: OpenAI – ChatGPT Plus/Pro +title: OpenAI – ChatGPT Plus/Pro +description: Use Codex models in Roo Code with a ChatGPT Plus/Pro subscription (OAuth sign-in, no API key). +keywords: + - OpenAI Codex + - ChatGPT Plus + - ChatGPT Pro + - Roo Code + - OAuth + - no api key + - subscription +--- + + + +Why this video matters: it shows the exact sign-in flow and where to click in the Roo Code settings panel. + +Use Codex models in Roo Code **without an OpenAI API key**. Just sign in with the ChatGPT account you already pay for. + +--- + +If you want the official OpenAI API (API keys, usage-based billing, broader model availability), use the regular OpenAI provider instead: [Using OpenAI With Roo Code](/providers/openai). + +## Quickstart: sign in and run a task + +1. Open Roo Code settings (click the gear icon in the Roo Code panel). +2. In **API Provider**, select **OpenAI – ChatGPT Plus/Pro**. +3. Click **Sign in to OpenAI Codex**. +4. Finish the sign-in flow in your browser. +5. Back in Roo Code settings, pick a model from the dropdown. +6. Start a task. + +## What you can't do (and why) + +- **You can't use arbitrary OpenAI API models.** This provider only exposes the models listed in Roo's Codex model catalog. +- **You can't export/migrate your sign-in state with settings export.** OAuth tokens are stored in VS Code SecretStorage, which isn't included in Roo's settings export. +- **You can't sign in if Roo can't bind `localhost:1455`.** The OAuth callback uses a local server; if your machine (or security software) blocks it, the flow can't complete. + +## Troubleshooting + +#### Not authenticated with OpenAI Codex (or Roo asks you to sign in) + +- **Symptom:** Roo fails immediately and tells you to sign in. +- **Cause:** You haven't completed OAuth sign-in, or your stored refresh token was revoked and Roo cleared it. +- **Fix:** In the provider settings panel, click **Sign in to OpenAI Codex** again. +- **Prevention:** Don't delete VS Code extension secrets unless you expect to re-auth. + +#### Port 1455 is already in use during sign-in + +- **Symptom:** Sign-in fails right away and mentions port `1455`. +- **Cause:** Another process is listening on that port. +- **Fix:** Stop the process using `1455`, then retry sign-in. +- **Prevention:** Avoid running other local OAuth callback servers on the same port. + +#### 403 Forbidden or Model not available + +- **Symptom:** Requests fail with access denied. +- **Cause:** Your ChatGPT subscription or organization doesn't have access to that model. +- **Fix:** Pick a different model, or verify your account/org subscription. +- **Prevention:** Treat the model list in the provider settings as the source of truth. + +#### Cost shows as $0 + +- **Symptom:** Roo shows usage but cost is zero. +- **Cause:** This provider is subscription-covered, so Roo intentionally reports cost as $0. +- **Fix:** Nothing to fix. +- **Prevention:** Don't treat $0 as “no tokens consumed”; it's “not billed per token in Roo”. diff --git a/docs/providers/openai.md b/docs/providers/openai.md index 3d4c6cdf..e885c46b 100644 --- a/docs/providers/openai.md +++ b/docs/providers/openai.md @@ -17,6 +17,10 @@ keywords: Roo Code supports accessing models directly through the official OpenAI API, including the latest GPT-5 family with advanced features like reasoning effort control and verbosity settings. +:::info Want to use a ChatGPT Plus/Pro subscription instead? +Use the **OpenAI – ChatGPT Plus/Pro** provider to sign in via OAuth (no API key): [OpenAI – ChatGPT Plus/Pro](/providers/openai-chatgpt-plus-pro). +::: + **Website:** [https://openai.com/](https://openai.com/) --- From aec2d8ed3b80cd0c728077542038294e07fecd33 Mon Sep 17 00:00:00 2001 From: Roo Code Date: Thu, 15 Jan 2026 20:05:53 +0000 Subject: [PATCH 2/5] docs: remove "Why this video matters" section --- docs/providers/openai-chatgpt-plus-pro.md | 2 -- 1 file changed, 2 deletions(-) diff --git a/docs/providers/openai-chatgpt-plus-pro.md b/docs/providers/openai-chatgpt-plus-pro.md index ecd36b87..9e5835cf 100644 --- a/docs/providers/openai-chatgpt-plus-pro.md +++ b/docs/providers/openai-chatgpt-plus-pro.md @@ -22,8 +22,6 @@ keywords: allowfullscreen > -Why this video matters: it shows the exact sign-in flow and where to click in the Roo Code settings panel. - Use Codex models in Roo Code **without an OpenAI API key**. Just sign in with the ChatGPT account you already pay for. --- From 0040881a3ca475c46340d2842506352607224f1e Mon Sep 17 00:00:00 2001 From: Hannes Rudolph Date: Thu, 15 Jan 2026 13:07:45 -0700 Subject: [PATCH 3/5] Update docs/providers/openai-chatgpt-plus-pro.md Co-authored-by: roomote[bot] <219738659+roomote[bot]@users.noreply.github.com> --- docs/providers/openai-chatgpt-plus-pro.md | 25 +++++++++++++++-------- 1 file changed, 16 insertions(+), 9 deletions(-) diff --git a/docs/providers/openai-chatgpt-plus-pro.md b/docs/providers/openai-chatgpt-plus-pro.md index 9e5835cf..7f6b9d1d 100644 --- a/docs/providers/openai-chatgpt-plus-pro.md +++ b/docs/providers/openai-chatgpt-plus-pro.md @@ -12,15 +12,22 @@ keywords: - subscription --- - +
+ +
Use Codex models in Roo Code **without an OpenAI API key**. Just sign in with the ChatGPT account you already pay for. From 0249026f5be147f0286f529f1c6697fd9abbf985 Mon Sep 17 00:00:00 2001 From: Hannes Rudolph Date: Thu, 15 Jan 2026 14:04:08 -0700 Subject: [PATCH 4/5] docs: update OpenAI ChatGPT Plus/Pro provider details and restructure index --- docs/providers/index.json | 24 +++++----- docs/providers/openai-chatgpt-plus-pro.md | 54 ++++++----------------- 2 files changed, 25 insertions(+), 53 deletions(-) diff --git a/docs/providers/index.json b/docs/providers/index.json index 25485f5d..3f4175bf 100644 --- a/docs/providers/index.json +++ b/docs/providers/index.json @@ -1,5 +1,17 @@ { "providers": [ + { + "id": "providers/roo-code-router", + "title": "Roo Code Router", + "extension": true, + "cloud": true + }, + { + "id": "providers/openai-chatgpt-plus-pro", + "title": "ChatGPT Plus/Pro - OpenAI", + "extension": true, + "cloud": false + }, { "id": "providers/anthropic", "title": "Anthropic", @@ -126,12 +138,6 @@ "extension": true, "cloud": true }, - { - "id": "providers/openai-chatgpt-plus-pro", - "title": "OpenAI – ChatGPT Plus/Pro", - "extension": true, - "cloud": false - }, { "id": "providers/openai-compatible", "title": "OpenAI Compatible", @@ -156,12 +162,6 @@ "extension": true, "cloud": false }, - { - "id": "providers/roo-code-router", - "title": "Roo Code Router", - "extension": true, - "cloud": true - }, { "id": "providers/sambanova", "title": "SambaNova", diff --git a/docs/providers/openai-chatgpt-plus-pro.md b/docs/providers/openai-chatgpt-plus-pro.md index 7f6b9d1d..d3fc9132 100644 --- a/docs/providers/openai-chatgpt-plus-pro.md +++ b/docs/providers/openai-chatgpt-plus-pro.md @@ -1,7 +1,7 @@ --- -sidebar_label: OpenAI – ChatGPT Plus/Pro -title: OpenAI – ChatGPT Plus/Pro -description: Use Codex models in Roo Code with a ChatGPT Plus/Pro subscription (OAuth sign-in, no API key). +sidebar_label: ChatGPT Plus/Pro - OpenAI +title: ChatGPT Plus/Pro - OpenAI +description: Use OpenAI models in Roo Code with your ChatGPT Plus/Pro subscription (OAuth sign-in, no API key). keywords: - OpenAI Codex - ChatGPT Plus @@ -14,7 +14,7 @@ keywords:
-Use Codex models in Roo Code **without an OpenAI API key**. Just sign in with the ChatGPT account you already pay for. - --- -If you want the official OpenAI API (API keys, usage-based billing, broader model availability), use the regular OpenAI provider instead: [Using OpenAI With Roo Code](/providers/openai). - -## Quickstart: sign in and run a task +## Quickstart: Connect your subscription to Roo Code 1. Open Roo Code settings (click the gear icon in the Roo Code panel). 2. In **API Provider**, select **OpenAI – ChatGPT Plus/Pro**. 3. Click **Sign in to OpenAI Codex**. 4. Finish the sign-in flow in your browser. 5. Back in Roo Code settings, pick a model from the dropdown. -6. Start a task. - -## What you can't do (and why) - -- **You can't use arbitrary OpenAI API models.** This provider only exposes the models listed in Roo's Codex model catalog. -- **You can't export/migrate your sign-in state with settings export.** OAuth tokens are stored in VS Code SecretStorage, which isn't included in Roo's settings export. -- **You can't sign in if Roo can't bind `localhost:1455`.** The OAuth callback uses a local server; if your machine (or security software) blocks it, the flow can't complete. +6. Save. -## Troubleshooting -#### Not authenticated with OpenAI Codex (or Roo asks you to sign in) +## Tips and Notes -- **Symptom:** Roo fails immediately and tells you to sign in. -- **Cause:** You haven't completed OAuth sign-in, or your stored refresh token was revoked and Roo cleared it. -- **Fix:** In the provider settings panel, click **Sign in to OpenAI Codex** again. -- **Prevention:** Don't delete VS Code extension secrets unless you expect to re-auth. +- **Subscription Required:** You need an active ChatGPT Plus or Pro subscription. This provider won't work with free ChatGPT accounts. See [OpenAI's ChatGPT plans](https://openai.com/chatgpt/pricing) for more info. +- **No API Costs:** Usage through this provider counts against your ChatGPT subscription, not separately billed API usage. +- **Sign Out:** To disconnect, use the "Sign Out" button in the provider settings. -#### Port 1455 is already in use during sign-in - -- **Symptom:** Sign-in fails right away and mentions port `1455`. -- **Cause:** Another process is listening on that port. -- **Fix:** Stop the process using `1455`, then retry sign-in. -- **Prevention:** Avoid running other local OAuth callback servers on the same port. - -#### 403 Forbidden or Model not available - -- **Symptom:** Requests fail with access denied. -- **Cause:** Your ChatGPT subscription or organization doesn't have access to that model. -- **Fix:** Pick a different model, or verify your account/org subscription. -- **Prevention:** Treat the model list in the provider settings as the source of truth. - -#### Cost shows as $0 +## What you can't do (and why) -- **Symptom:** Roo shows usage but cost is zero. -- **Cause:** This provider is subscription-covered, so Roo intentionally reports cost as $0. -- **Fix:** Nothing to fix. -- **Prevention:** Don't treat $0 as “no tokens consumed”; it's “not billed per token in Roo”. +- **You can't use arbitrary OpenAI API models.** This provider only exposes the models listed in Roo's Codex model catalog. +- **You can't export/migrate your sign-in state with settings export.** OAuth tokens are stored in VS Code SecretStorage, which isn't included in Roo's settings export. From 6ba7c7e4c6ef574dcdd757a5ea5b947b54ee2a9d Mon Sep 17 00:00:00 2001 From: Hannes Rudolph Date: Thu, 15 Jan 2026 14:11:09 -0700 Subject: [PATCH 5/5] docs: tweak ChatGPT Plus/Pro labels --- docs/providers/index.json | 18 +++++++++--------- docs/providers/openai-chatgpt-plus-pro.md | 4 ++-- 2 files changed, 11 insertions(+), 11 deletions(-) diff --git a/docs/providers/index.json b/docs/providers/index.json index 3f4175bf..ca79ccd3 100644 --- a/docs/providers/index.json +++ b/docs/providers/index.json @@ -1,23 +1,17 @@ { "providers": [ { - "id": "providers/roo-code-router", - "title": "Roo Code Router", + "id": "providers/anthropic", + "title": "Anthropic", "extension": true, "cloud": true }, { "id": "providers/openai-chatgpt-plus-pro", - "title": "ChatGPT Plus/Pro - OpenAI", + "title": "ChatGPT Plus/Pro", "extension": true, "cloud": false }, - { - "id": "providers/anthropic", - "title": "Anthropic", - "extension": true, - "cloud": true - }, { "id": "providers/claude-code", "title": "Claude Code", @@ -162,6 +156,12 @@ "extension": true, "cloud": false }, + { + "id": "providers/roo-code-router", + "title": "Roo Code Router", + "extension": true, + "cloud": true + }, { "id": "providers/sambanova", "title": "SambaNova", diff --git a/docs/providers/openai-chatgpt-plus-pro.md b/docs/providers/openai-chatgpt-plus-pro.md index d3fc9132..cf591c97 100644 --- a/docs/providers/openai-chatgpt-plus-pro.md +++ b/docs/providers/openai-chatgpt-plus-pro.md @@ -1,6 +1,6 @@ --- -sidebar_label: ChatGPT Plus/Pro - OpenAI -title: ChatGPT Plus/Pro - OpenAI +sidebar_label: ChatGPT Plus/Pro +title: ChatGPT Plus/Pro description: Use OpenAI models in Roo Code with your ChatGPT Plus/Pro subscription (OAuth sign-in, no API key). keywords: - OpenAI Codex