Windows 配置指南 | Token101 - Claude Code API 网关

在 Windows 系统上接入并使用 Token101 API——从注册账号到发出第一个请求的完整步骤。

概览

本指南帮助你在 Windows 上完成 Token101 API 的接入。Token101 支持两种 API 格式：

OpenAI 格式（推荐）— POST https://token.ppthub.shop/api/v1/chat/completions
Anthropic 格式 — POST https://token.ppthub.shop/api/v1/messages

所有模型（GPT、Claude、Gemini、Qwen）均兼容两种格式。你可以用任何支持 OpenAI 协议的工具或 SDK 调用任意模型。

第一步 — 注册账号并获取 API Key

打开浏览器，访问 https://token.ppthub.shop
注册或登录你的账号
进入 Settings → API Keys
点击 Create API Key
立即复制生成的 sk-... 密钥

API Key 只在创建时显示一次，请立即保存到安全的地方——之后无法再次查看。

第二步 — 安装 Node.js 环境（使用 Claude Code 时必须）

如果你只需要 Python 或 curl 接入，可以跳过此步骤。

Claude Code 需要 Node.js 环境才能运行。

方法一：官网安装包（推荐）

打开浏览器，访问 https://nodejs.org
点击 LTS 版本下载 .msi 安装包
运行安装包，保持默认设置完成安装

方法二：包管理器

如果你已安装 Chocolatey 或 Scoop：

# 使用 Chocolatey
choco install nodejs

# 使用 Scoop
scoop install nodejs

验证安装

打开 PowerShell 或 CMD，运行：

node --version
npm --version

两条命令都输出版本号，说明安装成功。

Windows 注意事项：

建议使用 PowerShell 而不是 CMD，功能更强大
如果遇到权限问题，尝试以管理员身份运行 PowerShell
部分杀毒软件可能拦截新程序，需要将 Node.js 添加到白名单

第三步 — 配置 API Key 环境变量

临时设置（仅当前会话有效）

打开 PowerShell，运行：

$env:TOKEN101_API_KEY = "sk-你的APIKey"

关闭窗口后此设置失效。

永久设置（用户级，重启后仍有效）

[System.Environment]::SetEnvironmentVariable("TOKEN101_API_KEY", "sk-你的APIKey", [System.EnvironmentVariableTarget]::User)

运行后需要重新打开 PowerShell 才能生效。

验证环境变量

# PowerShell 中验证
echo $env:TOKEN101_API_KEY

# CMD 中验证
echo %TOKEN101_API_KEY%

预期输出：你的 sk-... 密钥。如果输出为空或显示变量名本身，说明设置未生效，请重新执行上面的步骤。

第四步 — 发送第一个请求

方式 A：curl（PowerShell）

curl -X POST https://token.ppthub.shop/api/v1/chat/completions `
  -H "Content-Type: application/json" `
  -H "Authorization: Bearer $env:TOKEN101_API_KEY" `
  -d '{
    "model": "gpt-5.2",
    "messages": [{"role": "user", "content": "你好，你能做什么？"}],
    "max_tokens": 256
  }'

方式 B：Python（OpenAI SDK）

先安装 SDK：

pip install openai

然后运行：

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["TOKEN101_API_KEY"],
    base_url="https://token.ppthub.shop/api/v1",
)

response = client.chat.completions.create(
    model="gpt-5.2",
    messages=[
        {"role": "system", "content": "你是一个有帮助的助手。"},
        {"role": "user", "content": "你好，你能做什么？"},
    ],
    max_tokens=256,
)

print(response.choices[0].message.content)
print(f"消耗 Token 数：{response.usage.total_tokens}")

方式 C：Node.js（OpenAI SDK）

先安装 SDK：

npm install openai

然后运行：

import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: process.env.TOKEN101_API_KEY,
  baseURL: 'https://token.ppthub.shop/api/v1',
});

const response = await client.chat.completions.create({
  model: 'gpt-5.2',
  messages: [
    { role: 'system', content: '你是一个有帮助的助手。' },
    { role: 'user', content: '你好，你能做什么？' },
  ],
  max_tokens: 256,
});

console.log(response.choices[0].message.content);

第五步 — 接入 Claude Code（可选）

Claude Code 是一个在终端中运行的 AI 编程助手。将它指向 Token101，即可使用任意支持的模型。

安装 Claude Code

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

验证安装：

claude --version

配置环境变量

