Setup Guide

Follow this step-by-step guide to configure your AI API Key. No coding experience required.

Claude Code

Requires Claude plan

Claude Code requires a Claude credit pack. Purchase one from the Plans page (select the "Claude" tab).

1

Install Node.js

Claude Code requires Node.js 18 or later. Check your version:

node --version

If the version is below 18 or the command is not found:

Open Terminal (press Cmd + Space, type "Terminal", press Enter):

brew install node

No Homebrew? Install it first: /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

2

Install Claude Code

In your Terminal, run:

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

Verify installation:

claude --version
3

Configure settings.json (recommended)

Claude Code uses a settings.json file for configuration. Replace sk-your-api-key with your actual key from the Dashboard.

Option A: Single command (recommended):

mkdir -p ~/.claude
cat > ~/.claude/settings.json << 'EOF'
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-your-api-key",
    "ANTHROPIC_BASE_URL": "https://api.whaleproxy.top/proxy"
  }
}
EOF

Option B: Step by step with vi:

1. Create the config directory and open the file:

mkdir -p ~/.claude
vi ~/.claude/settings.json

2. Press i to enter Insert mode (you'll see -- INSERT -- at the bottom).

3. Paste the following content:

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-your-api-key",
    "ANTHROPIC_BASE_URL": "https://api.whaleproxy.top/proxy"
  }
}

4. Press Esc, then type :wq and press Enter to save and quit.

Changes to settings.json take effect after restarting Claude Code.
4

Start Claude Code

Navigate to your project directory and start Claude Code:

cd your-project-folder
claude

Claude Code will read the settings.json and connect through WhaleProxy automatically.

First time? Claude will show you a brief tutorial. Type your question or describe the code you want to write, and Claude will help!

Supported models

Your Claude credit pack supports: claude-sonnet-4-6, claude-opus-4-6, and more. Claude Code uses the best available model by default — no manual model selection needed.