docs/cli-agents/claude-code.mdx

---
title: "Claude Code"
description: "Use Claude Code with Bifrost to route through any provider and unlock advanced features like MCP tools and observability."
icon: "star-of-life"
---

[Claude Code](https://www.claude.com/product/claude-code) brings AI-powered coding capabilities directly to your terminal.

<Note>
If your Allowed Headers are already set to `*`, you can skip this note. If not and you face issues integrating Bifrost with Claude Code, try switching to `*` or adding the specific headers required by your client. By default, Bifrost whitelists: `Content-Type`, `Authorization`, `X-Requested-With`, `X-Stainless-Timeout`, and `X-Api-Key`.
</Note>

## To install Claude code

```bash
npm install -g @anthropic-ai/claude-code
```

## Configuring Claude Code to work with Bifrost

Claude Code supports multiple authentication methods. Choose the one that matches your account type.

1. **Set environment variables**
   ```bash
   export ANTHROPIC_API_KEY=your-bifrost-virtual-key  # or "dummy" if virtual keys are not enabled
   export ANTHROPIC_BASE_URL=http://localhost:8080/anthropic
   ```

2. **Run Claude Code**
```bash
claude
```

## Amazon Bedrock via Bifrost

### Setup

Configure environment variables 

```bash
   export ANTHROPIC_API_KEY=bifrost-virtual-key
   export ANTHROPIC_BASE_URL=http://localhost:8080/anthropic
```

### Pin model versions (recommended)

```bash
export ANTHROPIC_DEFAULT_SONNET_MODEL="bedrock/global.anthropic.claude-sonnet-4-6"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="bedrock/global.anthropic.claude-haiku-4-5-20251001-v1:0"
```

If you don't pin using CLI - you can pin these in UI. Go to Dashboard > Models > Model Providers > AWS Bedrock > Key. And add deployments


<Frame>
   <img src="/media/cli/claude-bedrock-pinning.png" alt="Claude bedrock pinning" />
</Frame>



### Start Claude Code
```
claude
```

<Warning>
Always pin model versions with `ANTHROPIC_DEFAULT_*_MODEL` when using Bedrock. Without pinning, Claude Code aliases resolve to the latest version, which may not be enabled in your Bedrock account.
</Warning>

## Google Vertex AI via Bifrost

### Setup

Configure environment variables 

```bash
   export ANTHROPIC_API_KEY=bifrost-virtual-key
   export ANTHROPIC_BASE_URL=http://localhost:8080/anthropic
```

### Pin model versions (recommended)

```bash
export ANTHROPIC_DEFAULT_SONNET_MODEL="vertex/claude-sonnet-4-6"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="vertex/claude-haiku-4-5"
```

### Start Claude Code
```
claude
```

## Azure via Bifrost

### Setup

Configure environment variables 

```bash
   export ANTHROPIC_API_KEY=bifrost-virtual-key
   export ANTHROPIC_BASE_URL=http://localhost:8080/anthropic
```

### Pin model versions (recommended)

```bash
export ANTHROPIC_DEFAULT_SONNET_MODEL="azure/claude-sonnet-4-6"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="azure/claude-haiku-4-5"
```

You will also have to map these model names to actual deployment names on Bifrost dashboard.

<Frame>
   <img src="/media/cli/claude-azure-pinning.png" alt="Claude bedrock pinning" />
</Frame>


### Start Claude Code
```
claude
```

<Warning>
Azure-hosted models must support **tool use capabilities** for Claude Code to function properly. Verify tool calling support before configuring Azure models.
</Warning>

## Model Configuration

Claude Code uses three model tiers: **Sonnet** (default), **Opus** (complex tasks), and **Haiku** (fast, lightweight). With Bifrost, you can override these defaults to use any model from any provider.

**Override Default Models:**

Set environment variables to replace Claude Code's default model tiers with any Bifrost-configured model:

```bash
# Replace Sonnet tier with GPT-5
export ANTHROPIC_DEFAULT_SONNET_MODEL="openai/gpt-5"

# Replace Opus tier with Claude Opus 4.5
export ANTHROPIC_DEFAULT_OPUS_MODEL="anthropic/claude-opus-4-5-20251101"

# Replace Haiku tier with Azure-hosted Claude
export ANTHROPIC_DEFAULT_HAIKU_MODEL="azure/claude-haiku-4-5"
```

<Warning>
Alternative models must support **tool use capabilities** for file operations, terminal commands, and code editing to work properly with Claude Code.
</Warning>

**Start with a Specific Model:**

Launch Claude Code with a specific model using the `--model` flag:

```bash
# Start with Opus
claude --model claude-opus-4-5-20251101

# Start with Haiku for lightweight tasks
claude --model claude-haiku-4-5-20251001
```

## Switching Models Mid-Session

Use the `/model` command to switch models during an active session:

```bash
# Using full model names
/model claude-opus-4-5-20251101 # This will be used from anthropic provider
/model claude-sonnet-4-5-20250929 # This will be used from anthropic provider

# Using different providers dynamically via Bifrost
/model vertex/claude-haiku-4-5
/model azure/claude-sonnet-4-5
/model bedrock/claude-sonnet-4-5
```

<Tip>
Run `/model` without arguments to check your current model. The switch is instantaneous and Claude Code seamlessly continues your conversation context with the new model.
</Tip>

<Warning>
If you use Claude-specific features like **web search**, **computer use**, or **citations**, ensure the model you switch to also supports these capabilities. Non-Claude models or Claude models on certain providers may not support all features.
</Warning>

## Provider Compatibility

<Warning>
**Not all providers work well with Claude Code**. Since Claude Code heavily relies on tool calling for file operations, terminal commands, and code editing, providers must properly support and stream tool call arguments.

**Known Issues:**
- **OpenRouter**: Does not stream function call arguments properly. Tool calls return with empty `arguments` fields, causing Claude Code to fail when attempting file operations or other tool-based actions.
- **Some proxy providers**: May not fully implement the Anthropic API streaming specification for tool calls.

If you experience issues with tool calls not executing properly, try switching to a different provider in your Bifrost configuration.
</Warning>