Claude Code

Using npm

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

Or using install script (macOS / Linux)

curl -fsSL https://claude.ai/install.sh | sh

Vtrix supports a global config file or environment variables. The config file is recommended.

Using a config file (recommended)

Create ~/.claude/settings.json:

mkdir -p ~/.claude

Config file content: ~/.claude/settings.json

vim ~/.claude/settings.json

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://cloud.vtrix.ai/llm",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_VTRIX_API_KEY",
    "ANTHROPIC_MODEL": "claude-sonnet-4-5"
  }
}

Tip: In the Vtrix console, open Models, pick a model (for example Claude Sonnet 4.5), open the API tab, and copy the suggested configuration.

Using environment variables

Add to ~/.bashrc or ~/.zshrc:

# Vtrix API configuration
export ANTHROPIC_BASE_URL="https://cloud.vtrix.ai/llm"
export ANTHROPIC_AUTH_TOKEN="YOUR_VTRIX_API_KEY"
export ANTHROPIC_MODEL="claude-sonnet-4-5"

Warning: Restart the terminal or run source ~/.zshrc (or your shell config) so the variables apply. On Windows, restart Command Prompt.

Change ANTHROPIC_MODEL whenever you want to switch models.

Example after switching:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://cloud.vtrix.ai/llm",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_VTRIX_API_KEY",
    "ANTHROPIC_MODEL": "gemini-3-pro-preview" // Change this
  }
}

Tip: Browse models, capabilities, and pricing on the Models page. Choose models that support tool calling for Claude Code.

Navigate to your project directory and start Claude Code:

cd /path/to/your/project
claude

Prompts are sent through Vtrix once this is configured.

Verify configuration

Inside Claude Code, run the /status command to verify your connection:

> /status
Auth token: ANTHROPIC_AUTH_TOKEN
Base URL: https://cloud.vtrix.ai/llm
Model: claude-sonnet-4-5

You can also check billing in Settings in your Vtrix account to confirm requests are arriving.