Claude Code

Claude Code is Anthropic's official CLI. The console's one-click setup installs and configures it with one command. You can also set the environment variables manually.

Recommended: one-click setup from the console

No environment-variable knowledge is required. Windows, macOS, and Linux are supported.

Find the one-click button

Copy the command for your system

Select Claude Code, choose macOS / Linux or Windows PowerShell, then copy the command.

Paste it into a terminal and press Enter

On macOS, open Terminal. On Windows, open PowerShell. The script installs Claude Code if needed, backs up existing configuration, writes the HopBase settings, and verifies the connection.

Start Claude Code

After setup succeeds, open a new terminal window and run claude.

The command contains a single-use integration token that expires after 15 minutes, not the API key itself.

Desktop setup with CC Switch

CC Switch is a free desktop application for Windows and macOS that manages multiple provider configurations. HopBase supports one-click import.

Install CC Switch

Download the .msi for Windows or .dmg for macOS. If Windows SmartScreen appears, select More info, then Run anyway.

Import from the console

In Key Management, select Import to CCS beside the key, then choose Claude Code. The browser opens CC Switch with the URL and key prefilled.

Enable the configuration

Select Enable in CC Switch. Configurations can be switched without restarting the terminal.

Manual setup on macOS or Linux

Temporary settings apply only to the current terminal window:

export ANTHROPIC_BASE_URL=https://api.hop-base.com
export ANTHROPIC_AUTH_TOKEN=sk-your-key

claude

For persistent settings, add the variables to your shell startup file:

# zsh (the macOS default)
echo 'export ANTHROPIC_BASE_URL=https://api.hop-base.com' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN=sk-your-key' >> ~/.zshrc
source ~/.zshrc

# bash (common on Linux; use this instead of the zsh block)
echo 'export ANTHROPIC_BASE_URL=https://api.hop-base.com' >> ~/.bashrc
echo 'export ANTHROPIC_AUTH_TOKEN=sk-your-key' >> ~/.bashrc
source ~/.bashrc

Manual setup on Windows PowerShell

Temporary settings apply only to the current PowerShell window:

$env:ANTHROPIC_BASE_URL = "https://api.hop-base.com"
$env:ANTHROPIC_AUTH_TOKEN = "sk-your-key"

claude

To create persistent user environment variables, run the following and then reopen the terminal:

setx ANTHROPIC_BASE_URL "https://api.hop-base.com"
setx ANTHROPIC_AUTH_TOKEN "sk-your-key"

Use a Claude plan key from a Claude Max, Claude Kiro, or AWS Bedrock group. Claude Code requests are routed through HopBase and itemized in console usage. See Troubleshooting when setup fails.

On this page