mirror of
https://github.com/coder/coder.git
synced 2026-10-30 18:12:29 +08:00
Danny Kopping
7a94a683c4
*Disclaimer: implemented by a Coder Agent using Claude Opus 4.6* ## Summary Renames product references across documentation: | Old Name | New Name | |----------|----------| | AI Bridge | AI Gateway | | AI Bridge Proxy | AI Gateway Proxy | | Agent Boundaries | Agent Firewall | ## What changed - Prose text, headings, titles, and descriptions updated across all docs - Directories renamed: - `docs/ai-coder/ai-bridge/` → `docs/ai-coder/ai-gateway/` - `docs/ai-coder/ai-bridge/ai-bridge-proxy/` → `docs/ai-coder/ai-gateway/ai-gateway-proxy/` - `docs/ai-coder/agent-boundaries/` → `docs/ai-coder/agent-firewall/` - All internal markdown links updated to new paths - `manifest.json` route paths updated - Rename notice added to AI Gateway and Agent Firewall entrypoint pages ## Companion PR URL redirects (old paths → new paths): [coder/coder.com#700](https://github.com/coder/coder.com/pull/700) ## What is intentionally NOT changed - **Env vars**: `CODER_AIBRIDGE_*` - **CLI flags**: `--aibridge-*` - **API paths**: `/api/v2/aibridge/*` - **Config keys**: `aibridge:` YAML blocks - **Terraform variables**: `enable_aibridge`, `boundary_version`, `use_boundary_directly` - **Process names**: `aibridged`, `aibridgeproxyd` - **Prometheus metrics**: `coder_aibridged_*`, `coder_aibridgeproxyd_*` - **SDK types**: `codersdk.AIBridge*` - **GitHub URLs**: `github.com/coder/aibridge` - **Image paths**: `images/aibridge/` - **Auto-generated reference docs**: `docs/reference/cli/aibridge*.md`, `docs/reference/api/aibridge.md`, `docs/reference/api/schemas.md` - **Frontend code**: `site/src/` references (separate PR) Code-level renames (env vars, configs, frontend) are planned for a follow-up PR.
93 lines
3.0 KiB
Markdown
93 lines
3.0 KiB
Markdown
# Claude Code
|
|
|
|
Claude Code can be configured using environment variables. All modes require a **[Coder session token](../../../admin/users/sessions-tokens.md#generate-a-long-lived-api-token-on-behalf-of-yourself)** for authentication with AI Gateway.
|
|
|
|
## Centralized API Key
|
|
|
|
```bash
|
|
# AI Gateway base URL.
|
|
export ANTHROPIC_BASE_URL="<your-deployment-url>/api/v2/aibridge/anthropic"
|
|
|
|
# Your Coder session token, used for authentication with AI Gateway.
|
|
export ANTHROPIC_AUTH_TOKEN="<your-coder-session-token>"
|
|
```
|
|
|
|
## BYOK (Personal API Key)
|
|
|
|
```bash
|
|
# AI Gateway base URL.
|
|
export ANTHROPIC_BASE_URL="<your-deployment-url>/api/v2/aibridge/anthropic"
|
|
|
|
# Your personal Anthropic API key, forwarded to Anthropic.
|
|
export ANTHROPIC_API_KEY="<your-anthropic-api-key>"
|
|
|
|
# Your Coder session token, used for authentication with AI Gateway.
|
|
export ANTHROPIC_CUSTOM_HEADERS="X-Coder-AI-Governance-Token: <your-coder-session-token>"
|
|
|
|
# Ensure no auth token is set so Claude Code uses the API key instead.
|
|
unset ANTHROPIC_AUTH_TOKEN
|
|
```
|
|
|
|
## BYOK (Claude Subscription)
|
|
|
|
```bash
|
|
# AI Gateway base URL.
|
|
export ANTHROPIC_BASE_URL="<your-deployment-url>/api/v2/aibridge/anthropic"
|
|
|
|
# Your Coder session token, used for authentication with AI Gateway.
|
|
export ANTHROPIC_CUSTOM_HEADERS="X-Coder-AI-Governance-Token: <your-coder-session-token>"
|
|
|
|
# Ensure no auth token is set so Claude Code uses subscription login instead.
|
|
unset ANTHROPIC_AUTH_TOKEN
|
|
```
|
|
|
|
When you run Claude Code, it will prompt you to log in with your Anthropic
|
|
account.
|
|
|
|
## Pre-configuring in Templates
|
|
|
|
Template admins can pre-configure Claude Code for a seamless experience. Admins can automatically inject the user's Coder session token and the AI Gateway base URL into the workspace environment.
|
|
|
|
```hcl
|
|
module "claude-code" {
|
|
source = "registry.coder.com/coder/claude-code/coder"
|
|
version = "4.7.3"
|
|
agent_id = coder_agent.main.id
|
|
workdir = "/path/to/project" # Set to your project directory
|
|
enable_aibridge = true
|
|
}
|
|
```
|
|
|
|
### Coder Tasks
|
|
|
|
[Coder Tasks](../../tasks.md) provides a framework for agents to complete background development operations autonomously. Claude Code can be configured in your Tasks automatically:
|
|
|
|
```hcl
|
|
resource "coder_ai_task" "task" {
|
|
count = data.coder_workspace.me.start_count
|
|
app_id = module.claude-code.task_app_id
|
|
}
|
|
|
|
data "coder_task" "me" {}
|
|
|
|
module "claude-code" {
|
|
source = "registry.coder.com/coder/claude-code/coder"
|
|
version = "4.7.3"
|
|
agent_id = coder_agent.main.id
|
|
workdir = "/path/to/project" # Set to your project directory
|
|
ai_prompt = data.coder_task.me.prompt
|
|
|
|
# Route through AI Gateway (Premium feature)
|
|
enable_aibridge = true
|
|
}
|
|
```
|
|
|
|
## VS Code Extension
|
|
|
|
The Claude Code VS Code extension is also supported.
|
|
|
|
1. If pre-configured in the workspace environment variables (as shown above), it typically respects them.
|
|
2. You may need to sign in once; afterwards, it respects the workspace environment variables.
|
|
|
|
**References:** [Claude Code Settings](https://docs.claude.com/en/docs/claude-code/settings#environment-variables)
|