Skip to main content
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

​
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:
  1. ANTHROPIC_BASE_URL → https://tokensmind.ai
  2. ANTHROPIC_AUTH_TOKEN → API key from Tokensmind
  3. ANTHROPIC_MODEL → a model id from the model list
  1. Check your default shell:
echo $SHELL
  1. 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
  1. Reload:
source ~/.zshrc
  1. Verify in a new terminal:
echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_AUTH_TOKEN
echo $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
  1. Edit ~/.claude.json (macOS/Linux) or C:\Users\%USERNAME%\.claude.json (Windows).
  2. Set hasCompletedOnboarding to true:
{
  "hasCompletedOnboarding": true
}
  1. Save and run claude again.

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

  1. In session: /model <name> for a one-off switch.
/model claude-sonnet-4-5
  1. CLI flag: claude --model <name> for one run.
claude --model claude-sonnet-4-5
  1. 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
  1. 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

  1. Open CC-Switch → Add provider.
  1. Choose Custom.
  1. Enter API key and endpoint.
  1. Add to save.
  1. Home → select tokensmind → Start.

​
VS Code extension

  1. Install the extension.
I Shot 2026 03 25 11 44 03
  1. Ctrl + Shift + P / Cmd + Shift + P → Settings.
I Shot 2026 03 25 11 47 48
  1. Search Claude Code → Claude Code: Environment Variable → Edit in settings.json.
I Shot 2026 03 25 11 49 37
  1. Fill claudeCode.environmentVariables with Tokensmind values.
I Shot 2026 03 25 11 53 07

​
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.

​
Q: Login API Error 403

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