Claude Code - onetoken docs

Use Claude Code with Onetoken

Quickstart

This guide gets Claude Code talking to Onetoken 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 Onetoken

For Anthropic-compatible access via Onetoken, set:

BASE_URL → https://onetoken.one
AUTH_TOKEN → API key from Onetoken
MODEL → a model id from the model list

macOS
Windows

Check your default shell:

echo $SHELL

Append exports (replace ONETOKEN_API_KEY):

echo 'export BASE_URL="https://onetoken.one"' >> ~/.zshrc
echo 'export AUTH_TOKEN="ONETOKEN_API_KEY"' >> ~/.zshrc
echo 'export MODEL="claude-sonnet-4-5"' >> ~/.zshrc

echo 'export BASE_URL="https://onetoken.one"' >> ~/.bash_profile
echo 'export AUTH_TOKEN="ONETOKEN_API_KEY"' >> ~/.bash_profile
echo 'export MODEL="claude-sonnet-4-5"' >> ~/.bash_profile

Reload:

source ~/.zshrc

source ~/.bash_profile

Verify in a new terminal:

echo $BASE_URL
echo $AUTH_TOKEN
echo $MODEL

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

CMD
PowerShell

Run:

REM Replace ONETOKEN_API_KEY
setx AUTH_TOKEN "ONETOKEN_API_KEY"
setx BASE_URL "https://onetoken.one"
setx MODEL "claude-sonnet-4-5"

New CMD window:

echo %AUTH_TOKEN%
echo %BASE_URL%
echo %MODEL%

Run:

# Replace ONETOKEN_API_KEY
[Environment]::SetEnvironmentVariable("AUTH_TOKEN", "ONETOKEN_API_KEY", [EnvironmentVariableTarget]::User)
[Environment]::SetEnvironmentVariable("BASE_URL", "https://onetoken.one", [EnvironmentVariableTarget]::User)
[Environment]::SetEnvironmentVariable("MODEL", "claude-sonnet-4-5", [EnvironmentVariableTarget]::User)

New PowerShell window:

echo $env:AUTH_TOKEN
echo $env:BASE_URL
echo $env:MODEL

3. Run

From your project:

$ cd /path/your-project
> claude

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

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 DEFAULT_OPUS_MODEL="claude-opus-4-5"
export DEFAULT_SONNET_MODEL="claude-sonnet-4-5"
export 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": {
    "DEFAULT_OPUS_MODEL": "claude-opus-4-5",
    "DEFAULT_SONNET_MODEL": "claude-sonnet-4-5",
    "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 onetoken → 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 Onetoken values.

Using the deepseek model in Claude code

Available models deepseek-r1-distill-qwen-14b deepseek-v3 deepseek-v3-0324 deepseek-v3-1-250821 deepseek-v3.2 deepseek-v4-flash deepseek-v4-pro Method 1: Directly modify the configuration file Locate the .claude.json file in the user’s home directory. The specific path is as follows:

macOS / Linux: ~/.claude.json
Windows: C:\Users\%USERNAME%\.claude.json

Change the value of ANTHROPIC_MODEL to the name of the deepseek model.

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-**",
    "ANTHROPIC_BASE_URL": "https://onetoken.one",
    "ANTHROPIC_MODEL": "deepseek-v4-pro"
  },
  "includeCoAuthoredBy": false
}

Method 2: Directly modify the configuration file using CC Switch. change the model name to the DeepSeek model name, and then restart Claude Code.

FAQ

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

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

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 AUTH_TOKEN instead of 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.

Q: How to enable 1-hour caching

Open the global configuration file ~/.claude/settings.json (or .claude/settings.json in the project directory);
Add the env field:


{ "env": { "ENABLE_PROMPT_CACHING_1H": "1" } }

Happy coding!

​Quickstart

​1. Install Claude Code

​Install script

​npm

​2. Point Claude Code at Onetoken

​3. Run

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

​CC-Switch

​VS Code extension

​Using the deepseek model in Claude code

​FAQ

​Q: 401 , No token provided...

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

​Q: Cannot reach Anthropic

​Q: Login API Error 403

​Q: How to enable 1-hour caching