Movatterモバイル変換

[0]ホーム
URL:

Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

 Sign up
Appearance settings

Commit086d6b8

Browse files
chore(docs): update links and minor improvements to AI Bridge (#20714)
Co-authored-by: Danny Kopping <danny@coder.com>
1 parentf1fad60 commit086d6b8

File tree

5 files changed

+52
-36
lines changed

5 files changed

+52
-36
lines changed

‎docs/ai-coder/ai-bridge/client-config.md‎

Lines changed: 41 additions & 26 deletions
Original file line numberDiff line numberDiff line change
@@ -24,7 +24,30 @@ Again, the exact environment variable or setting naming may differ from tool to
2424

2525
##Configuring In-Workspace Tools
2626

27-
Template admins can pre-configure workspaces to route all AI tool requests through AI Bridge, providing a seamless and secure experience for users. This can be done for both Coder Tasks and other AI tools running in the workspace.
27+
AI coding tools running inside a Coder workspace, such as IDE extensions, can be configured to use AI Bridge.
28+
29+
While users can manually configure these tools with a long-lived API key, template admins can provide a more seamless experience by pre-configuring them. Admins can automatically inject the user's session token with`data.coder_workspace_owner.me.session_token` and the AI Bridge base URL into the workspace environment.
30+
31+
In this example, Claude code respects these environment variables and will route all requests via AI Bridge.
32+
33+
This is the fastest way to bring existing agents like Roo Code, Cursor, or Claude Code into compliance without adopting Coder Tasks.
34+
35+
```hcl
36+
data "coder_workspace_owner" "me" {}
37+
38+
data "coder_workspace" "me" {}
39+
40+
resource "coder_agent" "dev" {
41+
arch = "amd64"
42+
os = "linux"
43+
dir = local.repo_dir
44+
env = {
45+
ANTHROPIC_BASE_URL : "${data.coder_workspace.me.url}/api/v2/aibridge/anthropic",
46+
ANTHROPIC_AUTH_TOKEN : data.coder_workspace_owner.me.session_token
47+
}
48+
... # other agent configuration
49+
}
50+
```
2851

2952
###Using Coder Tasks
3053

@@ -59,14 +82,6 @@ module "claude-code" {
5982
}
6083
```
6184

62-
###Other IDEs and Tools
63-
64-
AI coding tools running inside a Coder workspace, such as IDE extensions, can be configured to use AI Bridge.
65-
66-
While users can manually configure these tools with a long-lived API key, template admins can provide a more seamless experience by pre-configuring them. Similar to the Coder Tasks example, admins can use Terraform data sources like`data.coder_workspace_owner.me.session_token` to automatically inject the user's session token and the AI Bridge base URL into the workspace environment.
67-
68-
This is the fastest way to bring existing agents like Roo Code, Cursor, or Claude Code into compliance without adopting Coder Tasks.
69-
7085
##External and Desktop Clients
7186

7287
You can also configure AI tools running outside of a Coder workspace, such as local IDE extensions or desktop applications, to connect to AI Bridge.
@@ -79,23 +94,23 @@ Users can generate a long-lived API key from the Coder UI or CLI. Follow the ins
7994

8095
The table below shows tested AI clients and their compatibility with AI Bridge. Click each client name for vendor-specific configuration instructions. Report issues or share compatibility updates in the[aibridge](https://github.com/coder/aibridge) issue tracker.
8196

82-
| Client| OpenAI support| Anthropic support| Notes|
83-
|-------------------------------------------------------------------------------------------------------------------------------------------|----------------|-------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
84-
|[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.|
85-
| Claude Code (VS Code)| N/A| ✅| May require signing in once; afterwards respects workspace environment variables.|
86-
|[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.|
87-
|[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`.|
88-
|[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).|
89-
|[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.|
90-
| Goose| ❓| ❓||
91-
| Goose Desktop| ❓| ✅||
92-
| WindSurf| ❌| —| No option to override the base URL.|
93-
| Sourcegraph Amp| ❌| —| No option to override the base URL.|
94-
| Kiro| ❌| —| No option to override the base URL.|
95-
|[Copilot CLI](https://github.com/github/copilot-cli/issues/104)| ❌| ❌| No support for custom base URLs and uses a`GITHUB_TOKEN` for authentication.|
96-
|[Kilo Code](https://kilocode.ai/docs/features/api-configuration-profiles#creating-and-managing-profiles)| ✅| ✅| Similar to Roo Code.|
97-
| Gemini CLI| ❌| ❌| Not supported yet (`GOOGLE_GEMINI_BASE_URL`).|
98-
|[Amazon Q CLI](https://aws.amazon.com/q/)| ❌| ❌| Limited to Amazon Q subscriptions; no custom endpoint support.|
97+
| Client| OpenAI support| Anthropic support| Notes|
98+
|-------------------------------------------------------------------------------------------------------------------------------------|----------------|-------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
99+
|[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.|
100+
| Claude Code (VS Code)| N/A| ✅| May require signing in once; afterwards respects workspace environment variables.|
101+
|[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.|
102+
|[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`.|
103+
|[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).|
104+
|[GitHub Copilot (VS Code)](https://code.visualstudio.com/docs/copilot/customization/language-models#_use-an-openaicompatible-model)| ✅| ❌| Requires the pre-release extension. Anthropic endpoints are not supported.|
105+
|[Goose](https://block.github.io/goose/docs/getting-started/providers/#available-providers)| ❓| ❓||
106+
|[Goose Desktop](https://block.github.io/goose/docs/getting-started/providers/#available-providers)| ❓| ✅||
107+
| WindSurf| ❌| —| No option to override the base URL.|
108+
| Sourcegraph Amp| ❌| —| No option to override the base URL.|
109+
| Kiro| ❌| —| No option to override the base URL.|
110+
|[Copilot CLI](https://github.com/github/copilot-cli/issues/104)| ❌| ❌| No support for custom base URLs and uses a`GITHUB_TOKEN` for authentication.|
111+
|[Kilo Code](https://kilocode.ai/docs/features/api-configuration-profiles#creating-and-managing-profiles)| ✅| ✅| Similar to Roo Code.|
112+
| Gemini CLI| ❌| ❌| Not supported yet.|
113+
|[Amazon Q CLI](https://aws.amazon.com/q/)| ❌| ❌| Limited to Amazon Q subscriptions; no custom endpoint support.|
99114

100115
Legend: ✅ works, ⚠️ limited support, ❌ not supported, ❓ not yet verified, — not applicable.
101116

‎docs/ai-coder/ai-bridge/index.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -11,9 +11,9 @@ AI Bridge solves 3 key problems:
1111
1.**Centralized authn/z management**: no more issuing & managing API tokens for OpenAI/Anthropic usage.
1212
Users use their Coder session or API tokens to authenticate with`coderd` (Coder control plane), and
1313
`coderd` securely communicates with the upstream APIs on their behalf.
14-
2.**Auditing and attribution**: all interactions with AI services, whether autonomous or human-initiated,
14+
1.**Auditing and attribution**: all interactions with AI services, whether autonomous or human-initiated,
1515
will be audited and attributed back to a user.
16-
3.**Centralized MCP administration**: define a set of approved MCP servers and tools which your users may
16+
1.**Centralized MCP administration**: define a set of approved MCP servers and tools which your users may
1717
use.
1818

1919
##When to use AI Bridge

‎docs/ai-coder/ai-bridge/mcp.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -63,4 +63,4 @@ If you have the `oauth2` and `mcp-server-http` experiments enabled, Coder's own
6363
6464
- **Coder MCP tools not being injected**: in order for Coder MCP tools to be injected, the internal MCP server needs to be active. Follow the instructions in the [MCP Server](../mcp-server.md) page to enable it.
6565
66-
- **External Auth tools not being injected**: this is generally due to the requesting user not being authenticated against the External Auth app; when this is the case, no attempt is made to connect to the MCP server.
66+
- **External Auth tools not being injected**: this is generally due to the requesting user not being authenticated against the[External Auth](../../admin/external-auth/index.md) app; when this is the case, no attempt is made to connect to the MCP server.

‎docs/ai-coder/ai-bridge/reference.md‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -17,22 +17,22 @@ Where relevant, both streaming and non-streaming requests are supported.
1717

1818
###OpenAI
1919

20-
**Intercepted**:
20+
####Intercepted
2121

2222
-[`/v1/chat/completions`](https://platform.openai.com/docs/api-reference/chat/create)
2323

24-
**Passthrough**:
24+
####Passthrough
2525

2626
-[`/v1/models(/*)`](https://platform.openai.com/docs/api-reference/models/list)
2727
-[`/v1/responses`](https://platform.openai.com/docs/api-reference/responses/create)_(Interception support coming in**Beta**)_
2828

2929
###Anthropic
3030

31-
**Intercepted**:
31+
####Intercepted
3232

3333
-[`/v1/messages`](https://docs.claude.com/en/api/messages)
3434

35-
**Passthrough**:
35+
####Passthrough
3636

3737
-[`/v1/models(/*)`](https://docs.claude.com/en/api/models-list)
3838

‎docs/manifest.json‎

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -948,9 +948,10 @@
948948
"path":"./ai-coder/ai-bridge/client-config.md"
949949
},
950950
{
951-
"title":"MCP",
952-
"description":"How to use AI Bridge with MCP",
953-
"path":"./ai-coder/ai-bridge/mcp.md"
951+
"title":"MCP Tools Injection",
952+
"description":"How to configure MCP servers for tools injection through AI Bridge",
953+
"path":"./ai-coder/ai-bridge/mcp.md",
954+
"state": ["early access"]
954955
},
955956
{
956957
"title":"Monitoring",

0 commit comments

Comments
 (0)
[8]ページ先頭
©2009-2025 Movatter.jp