​
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 Application: A configured application in your Unbound Security dashboard
  • Unbound API Key: Generated from your application settings

​
Installation Options

Using WSL 1 or WSL 2: 
# 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:
$env:CLAUDE_CODE_GIT_BASH_PATH="C:\Program Files\Git\bin\bash.exe"
  1. Install Claude Code:
npm install -g unbound-claude-code

​
Option 3: Native Binary Installation (Beta)

Using PowerShell: 
# 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: 
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: 
# 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: 
cd your-awesome-project
unbound-claude-code

​
Authentication Options

Claude Code offers several authentication methods when using Unbound: Use your Unbound API key directly: 
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: 
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: 
# Add to your PowerShell profile
$env:ANTHROPIC_API_KEY="<UNBOUND_API_KEY>"
$env:ANTHROPIC_BASE_URL="https://api.getunbound.ai"
For Git Bash: 
# 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: 
# 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: 
# 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: 
# Verify your environment variables
echo $ANTHROPIC_API_KEY
echo $ANTHROPIC_BASE_URL
Permission issues: 
# 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: 
export DISABLE_AUTOUPDATER=1

​
Manual Updates

Update Claude Code manually: 
unbound-claude-code update

Create Application

Set up your Unbound application to get API access

Claude Code Integration

Learn about the general Claude Code integration