TokiLabsDocs
系统配置

Linux 配置指南

适用于 Ubuntu、Debian、Fedora、Arch 等主流发行版，以及 WSL 和远程服务器。默认按 bash 说明。

一个密钥可以调用所有模型。密钥只保存在你自己的浏览器里，不会上传到任何服务器。
还没有密钥？先到 获取 API 密钥 创建一个。

1. 打开终端

桌面环境按 Ctrl + Alt + T 打开终端；服务器直接 SSH 登录即可。以下命令都以普通用户执行，不需要 sudo（安装 Node.js 除外）。

2. 安装 Node.js

需要 Node.js 18 及以上版本。发行版自带的 Node 往往太旧，推荐用 nvm 安装，不需要 root 权限：

Terminal · nvm (推荐)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
source ~/.bashrc
nvm install --lts
node -v
Terminal
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs
用系统包管理器安装的 Node，npm install -g 可能需要 sudo。用 nvm 就没有这个问题。

3. 设置环境变量

设置下面两个变量，接口地址为 https://api.tokilabs.xyz。

变量名值给谁用
ANTHROPIC_BASE_URLhttps://api.tokilabs.xyzClaude Code、Anthropic SDK
ANTHROPIC_AUTH_TOKENsk-你的密钥Claude Code
Terminal · bash
cat >> ~/.bashrc <<'EOF'

# Toki Labs · Claude
export ANTHROPIC_BASE_URL="https://api.tokilabs.xyz"
export ANTHROPIC_AUTH_TOKEN="sk-你的密钥"
EOF
source ~/.bashrc

检查是否生效

使用 zsh 的话把 ~/.bashrc 换成 ~/.zshrc；使用 fish 请改用 set -Ux ANTHROPIC_BASE_URL https://api.tokilabs.xyz 这样的写法。
Terminal
echo $ANTHROPIC_BASE_URL

4. 验证连接

返回一段包含 "data" 的 JSON 模型列表，就说明地址和密钥都没问题。

Terminal
curl "$ANTHROPIC_BASE_URL/v1/models" -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN"
返回 401 说明密钥错误或已失效；连接超时请检查本机代理设置，参见 常见问题。

5. 安装 Claude Code

Terminal · 官方安装脚本
curl -fsSL https://claude.ai/install.sh | bash

或者使用 npm 安装：

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

跳过首次启动时的官方账号登录引导：

Terminal
[ -f ~/.claude.json ] || echo '{"hasCompletedOnboarding": true}' > ~/.claude.json

进入项目目录启动：

Terminal
cd 你的项目目录
claude

启动后输入 /status，看到 Base URL 为 https://api.tokilabs.xyz 即表示已走 Toki Labs 接口。输入 /model 可切换模型，例如 claude-opus-5-5。更多设置见 Claude Code 详细配置。

服务器与 Docker

在服务器上跑定时任务或 systemd 服务时，~/.bashrc 不会被加载。请在 unit 文件里用 Environment=，或在 Docker 中用 -e 传入：

Terminal
docker run --rm \
  -e ANTHROPIC_BASE_URL=https://api.tokilabs.xyz \
  -e ANTHROPIC_AUTH_TOKEN=sk-你的密钥 \
  your-image

还原配置

不再使用时，删除这些环境变量即可恢复默认：

Terminal
# 用编辑器打开 ~/.bashrc，删除「# Toki Labs · Claude」下面的 2 行 export，然后：
unset ANTHROPIC_BASE_URL ANTHROPIC_AUTH_TOKEN