HomeRun AI Coding Agents in CoderAI Governance Add-OnAI BridgeClient Configuration

Client Configuration

On this page

Once AI Bridge is setup on your deployment, the AI coding tools used by your users will need to be configured to route requests via AI Bridge.

There are two ways to connect AI tools to AI Bridge:

Base URL configuration (Recommended): Most AI tools allow customizing the base URL for API requests. This is the preferred approach when supported.
AI Bridge Proxy: For tools that don't support base URL configuration, AI Bridge Proxy can intercept traffic and forward it to AI Bridge.

Base URLs

Most AI coding tools allow the "base URL" to be customized. In other words, when a request is made to OpenAI's API from your coding tool, the API endpoint such as /v1/chat/completions will be appended to the configured base. Therefore, instead of the default base URL of https://api.openai.com/v1, you'll need to set it to https://coder.example.com/api/v2/aibridge/openai/v1.

The exact configuration method varies by client — some use environment variables, others use configuration files or UI settings:

OpenAI-compatible clients: Set the base URL (commonly via the OPENAI_BASE_URL environment variable) to https://coder.example.com/api/v2/aibridge/openai/v1
Anthropic-compatible clients: Set the base URL (commonly via the ANTHROPIC_BASE_URL environment variable) to https://coder.example.com/api/v2/aibridge/anthropic

Replace coder.example.com with your actual Coder deployment URL.

Authentication

Instead of distributing provider-specific API keys (OpenAI/Anthropic keys) to users, they authenticate to AI Bridge using their Coder session token or API key:

OpenAI clients: Users set OPENAI_API_KEY to their Coder session token or API key
Anthropic clients: Users set ANTHROPIC_API_KEY to their Coder session token or API key

Note

Only Coder-issued tokens can authenticate users against AI Bridge. AI Bridge will use provider-specific API keys to authenticate against upstream AI services.

Again, the exact environment variable or setting naming may differ from tool to tool. See a list of supported clients below and consult your tool's documentation for details.

Retrieving your session token

If you're logged in with the Coder CLI, you can retrieve your current session token using coder login token:

export ANTHROPIC_API_KEY=$(coder login token)
export ANTHROPIC_BASE_URL="https://coder.example.com/api/v2/aibridge/anthropic"

Alternatively, generate a long-lived API token via the Coder dashboard.

Bring Your Own Key (BYOK)

In addition to centralized key management, AI Bridge supports Bring Your Own Key (BYOK) mode. Users can provide their own LLM API keys or use provider subscriptions (such as Claude Pro/Max or ChatGPT Plus/Pro) while AI Bridge continues to provide observability and governance.

BYOK authentication flow

In BYOK mode, users need two credentials:

A Coder session token to authenticate with AI Bridge.
Their own LLM credential (personal API key or subscription token) which AI Bridge forwards to the upstream provider.

BYOK and centralized modes can be used together. When a user provides their own credential, AI Bridge forwards it directly. When no user credential is present, AI Bridge falls back to the admin-configured provider key. This lets organizations offer centralized keys as a default while allowing individual users to bring their own.

See individual client pages for configuration details.

Compatibility

The table below shows tested AI clients and their compatibility with AI Bridge.

Client	OpenAI	Anthropic	Notes
Mux	✅	✅
Claude Code	-	✅
Codex CLI	✅	-
OpenCode	✅	✅
Factory	✅	✅
Cline	✅	✅
Kilo Code	✅	✅
Roo Code	✅	✅
VS Code	✅	❌	Only supports Custom Base URL for OpenAI.
JetBrains IDEs	✅	❌	Works in Chat mode via "Bring Your Own Key".
Zed	✅	✅
GitHub Copilot	⚙️	-	Requires AI Bridge Proxy. Uses per-user GitHub tokens.
WindSurf	❌	❌	No option to override base URL.
Cursor	❌	❌	Override for OpenAI broken (upstream issue).
Sourcegraph Amp	❌	❌	No option to override base URL.
Kiro	❌	❌	No option to override base URL.
Gemini CLI	❌	❌	No Gemini API support. Upvote this issue.
Antigravity	❌	❌	No option to override base URL.

Legend: ✅ supported, ⚙️ requires AI Bridge Proxy, ❌ not supported, - not applicable.

Configuring In-Workspace Tools

AI coding tools running inside a Coder workspace, such as IDE extensions, can be configured to use AI Bridge.

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.

In this example, Claude Code respects these environment variables and will route all requests via AI Bridge.

data "coder_workspace_owner" "me" {}

data "coder_workspace" "me" {}

resource "coder_agent" "dev" {
    arch = "amd64"
    os   = "linux"
    dir  = local.repo_dir
    env = {
        ANTHROPIC_BASE_URL : "${data.coder_workspace.me.access_url}/api/v2/aibridge/anthropic",
        ANTHROPIC_AUTH_TOKEN : data.coder_workspace_owner.me.session_token
    }
    ... # other agent configuration
}