Claude Code - tokensmind docs

Use Claude Code with Tokensmind

Quickstart

This guide gets Claude Code talking to Tokensmind in a few minutes.

1. Install Claude Code

Install script

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

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

npm

Requires Node.js 18+

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

2. Point Claude Code at Tokensmind

For Anthropic-compatible access via Tokensmind, set:

ANTHROPIC_BASE_URL → https://tokensmind.ai
ANTHROPIC_AUTH_TOKEN → API key from Tokensmind
ANTHROPIC_MODEL → a model id from the model list

macOS
Windows

Check your default shell:

echo $SHELL

Append exports (replace TOKENSMIND_API_KEY):

echo 'export ANTHROPIC_BASE_URL="https://tokensmind.ai"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="TOKENSMIND_API_KEY"' >> ~/.zshrc
echo 'export ANTHROPIC_MODEL="claude-sonnet-4-5"' >> ~/.zshrc

echo 'export ANTHROPIC_BASE_URL="https://tokensmind.ai"' >> ~/.bash_profile
echo 'export ANTHROPIC_AUTH_TOKEN="TOKENSMIND_API_KEY"' >> ~/.bash_profile
echo 'export ANTHROPIC_MODEL="claude-sonnet-4-5"' >> ~/.bash_profile

Reload:

source ~/.zshrc

source ~/.bash_profile

Verify in a new terminal:

echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_AUTH_TOKEN
echo $ANTHROPIC_MODEL

In CMD or PowerShell, set Tokensmind base URL and API key as user env vars.

CMD
PowerShell

Run:

REM Replace TOKENSMIND_API_KEY
setx ANTHROPIC_AUTH_TOKEN "TOKENSMIND_API_KEY"
setx ANTHROPIC_BASE_URL "https://tokensmind.ai"
setx ANTHROPIC_MODEL "claude-sonnet-4-5"

New CMD window:

echo %ANTHROPIC_AUTH_TOKEN%
echo %ANTHROPIC_BASE_URL%
echo %ANTHROPIC_MODEL%

Run:

# Replace TOKENSMIND_API_KEY
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "TOKENSMIND_API_KEY", [EnvironmentVariableTarget]::User)
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://tokensmind.ai", [EnvironmentVariableTarget]::User)
[Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL", "claude-sonnet-4-5", [EnvironmentVariableTarget]::User)

New PowerShell window:

echo $env:ANTHROPIC_AUTH_TOKEN
echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_MODEL

3. Run

From your project:

$ cd /path/your-project
> claude

First launch may ask you to sign in to Anthropic. To skip: Cc 7

Edit ~/.claude.json (macOS/Linux) or C:\Users\%USERNAME%\.claude.json (Windows).
Set hasCompletedOnboarding to true:

{
  "hasCompletedOnboarding": true
}

Save and run claude again.

More ways to pick models (priority high → low)

In session: /model <name> for a one-off switch.

/model claude-sonnet-4-5

CLI flag: claude --model <name> for one run.

claude --model claude-sonnet-4-5

Env defaults (global):

export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-4-5"
export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-4-5"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-4-5"

OPUS — hard reasoning / architecture
SONNET — everyday coding
HAIKU — quick checks, search

settings.json (project or user home):

{
  "env": {
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5"
  }
}

CC-Switch

Open CC-Switch → Add provider.

Choose Custom.

Enter API key and endpoint.

Add to save.

Home → select tokensmind → Start.

VS Code extension

Install the extension.

Ctrl + Shift + P / Cmd + Shift + P → Settings.

Search Claude Code → Claude Code: Environment Variable → Edit in settings.json.

Fill claudeCode.environmentVariables with Tokensmind values.

FAQ

Q: `401 , No token provided...`

In the Claude terminal run /config, enable Use custom API key, verify the token. install

Q: `zsh: command not found: claude` on macOS

The binary exists but isn’t on PATH. Common locations:

~/.claude/bin
~/.local/bin

ls -l ~/.claude/bin
# or
ls -l ~/.local/bin | grep claude

If in ~/.claude/bin:

echo 'export PATH="$HOME/.claude/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

If in ~/.local/bin:

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Check:

which claude
claude -v

Q: Cannot reach Anthropic

Newer Claude Code builds expect ANTHROPIC_AUTH_TOKEN instead of ANTHROPIC_API_KEY. Update the header name and reload env—key value stays the same. Follow the env steps above.

Upgrade Claude Code to the latest version and disable CC-Switch local proxy / failover if enabled. Happy coding!

​Quickstart

​1. Install Claude Code

​Install script

​npm

​2. Point Claude Code at Tokensmind

​3. Run

​More ways to pick models (priority high → low)

​CC-Switch

​VS Code extension

​FAQ

​Q: 401 , No token provided...

​Q: zsh: command not found: claude on macOS

​Q: Cannot reach Anthropic

​Q: Login API Error 403