Claude Code 使用 Anthropic 协议格式。Token101 现在同时兼容两种常见认证方式：

ANTHROPIC_AUTH_TOKEN：Claude Code 发送 Authorization: Bearer ...
ANTHROPIC_API_KEY：Claude Code 发送 X-Api-Key: ...

两个请求头 Token101 都会受理，所以任选一个都能用。建议使用 ANTHROPIC_AUTH_TOKEN，因为它和一键安装脚本写入的变量一致——只保留一个变量可以避免"两个同时存在"的不确定状态。请只设置其中一个。

# 临时设置（当前会话）
$env:ANTHROPIC_BASE_URL = "https://token.ppthub.shop/api"
$env:ANTHROPIC_AUTH_TOKEN = "sk-你的APIKey"

永久设置：

[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://token.ppthub.shop/api", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "sk-你的APIKey", [System.EnvironmentVariableTarget]::User)

设置永久变量后需要重新打开 PowerShell。

如果你已经在本机使用 ANTHROPIC_API_KEY，也可以继续沿用——只是不要两个同时设置：

$env:ANTHROPIC_API_KEY = "sk-你的APIKey"

将 ANTHROPIC_BASE_URL 指向非 Anthropic 官方主机后，Claude Code 的部分 MCP tool search 行为会按官方规则调整。如果后续要做到“完整 Claude Code 网关体验”，还需要继续验证 tool_reference 相关转发能力。

启动 Claude Code

# 在任意目录启动
claude

# 在指定项目目录启动
cd C:\path\to\your\project
claude

启动后，你可以直接输入问题或指令，例如：

"帮我分析这个项目的代码结构"
"这个函数有什么 bug？"
"帮我写一个 React 登录组件"

常见问题

PowerShell 执行策略错误

如果提示"无法加载脚本"或"执行策略"相关错误：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

找不到 `claude` 命令

确认安装成功：npm list -g @anthropic-ai/claude-code
关闭并重新打开 PowerShell
检查 npm 全局安装路径是否在 PATH 中：npm config get prefix

npm 安装速度慢

使用国内镜像加速：

npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

API 返回 401 错误

检查 ANTHROPIC_API_KEY 或 ANTHROPIC_AUTH_TOKEN 是否正确设置
确认密钥以 sk- 开头且长度不少于 32 个字符
在 Dashboard 的 Settings → API Keys 页面确认密钥仍然有效

下一步

支持的模型 — 完整模型列表与定价
计费与积分 — 积分机制与充值方式
速率限制 — 各套餐的请求配额
错误处理 — 常见错误与解决方法

概览

本指南帮助你在 Windows 上完成 Token101 API 的接入。Token101 支持两种 API 格式：

OpenAI 格式（推荐）— POST https://token.ppthub.shop/api/v1/chat/completions
Anthropic 格式 — POST https://token.ppthub.shop/api/v1/messages

所有模型（GPT、Claude、Gemini、Qwen）均兼容两种格式。你可以用任何支持 OpenAI 协议的工具或 SDK 调用任意模型。

第一步 — 注册账号并获取 API Key

打开浏览器，访问 https://token.ppthub.shop
注册或登录你的账号
进入 Settings → API Keys
点击 Create API Key
立即复制生成的 sk-... 密钥

API Key 只在创建时显示一次，请立即保存到安全的地方——之后无法再次查看。

第二步 — 安装 Node.js 环境（使用 Claude Code 时必须）

如果你只需要 Python 或 curl 接入，可以跳过此步骤。

Claude Code 需要 Node.js 环境才能运行。

方法一：官网安装包（推荐）

打开浏览器，访问 https://nodejs.org
点击 LTS 版本下载 .msi 安装包
运行安装包，保持默认设置完成安装

方法二：包管理器

如果你已安装 Chocolatey 或 Scoop：

# 使用 Chocolatey
choco install nodejs

# 使用 Scoop
scoop install nodejs

验证安装

打开 PowerShell 或 CMD，运行：

node --version
npm --version

两条命令都输出版本号，说明安装成功。

Windows 注意事项：

建议使用 PowerShell 而不是 CMD，功能更强大
如果遇到权限问题，尝试以管理员身份运行 PowerShell
部分杀毒软件可能拦截新程序，需要将 Node.js 添加到白名单

第三步 — 配置 API Key 环境变量

临时设置（仅当前会话有效）

打开 PowerShell，运行：

$env:TOKEN101_API_KEY = "sk-你的APIKey"

关闭窗口后此设置失效。

永久设置（用户级，重启后仍有效）

[System.Environment]::SetEnvironmentVariable("TOKEN101_API_KEY", "sk-你的APIKey", [System.EnvironmentVariableTarget]::User)

运行后需要重新打开 PowerShell 才能生效。

验证环境变量

# PowerShell 中验证
echo $env:TOKEN101_API_KEY

# CMD 中验证
echo %TOKEN101_API_KEY%

预期输出：你的 sk-... 密钥。如果输出为空或显示变量名本身，说明设置未生效，请重新执行上面的步骤。

第四步 — 发送第一个请求

方式 A：curl（PowerShell）

curl -X POST https://token.ppthub.shop/api/v1/chat/completions `
  -H "Content-Type: application/json" `
  -H "Authorization: Bearer $env:TOKEN101_API_KEY" `
  -d '{
    "model": "gpt-5.2",
    "messages": [{"role": "user", "content": "你好，你能做什么？"}],
    "max_tokens": 256
  }'

