TokiLabsDocs
系统配置

Windows 配置指南

适用于 Windows 10 / 11。全程在 PowerShell 中完成,不需要管理员权限。

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

1. 打开终端

按 Win + X,选择「终端」或「Windows PowerShell」。下文所有命令都在 PowerShell 中执行,不要使用旧的 cmd 窗口。

2. 安装 Node.js

Claude Code 依赖 Node.js 18 及以上版本;在 Windows 上还需要 Git for Windows(提供 Git Bash)。用系统自带的 winget 安装:

PowerShell
winget install OpenJS.NodeJS.LTS
winget install Git.Git

安装完成后关闭并重新打开终端,确认版本:

PowerShell
node -v
git --version
如果执行 npm 时提示「在此系统上禁止运行脚本」,运行一次 Set-ExecutionPolicy -Scope CurrentUser RemoteSigned 并输入 Y 确认即可。

3. 设置环境变量

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

变量名值给谁用
ANTHROPIC_BASE_URLhttps://api.tokilabs.xyzClaude Code、Anthropic SDK
ANTHROPIC_AUTH_TOKENsk-你的密钥Claude Code
PowerShell
# 写入「用户环境变量」,永久生效(无需管理员权限)
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.tokilabs.xyz", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "sk-你的密钥", "User")

检查是否生效

命令执行后,关闭所有终端窗口和 VS Code 再重新打开,新变量才会生效。用下面的命令检查:

PowerShell
$env:ANTHROPIC_BASE_URL
不想用命令?图形界面设置方法
  1. 按 Win 搜索「编辑账户的环境变量」并打开。
  2. 在「用户变量」区域点击「新建」,依次添加上表中的两个变量。
  3. 点击「确定」保存,然后重新打开终端。

4. 验证连接

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

PowerShell
# 注意:PowerShell 里要写 curl.exe,单写 curl 会调用 Invoke-WebRequest
curl.exe "$env:ANTHROPIC_BASE_URL/v1/models" -H "Authorization: Bearer $env:ANTHROPIC_AUTH_TOKEN"
返回 401 说明密钥错误或已失效;连接超时请检查本机代理设置,参见 常见问题。

5. 安装 Claude Code

PowerShell · 官方安装脚本
irm https://claude.ai/install.ps1 | iex

或者使用 npm 安装:

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

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

PowerShell
# 仅在文件不存在时创建,避免覆盖已有配置
if (!(Test-Path "$HOME\.claude.json")) {
  [IO.File]::WriteAllText("$HOME\.claude.json", '{"hasCompletedOnboarding": true}')
}

进入项目目录启动:

PowerShell
cd 你的项目目录
claude

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

使用 WSL

如果你在 WSL(Windows Subsystem for Linux)里开发,请在 WSL 终端中按 Linux 配置指南 操作。WSL 与 Windows 的环境变量相互独立,需要分别配置。

还原配置

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

PowerShell
foreach ($n in "ANTHROPIC_BASE_URL","ANTHROPIC_AUTH_TOKEN") {
  [Environment]::SetEnvironmentVariable($n, $null, "User")
}