You signed in with another tab or window.Reload to refresh your session.You signed out in another tab or window.Reload to refresh your session.You switched accounts on another tab or window.Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/ai-coder/ai-bridge.md
+20-17Lines changed: 20 additions & 17 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -154,26 +154,29 @@ Users can generate a Coder API key using either the CLI or the web UI. Follow th
154
154
155
155
The combinations below reflect what we have exercised so far. Use the upstream links for vendor-specific steps to point each client at Bridge. Share additional findings in the[`aibridge`](https://github.com/coder/aibridge) issue tracker so we can keep this table current.
|[Roo Code (VS Code)](https://github.com/RooVetGit/Roo-Code#configuration)| ✅| ✅| Use the**OpenAI Compatible** provider with the legacy format to avoid`/v1/responses`. Some MCP tools (for example`star_github_repository`) may require additional permissions.|
|[Claude Code (VS Code)](https://marketplace.visualstudio.com/items?itemName=Anthropic.claude-vscode)| N/A| ✅| May require signing in once; afterwards respects workspace environment variables.|
164
-
|[Cursor](https://cursor.com/docs/settings/api-keys)| ⚠️| ❌| Only non reasoning models like`gpt-4.1` are available when using a custom endpoint. Requests still transit Cursor's cloud. There is no central admin setting to configure this.|
165
-
|WindSurf| ❌|—|No option to override the base URL.|
166
-
|Sourcegraph Amp| ❌|—|No option to override the base URL.|
167
-
|Codex CLI| ⚠️| N/A|`gpt-5-codex` support is[in progress](https://github.com/coder/aibridge/issues/16).|
168
-
|[GitHub Copilot (VS Code)](https://code.visualstudio.com/docs/copilot/customization/language-models#_use-an-openaicompatible-model)| ✅| ❌| Only OpenAI-compatible models are supported.|
169
-
| Kiro| ❌| —| No option to override the base URL.|
170
-
|[Copilot CLI](https://github.com/github/copilot-cli/issues/104)| ❌| ❌|Cannot override thebaseURL anduse a`GITHUB_TOKEN` for authentication.|
|[Claude Code](https://docs.claude.com/en/docs/claude-code/settings#environment-variables)| N/A| ✅| Works out of the box and can be preconfigured in templates.|
|[Cursor](https://cursor.com/docs/settings/api-keys)| ⚠️| ❌|Only non reasoning models like`gpt-4.1` are available when using a custom endpoint. Requests still transit Cursor's cloud. There is no central admin setting to configure this.|
162
+
|[Roo Code](https://docs.roocode.com/features/api-configuration-profiles#creating-and-managing-profiles)| ✅| ✅| Use the**OpenAI Compatible** provider with the legacy format to avoid`/v1/responses`.|
163
+
|[Codex CLI](https://github.com/openai/codex/blob/main/docs/config.md#model_providers)| ✅| N/A|`gpt-5-codex` support is[in progress](https://github.com/coder/aibridge/issues/16).|
164
+
|[GitHub Copilot (VS Code)](https://docs.github.com/en/copilot/configuring-github-copilot/configuring-network-settings-for-github-copilot)| ✅| ❌| Requires the pre-release extension. Anthropic endpoints are not supported.|
165
+
|Goose| ❓|❓||
166
+
|Goose Desktop| ❓|✅||
167
+
|WindSurf| ❌| —| No option to override the base URL.|
168
+
|Sourcegraph Amp| ❌| —| No option to override the base URL.|
169
+
| Kiro| ❌| —| No option to override the base URL.|
170
+
|[Copilot CLI](https://github.com/github/copilot-cli/issues/104)| ❌| ❌|No support for custombaseURLs anduses a`GITHUB_TOKEN` for authentication.|
171
+
|[Kilo Code](https://kilocode.ai/docs/features/api-configuration-profiles#creating-and-managing-profiles)| ✅| ✅| Similar to Roo Code.|
172
+
| Gemini CLI| ❌| ❌| Not supported yet (`GOOGLE_GEMINI_BASE_URL`).|
173
+
|[Amazon Q CLI](https://aws.amazon.com/q/)| ❌| ❌| Limited to Amazon Q subscriptions; no custom endpoint support.|
174
174
175
175
Legend: ✅ works, ⚠️ limited support, ❌ not supported, ❓ not yet verified, — not applicable.
176
176
177
+
>[!NOTE]
178
+
>Click the respective client title to view the vendor-specific instructions for configuring the client.
179
+
177
180
####Compatibility overview
178
181
179
182
Most AI coding assistants that support custom base URLs can work with AI Bridge. Client-specific requirements vary: