Skip to main content
Claude Code is Anthropic’s terminal-based AI coding assistant. It runs as a CLI command (claude) directly in your shell, understands your codebase in context, and helps you write, debug, and refactor code through natural conversation. By pointing Claude Code at Fhddos as its API gateway, you authenticate with your Fhddos token instead of an Anthropic API key — and benefit from Fhddos’s unified billing and model routing.

​
System Requirements

PlatformRequirement
macOS13.0 or later
Windows10 (build 1809+) or Windows Server 2019+; install Git for Windows or use WSL
LinuxUbuntu 20.04+, Debian 10+, Alpine 3.19+, or equivalent
Hardware4 GB+ RAM, x64 or ARM64 processor

​
Step 1 — Install Claude Code

Choose the installation method that matches your platform:
The native installer supports automatic updates:
curl -fsSL https://claude.ai/install.sh | bash

​
Verify the Installation

claude --version
claude doctor
claude doctor checks that your environment is correctly configured and reports any issues before you connect to the gateway.

​
Step 2 — Configure Fhddos as the Gateway

Set two environment variables in the same terminal session where you will launch claude. Claude Code reads these at startup: 
export ANTHROPIC_BASE_URL="https://aiapi.fhddos.com"
export ANTHROPIC_API_KEY="your-fhddos-token"
Then start Claude Code:
claude
Do not append /v1 to ANTHROPIC_BASE_URL. Claude Code appends the correct path suffix automatically. Setting https://aiapi.fhddos.com/v1 will cause routing errors.

​
Make the Configuration Persistent

To avoid re-exporting the variables every session, add them to your shell profile: 
echo 'export ANTHROPIC_BASE_URL="https://aiapi.fhddos.com"' >> ~/.bashrc
echo 'export ANTHROPIC_API_KEY="your-fhddos-token"' >> ~/.bashrc
source ~/.bashrc

​
Step 3 — Verify the Connection

  1. Open the Fhddos console and confirm your token is active and has a Claude model route assigned.
  2. Start claude and run the /status command to confirm the base URL and key are loaded.
  3. Send a test message — for example, "Say hello" — and verify you receive a response.
If the response arrives, Claude Code is routing through Fhddos successfully.

​
Troubleshooting

The old npm global package (npm install -g @anthropic-ai/claude-code) is deprecated. Use one of the native installers above unless you specifically need Node.js 18+ compatibility.
Still hitting Anthropic’s servers directly? Check that you exported the environment variables in the same terminal where you launched claude. User-level or organization-level Claude Code settings files may override shell variables — inspect ~/.claude/settings.json if that applies. Authentication failure (401)? Some Claude Code versions expect ANTHROPIC_AUTH_TOKEN rather than ANTHROPIC_API_KEY. If you see auth errors, try: 
export ANTHROPIC_AUTH_TOKEN="your-fhddos-token"
Behind a corporate proxy? Set the standard proxy variables before launching claude: 
export HTTPS_PROXY="https://proxy.example.com:8080"
export HTTP_PROXY="http://proxy.example.com:8080"
claude
Refer to the Claude Code Enterprise network configuration documentation for advanced proxy options.