Get connected

Setup guide

Every client below talks to the same base URL with the same key. Pick the one you use.

Your connection details

These three values are all any client needs.

Base URL: https://claude-gateway.phucthinhvn122.workers.dev
API key: Sign in to see your key here.Sign in
Model: claude-opus-5

Test the connection

Checks that the gateway is up and measures the round trip. It does not spend credit and does not verify your key — only a real request can do that.

Claude Desktop cannot be pointed at this gateway

The desktop app signs in to a claude.ai account and has no setting for a custom API endpoint. Its claude_desktop_config.json configures MCP servers only — there is no base-URL field in it, and guides that add one are editing a file the app does not read for that purpose.

Claude Code, the CLI, is the supported way to use this gateway with Anthropic’s own tooling. It reads the two environment variables below.

Option A — Claude Code settings file (recommended)

Claude Code reads an env block from ~/.claude/settings.json (on Windows, %USERPROFILE%\.claude\settings.json). Merge these keys into the file if it already exists — do not replace it.

~/.claude/settings.json

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://claude-gateway.phucthinhvn122.workers.dev",
    "ANTHROPIC_AUTH_TOKEN": "sk-live-YOUR-KEY-HERE",
    "ANTHROPIC_MODEL": "claude-opus-5"
  }
}

Restart any running claude session afterwards; settings are read at startup.

Option B — environment variables

Use this if you would rather not edit the settings file, or you want the whole shell pointed at the gateway.

Windows — PowerShell, persistent

powershell

setx ANTHROPIC_BASE_URL "https://claude-gateway.phucthinhvn122.workers.dev"
setx ANTHROPIC_AUTH_TOKEN "sk-live-YOUR-KEY-HERE"
setx ANTHROPIC_MODEL "claude-opus-5"

setx writes to your user environment but does not touch the window it runs in. Open a new terminal, or run the session form below first.

Windows — current session only

powershell

$env:ANTHROPIC_BASE_URL = "https://claude-gateway.phucthinhvn122.workers.dev"
$env:ANTHROPIC_AUTH_TOKEN = "sk-live-YOUR-KEY-HERE"
$env:ANTHROPIC_MODEL = "claude-opus-5"

macOS and Linux

bash / zsh

# add to ~/.zshrc (macOS) or ~/.bashrc (Linux), then restart the shell
export ANTHROPIC_BASE_URL="https://claude-gateway.phucthinhvn122.workers.dev"
export ANTHROPIC_AUTH_TOKEN="sk-live-YOUR-KEY-HERE"
export ANTHROPIC_MODEL="claude-opus-5"

Check it worked

Run Claude Code and send anything. Traffic shows up on your dashboard within a few seconds.

terminal

claude

Prefer not to do any of this by hand? The desktop setup app applies exactly these changes, backs up whatever it edits, and can undo them. Pair it with the code at the bottom of this page.

Pair the desktop app

Pairing needs a signed-in session so the gateway can confirm the key is yours.

# add to ~/.zshrc (macOS) or ~/.bashrc (Linux), then restart the shell export ANTHROPIC_BASE_URL="https://claude-gateway.phucthinhvn122.workers.dev" export ANTHROPIC_AUTH_TOKEN="sk-live-YOUR-KEY-HERE" export ANTHROPIC_MODEL="claude-opus-5"