> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getunbound.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Unbound Claude Code for Windows

> Install and configure Unbound Claude Code on Windows for secure AI-powered coding assistance

## What is Unbound Claude Code?

Unbound Claude Code is a command-line interface (CLI) tool that provides AI-powered coding assistance through Claude models, integrated with Unbound Security AI Gateway. This tool allows developers to get coding help, explanations, and suggestions directly from their terminal while maintaining enterprise-grade security, cost control, and compliance.

By using Unbound Claude Code, all your AI requests go through the Unbound Security gateway with proper guardrails, routing, and monitoring.

## Prerequisites

Before installing Unbound Claude Code on Windows, ensure you have:

* **Operating System**: Windows 10+ (with WSL 1, WSL 2, or Git for Windows)
* **Hardware**: 4GB+ RAM
* **Node.js**: Version 18+ installed on your system
* **Unbound API Key**: Get yours at [gateway.getunbound.ai/connect](https://gateway.getunbound.ai/connect)

## Installation Options

### Option 1: WSL Installation (Recommended)

**Using WSL 1 or WSL 2:**

```bash theme={null}
# Install Claude Code globally
npm install -g @anthropic-ai/claude-code

# Navigate to your project
cd your-awesome-project

# Start Claude Code
unbound-claude-code
```

### Option 2: Native Windows with Git Bash

**Using Git for Windows:**

1. Install Git for Windows if not already installed
2. For portable Git installations, set the path:

```powershell theme={null}
$env:CLAUDE_CODE_GIT_BASH_PATH="C:\Program Files\Git\bin\bash.exe"
```

3. Install Claude Code:

```bash theme={null}
npm install -g unbound-claude-code
```

### Option 3: Native Binary Installation (Beta)

**Using PowerShell:**

```powershell theme={null}
# Install stable version (default)
irm https://claude.ai/install.ps1 | iex

# Install latest version
& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) latest

# Install specific version number
& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) 1.0.58
```

**Using CMD:**

```cmd theme={null}
REM Install stable version (default)
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

REM Install latest version
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd latest && del install.cmd

REM Install specific version number
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd 1.0.58 && del install.cmd
```

## Configuration for Unbound

### Step 1: Set Environment Variables

Configure Claude Code to use Unbound Security AI Gateway:

```bash theme={null}
# Set Unbound API configuration
export ANTHROPIC_API_KEY="<UNBOUND_API_KEY>"
export ANTHROPIC_BASE_URL="https://api.getunbound.ai"
```

### Step 2: Start Claude Code

Navigate to your project and start Claude Code:

```bash theme={null}
cd your-awesome-project
unbound-claude-code
```

## Authentication Options

Claude Code offers several authentication methods when using Unbound:

### Option 1: Unbound API Key (Recommended)

Use your Unbound API key directly:

```bash theme={null}
export ANTHROPIC_API_KEY="<UNBOUND_API_KEY>"
export ANTHROPIC_BASE_URL="https://api.getunbound.ai"
unbound-claude-code
```

## Usage

### Basic Commands

Once installed and configured, you can use Claude Code with these commands:

* **`/help`**: Display help information and available commands
* **`/claude`**: Show your current setup and configuration
* **`/exit`**: Exit Claude Code

### Interactive Mode

Start Claude Code in interactive mode:

```bash theme={null}
unbound-claude-code
```

You'll see the welcome screen:

```
🎉 Welcome to Claude Code!
/help for help, /claude for your current setup

Overrides (via env):
• API Base URL: https://api.getunbound.ai
```

## Configuration Management

### Environment Variables

Set these variables in your shell profile for persistent configuration:

**For PowerShell:**

```powershell theme={null}
# Add to your PowerShell profile
$env:ANTHROPIC_API_KEY="<UNBOUND_API_KEY>"
$env:ANTHROPIC_BASE_URL="https://api.getunbound.ai"
```

**For Git Bash:**

```bash theme={null}
# Add to your ~/.bashrc
echo 'export ANTHROPIC_API_KEY="<UNBOUND_API_KEY>"' >> ~/.bashrc
echo 'export ANTHROPIC_BASE_URL="https://api.getunbound.ai"' >> ~/.bashrc
source ~/.bashrc
```

### Configuration File

Create a configuration file for more complex setups:

```bash theme={null}
# Create config directory
mkdir -p ~/.config/claude-code

# Create configuration file
cat > ~/.config/claude-code/config << EOF
ANTHROPIC_API_KEY=<UNBOUND_API_KEY>
ANTHROPIC_BASE_URL=https://api.getunbound.ai
EOF
```

## Troubleshooting

### Common Issues

**Claude Code not found after installation:**

```bash theme={null}
# Check if npm global bin is in your PATH
npm config get prefix
# Add to PATH if needed
export PATH="$(npm config get prefix)/bin:$PATH"
```

**API key not recognized:**

```bash theme={null}
# Verify your environment variables
echo $ANTHROPIC_API_KEY
echo $ANTHROPIC_BASE_URL
```

**Permission issues:**

```bash theme={null}
# Avoid using sudo with npm
# Use npm config to set prefix instead
npm config set prefix ~/.npm-global
export PATH=~/.npm-global/bin:$PATH
```

**WSL-specific issues:**

* Ensure WSL is properly configured
* Check that Node.js is installed in WSL
* Verify network connectivity

## Updates

### Auto Updates

Claude Code automatically keeps itself up to date:

* **Update checks**: Performed on startup and periodically while running
* **Update process**: Downloads and installs automatically in the background
* **Notifications**: You'll see a notification when updates are installed

**Disable auto-updates:**

```bash theme={null}
export DISABLE_AUTOUPDATER=1
```

### Manual Updates

Update Claude Code manually:

```bash theme={null}
unbound-claude-code update
```

<CardGroup cols={2}>
  <Card title="Unbound CLI" icon="terminal" href="/cli/overview">
    Install the CLI to set up and manage tools
  </Card>

  <Card title="Claude Code Integration" icon="wand-magic-sparkles" href="/integrations/claude-code-integration">
    Learn about the general Claude Code integration
  </Card>
</CardGroup>