方式 B：Python（OpenAI SDK）

先安装 SDK：

pip install openai

然后运行：

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["TOKEN101_API_KEY"],
    base_url="https://token.ppthub.shop/api/v1",
)

response = client.chat.completions.create(
    model="gpt-5.2",
    messages=[
        {"role": "system", "content": "你是一个有帮助的助手。"},
        {"role": "user", "content": "你好，你能做什么？"},
    ],
    max_tokens=256,
)

print(response.choices[0].message.content)
print(f"消耗 Token 数：{response.usage.total_tokens}")

方式 C：Node.js（OpenAI SDK）

先安装 SDK：

npm install openai

然后运行：

import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: process.env.TOKEN101_API_KEY,
  baseURL: 'https://token.ppthub.shop/api/v1',
});

const response = await client.chat.completions.create({
  model: 'gpt-5.2',
  messages: [
    { role: 'system', content: '你是一个有帮助的助手。' },
    { role: 'user', content: '你好，你能做什么？' },
  ],
  max_tokens: 256,
});

console.log(response.choices[0].message.content);

第五步 — 接入 Claude Code（可选）

Claude Code 是一个在终端中运行的 AI 编程助手。将它指向 Token101，即可使用任意支持的模型。

安装 Claude Code

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

验证安装：

claude --version

配置环境变量

Claude Code 使用 Anthropic 协议格式。Token101 现在同时兼容两种常见认证方式：

ANTHROPIC_AUTH_TOKEN：Claude Code 发送 Authorization: Bearer ...
ANTHROPIC_API_KEY：Claude Code 发送 X-Api-Key: ...

# 临时设置（当前会话）
$env:ANTHROPIC_BASE_URL = "https://token.ppthub.shop/api"
$env:ANTHROPIC_AUTH_TOKEN = "sk-你的APIKey"

永久设置：

[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://token.ppthub.shop/api", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "sk-你的APIKey", [System.EnvironmentVariableTarget]::User)

设置永久变量后需要重新打开 PowerShell。

如果你已经在本机使用 ANTHROPIC_API_KEY，也可以继续沿用——只是不要两个同时设置：

$env:ANTHROPIC_API_KEY = "sk-你的APIKey"

启动 Claude Code

# 在任意目录启动
claude

# 在指定项目目录启动
cd C:\path\to\your\project
claude

启动后，你可以直接输入问题或指令，例如：

"帮我分析这个项目的代码结构"
"这个函数有什么 bug？"
"帮我写一个 React 登录组件"

常见问题

PowerShell 执行策略错误

如果提示"无法加载脚本"或"执行策略"相关错误：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

找不到 `claude` 命令

确认安装成功：npm list -g @anthropic-ai/claude-code
关闭并重新打开 PowerShell
检查 npm 全局安装路径是否在 PATH 中：npm config get prefix

npm 安装速度慢

使用国内镜像加速：

npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

API 返回 401 错误

检查 ANTHROPIC_API_KEY 或 ANTHROPIC_AUTH_TOKEN 是否正确设置
确认密钥以 sk- 开头且长度不少于 32 个字符
在 Dashboard 的 Settings → API Keys 页面确认密钥仍然有效

下一步

支持的模型 — 完整模型列表与定价
计费与积分 — 积分机制与充值方式
速率限制 — 各套餐的请求配额
错误处理 — 常见错误与解决方法