Tokatlas

Appearance

繁體中文
Agent Quick Start

Connect Claude Code CLI to Tokatlas ​

Configure Claude Code CLI with a Tokatlas key, endpoint, and enabled model.

Before You Start ​

Install Claude Code using the official installer guide, then run claude --version.

Prepare a Tokatlas API key and a model enabled for your account. Replace all YOUR_... placeholders. Back up existing settings before merging changes.

Connection Settings ​

SettingValue
Provider nameTokatlas
ProtocolMessages
Endpoint / Base URLhttps://api.tokatlas.ai
API KeyYOUR_TOKATLAS_API_KEY
Model IDYOUR_TOKATLAS_MODEL_ID

Setup ​

  1. Open a terminal in your project. Set these variables for the current session, replacing the key and model placeholders.
  2. Run claude from that terminal. Send a short request and use /status to verify the gateway and credential source.

Configuration Example ​

bash
export ANTHROPIC_BASE_URL="https://api.tokatlas.ai"
export ANTHROPIC_API_KEY="YOUR_TOKATLAS_API_KEY"
export ANTHROPIC_MODEL="YOUR_TOKATLAS_CLAUDE_MODEL_ID"
claude

Compatibility Notes ​

These are Bash/Zsh commands. In PowerShell use $env:NAME = "value". Tokatlas Messages documentation uses x-api-key, so this example uses ANTHROPIC_API_KEY. Resolve any existing ANTHROPIC_AUTH_TOKEN conflict before testing. Use a Claude model enabled for your account. Shell variables last only for that session.

Verify and Troubleshoot ​

  1. Open a new conversation and send “Reply with OK only”; check that text returns.
  2. Check Tokatlas usage for a successful request at the same time with the configured model.
  3. If you need tools, ask the client to list files in a test directory and check that the tool result returns to the conversation.
  4. If step 1 fails, test the key and model directly using API Basics. If that succeeds, troubleshoot client settings below.
ProblemCheck
401 / 403Re-enter the Tokatlas key without quotes or spaces; check the auth mode and model access.
404Compare the full request URL with the table above; remove a duplicated /v1 or endpoint suffix.
Unknown modelCopy an enabled ID from the model list, save it, and select that model in a new chat.
Tool failureModel capabilities and client protocol support.
Changes ignoredSelect the Tokatlas provider/profile, fully quit the client, and reopen it.

References ​