Claude Code

1Check system requirements

2Run the installer

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

irm https://claude.ai/install.ps1 | iex

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

brew install --cask claude-code

winget install Anthropic.ClaudeCode

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

3Verify the installation

Open a new terminal window and run:

claude --version
claude doctor

You should see a version such as 2.1.211 (Claude Code). claude doctor checks the install and your settings files. If you get command not found, open a new terminal or follow the official install troubleshooting to fix your PATH.

4Create a Codelux account and API key

1. Go to Codelux Portal and create an account (existing users sign in).
2. Pick a subscription plan or top up in Billing — any balance works for every agent.
3. Open API Keys in the left menu and click Create New Key. Give it a name you will recognise, such as the agent's name.
4. After it is created, copy the API key (starts with sk-) and the API base URL. The key is shown in full only once, so keep it somewhere safe.

5Install CC-Switch

CC-Switch is an open-source (MIT) desktop app that manages API providers for Claude Code, Codex, Gemini CLI, OpenCode and more. It writes the configuration files for you, so you don't have to edit them by hand. Requirements: Windows 10+, macOS 12+, or Linux x86_64/ARM64 with glibc 2.35+ and WebKitGTK 4.1 (e.g. Ubuntu 22.04+, Debian 12+).

brew install --cask cc-switch

sudo apt install ./CC-Switch-v*-Linux-x86_64.deb

6Import Codelux into CC-Switch in one click

1. Keep CC-Switch running (it registers the ccswitch:// link handler on first launch).
2. In Portal, on the success page of the key you just created, find Import to desktop clients. It is only shown on desktop browsers.
3. On the CC-Switch card, set Target app to Claude Code, then click Import.
4. Your browser asks to open CC-Switch — allow it. CC-Switch shows a confirmation dialog with the provider name (Codelux), endpoint and key; confirm to add it.
5. In CC-Switch, switch to Claude Code at the top and make sure the Codelux provider is enabled.

Prefer to add it by hand? In CC-Switch click the orange + → Custom, fill in Provider name (e.g. codelux.io), Website https://codelux.io, your API Key and the Request URL (the Codelux API base URL, no trailing slash), then click Add.

If Claude Code still asks you to log in or shows onboarding on first launch, turn on Skip Claude Code first-run confirmation in CC-Switch Settings → General and restart Claude Code. It writes hasCompletedOnboarding: true to ~/.claude.json.

7(Optional) Configure settings.json by hand

Without CC-Switch, add this env block to your user settings file so it applies to every project:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://codelux.io",
    "ANTHROPIC_AUTH_TOKEN": "sk-your-codelux-key",
    "ANTHROPIC_MODEL": "claude-sonnet-5"
  }
}

• ANTHROPIC_BASE_URL: the Codelux API base URL, without /v1 — Claude Code appends /v1/messages itself.
• ANTHROPIC_AUTH_TOKEN: your Codelux API key, sent as Authorization: Bearer.
• ANTHROPIC_MODEL (optional): the default model. Any model ID listed in Portal → AI Hub works, e.g. claude-opus-4-8 or glm-5.2.

To try it in the current terminal only, export the variables instead:

export ANTHROPIC_BASE_URL=https://codelux.io
export ANTHROPIC_AUTH_TOKEN=sk-your-codelux-key

$env:ANTHROPIC_BASE_URL = "https://codelux.io"
$env:ANTHROPIC_AUTH_TOKEN = "sk-your-codelux-key"

8(Optional) Test the connection with curl

In a terminal where the variables are exported, run the command below. A JSON reply starting with {"id":"msg_ means the URL and key both work:

curl -X POST "$ANTHROPIC_BASE_URL/v1/messages" \
  -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model": "claude-sonnet-5", "max_tokens": 16, "messages": [{"role": "user", "content": "hi"}]}'

A 401 means the key is wrong or was deleted — check it in Portal.

9Start and confirm the connection

cd your-project
claude

In the session, run /status and check the Status tab:

• Anthropic base URL shows https://codelux.io — requests are going to Codelux.
• The auth line names ANTHROPIC_AUTH_TOKEN — your Codelux key is in use, not a claude.ai login.

Then send any prompt, such as “summarize this project”. A normal reply means you are all set.

10Switch models

Run /model to open the model picker, or pass a model ID directly:

/model claude-opus-4-8
/model glm-5.2
/model deepseek-v4-flash

CC-Switch or ANTHROPIC_MODEL sets the default model; a /model choice is saved as the default for new sessions. The first request after a switch re-reads the conversation without cache.

11Everyday commands

See the model, tokens and charge of every request in Portal → Logs.