TokiLabsDocs
系统配置

macOS 配置指南

适用于 macOS 12 及以上（Intel 与 Apple 芯片均可）。macOS 默认使用 zsh，配置写入 ~/.zshrc。

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

1. 打开终端

按 ⌘ + 空格 搜索「终端」（Terminal）并打开。也可以使用 iTerm2 等第三方终端。

2. 安装 Node.js

推荐用 Homebrew 安装 Node.js 18 及以上版本。没有 Homebrew 的话先安装它：

Terminal
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
Terminal
brew install node
node -v
不想装 Homebrew，也可以从 nodejs.org 下载 LTS 版 .pkg 安装包。

3. 设置环境变量

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

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

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

检查是否生效

如果你把默认 shell 换成了 bash，请把上面命令中的 ~/.zshrc 改成 ~/.bash_profile。可以用 echo $SHELL 查看当前 shell。
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

或者使用 Homebrew / npm：

Terminal
brew install --cask claude-code
# 或
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 详细配置。

图形界面应用读取不到变量？

从 Dock 或启动台打开的应用（如 VS Code、Cursor）不一定会加载 ~/.zshrc。最简单的办法是在终端里用 code . 启动 VS Code；或者直接在插件设置里填写接口地址和密钥，参见 VS Code / Cline / Cursor。

还原配置

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

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