Skip to content

docs: add AI Bridge Proxy client configuration#21904

Merged
ssncferreira merged 5 commits intomainfrom
docs-aibridge-proxy-client-config
Feb 5, 2026
Merged

docs: add AI Bridge Proxy client configuration#21904
ssncferreira merged 5 commits intomainfrom
docs-aibridge-proxy-client-config

Conversation

@ssncferreira
Copy link
Contributor

@ssncferreira ssncferreira commented Feb 3, 2026

Description

This PR adds documentation for configuring clients to work with AI Bridge via AI Bridge Proxy, specifically GitHub Copilot.

Preview: https://coder.com/docs/@docs-aibridge-proxy-client-config/ai-coder/ai-bridge/ai-bridge-proxy/setup#client-configuration

Changes

  • Add Client Configuration section to docs/ai-coder/ai-bridge/ai-bridge-proxy/setup.md covering proxy and CA certificate configuration
  • Add docs/ai-coder/ai-bridge/clients/copilot.md with configuration instructions for: Copilot CLI, VS Code Copilot Extension, JetBrains IDEs
  • Update docs/ai-coder/ai-bridge/clients/index.md:
    • Add introduction explaining base URL vs proxy-based integration
    • Add GitHub Copilot to compatibility table

Related to: coder/internal#1188

Copy link
Contributor Author

This stack of pull requests is managed by Graphite. Learn more about stacking.

@ssncferreira ssncferreira force-pushed the docs-aibridge-proxy-client-config branch from 961fe43 to 7ced267 Compare February 3, 2026 19:18
@ssncferreira ssncferreira marked this pull request as ready for review February 3, 2026 19:25
@ssncferreira ssncferreira force-pushed the docs-aibridge-proxy-client-config branch from 7ced267 to 3b68147 Compare February 3, 2026 19:29
Copy link
Member

@matifali matifali left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

A few nits for overall consistency but looks good to me.

| [VS Code](./vscode.md) | ✅ | ❌ | Only supports Custom Base URL for OpenAI. |
| [JetBrains IDEs](./jetbrains.md) | ✅ | ❌ | Works in Chat mode via "Bring Your Own Key". |
| [Zed](./zed.md) | ✅ | ✅ | |
| [GitHub Copilot](./copilot.md) | ⚙️ | - | Requires [AI Bridge Proxy](../ai-bridge-proxy/index.md). Uses per-user GitHub tokens. |
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Doesn't Anthropic models work through Proxy?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot supports OpenAI and Anthropic models, but all the tests that I ran, always used OpenAI compatible endpoints, never Anthropic endpoints, even for anthropic models. Is this table to represent that it supports OpenAI/Anthropic models or that it uses OpenAI/Anthropic compatible endpoints?

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Well we originally laid it for showing support for endpoints but stuff has changed with AI Proxy.

Copy link
Contributor

@dannykopping dannykopping left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Generally LGTM, great docs!


### Trusting the CA certificate

The preferred approach is to configure the CA certificate directly in the AI tool's settings, as this limits the scope of the trusted certificate to that specific application.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Follow-up: we may need to add client-specific instructions for this. We could add a section the the client-specific docs we already have.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We have specific instructions for this for copilot. Do you mean for all the other tools, like claude, codex, ...?


This means:

* Proxy configuration: Make sure the `HTTP_PROXY` and `HTTPS_PROXY` environment variables are properly set in your workspace, as the `http.proxy` VS Code setting is for the local machine.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is this true? Didn't we see the other day that you can adjust these settings under the "Remote" settings?

image

Copy link
Member

@matifali matifali Feb 4, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think we can set these settings on the remote side too. Would be nice to validate @ssncferreira

When vscode://settings/http.useLocalProxyConfiguration is disabled,d VS Code respects vscode://settings/http.proxy on the remote side.

{
  "http.proxy": ""
}

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This section was updated in a62a8fe with the Remote settings config.

I thought I managed to test it with the HTTP_PROXY and HTTPS_PROXY env variables, but I might have misconfigured something, because I retried it and couldn't (and managed to break my VS Code in the process 😅 ). The updated section was tested properly and is working ✅

@ssncferreira ssncferreira force-pushed the docs-aibridge-proxy-client-config branch from 42b4bfe to a62a8fe Compare February 5, 2026 16:31
@ssncferreira ssncferreira merged commit e3f7850 into main Feb 5, 2026
33 checks passed
@ssncferreira ssncferreira deleted the docs-aibridge-proxy-client-config branch February 5, 2026 16:54
@github-actions github-actions bot locked and limited conversation to collaborators Feb 5, 2026
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants