Claude Code

Claude Code can be configured using environment variables. All modes require a Coder session token for authentication with AI Bridge.

Centralized API Key

# AI Bridge base URL. export ANTHROPIC_BASE_URL="<your-deployment-url>/api/v2/aibridge/anthropic" # Your Coder session token, used for authentication with AI Bridge. export ANTHROPIC_AUTH_TOKEN="<your-coder-session-token>"

BYOK (Personal API Key)

# AI Bridge 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 Bridge. 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)

# AI Bridge base URL. export ANTHROPIC_BASE_URL="<your-deployment-url>/api/v2/aibridge/anthropic" # Your Coder session token, used for authentication with AI Bridge. 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 Bridge base URL into the workspace environment.

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 provides a framework for agents to complete background development operations autonomously. Claude Code can be configured in your Tasks automatically:

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 Bridge (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