Linux
在 Linux 系统上配置 Token101 API(Ubuntu、Debian、CentOS、Arch)
Linux 配置指南
本指南介绍如何在 Linux 系统上配置并使用 Token101 API,涵盖 Ubuntu/Debian、CentOS/RHEL/Fedora 和 Arch Linux。
前置条件
- Token101 API Key — 在 token.ppthub.shop/settings/apikeys 创建
- 可访问互联网的 Linux 系统
- 终端访问(SSH 或本地)
步骤一 — 注册账号并获取 API Key
- 前往 token.ppthub.shop 注册免费账号
- 进入 设置 → API Keys
- 点击 创建 API Key,填写名称,复制 Key
API Key 只显示一次,请立即复制并妥善保存(建议存入密码管理器)。
步骤二 — 安装 Node.js(可选,用于 JS/TS 项目)
如果你计划使用 Node.js 或 TypeScript,请先安装 Node.js。
Ubuntu / Debian
# 使用 NodeSource 安装最新 LTS 版本(推荐)
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs
# 验证
node --version
npm --versionCentOS / RHEL / Fedora
# Fedora
sudo dnf install nodejs npm
# CentOS/RHEL(使用 NodeSource)
curl -fsSL https://rpm.nodesource.com/setup_lts.x | sudo bash -
sudo yum install -y nodejsArch Linux
sudo pacman -S nodejs npm步骤三 — 配置环境变量
为你的 Shell 设置 Token101 API Key 和接口地址。
仅当前终端有效
export TOKEN101_API_KEY="your-token101-api-key"永久设置 — bash
echo 'export TOKEN101_API_KEY="your-token101-api-key"' >> ~/.bashrc
source ~/.bashrc永久设置 — zsh
echo 'export TOKEN101_API_KEY="your-token101-api-key"' >> ~/.zshrc
source ~/.zshrc系统级设置(所有用户)
sudo tee -a /etc/environment <<EOF
TOKEN101_API_KEY="your-token101-api-key"
EOF服务器部署建议使用 .env 文件或密钥管理工具(如 HashiCorp Vault、AWS Secrets Manager),而不是 Shell 配置文件。
步骤四 — 发送第一个 API 请求
使用 curl(Anthropic Messages 格式)
curl https://token.ppthub.shop/api/v1/messages \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $TOKEN101_API_KEY" \
-d '{
"model": "gpt-5.2",
"max_tokens": 64,
"messages": [
{"role": "user", "content": "你好!请回复:TOKEN101_OK"}
]
}'使用 curl(OpenAI Chat Completions 格式)
curl https://token.ppthub.shop/api/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $TOKEN101_API_KEY" \
-d '{
"model": "gpt-5.2",
"messages": [
{"role": "user", "content": "你好!请回复:TOKEN101_OK"}
]
}'使用 Python
安装 Anthropic SDK:
pip3 install anthropic创建测试脚本:
import anthropic
import os
client = anthropic.Anthropic(
api_key=os.environ.get("TOKEN101_API_KEY"),
base_url="https://token.ppthub.shop/api",
)
message = client.messages.create(
model="gpt-5.2",
max_tokens=64,
messages=[{"role": "user", "content": "请回复:TOKEN101_OK"}],
)
print(message.content[0].text)运行:
python3 test_token101.py使用 Node.js
import Anthropic from '@anthropic-ai/sdk';
const client = new Anthropic({
apiKey: process.env.TOKEN101_API_KEY,
baseURL: 'https://token.ppthub.shop/api',
});
const response = await client.messages.create({
model: 'gpt-5.2',
max_tokens: 64,
messages: [{ role: 'user', content: '请回复:TOKEN101_OK' }],
});
console.log(response.content[0].text);步骤五 — 配置编程助手 CLI(可选)
Codex CLI
npm install -g @openai/codex --registry=https://registry.npmmirror.com
export OPENAI_BASE_URL="https://token.ppthub.shop/api/v1"
export OPENAI_API_KEY="$TOKEN101_API_KEY"
codex "请回复:TOKEN101_OK"Claude Code
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com
export ANTHROPIC_BASE_URL="https://token.ppthub.shop/api"
export ANTHROPIC_AUTH_TOKEN="$TOKEN101_API_KEY"
claude -p "请回复:TOKEN101_OK"Token101 同时受理 ANTHROPIC_AUTH_TOKEN(发送 Authorization: Bearer ...)和 ANTHROPIC_API_KEY(发送 X-Api-Key: ...)。请只设置其中一个;推荐使用 ANTHROPIC_AUTH_TOKEN,因为它和一键安装脚本一致。
详细 CLI 配置请参阅 Codex CLI 接入 和 Claude Code 接入。
常见问题
curl: command not found
安装 curl:
# Ubuntu/Debian
sudo apt-get install -y curl
# CentOS/RHEL
sudo yum install -y curl
# Arch
sudo pacman -S curl报错 401 Unauthorized
API Key 无效或未设置。检查是否已正确配置:
echo $TOKEN101_API_KEY
# 应输出你的 API Key,而不是空Python 报错 ModuleNotFoundError: No module named 'anthropic'
pip3 install anthropic
# 或在虚拟环境中
python3 -m venv venv && source venv/bin/activate && pip install anthropic防火墙拦截出站 HTTPS
Token101 需要出站 HTTPS(端口 443)访问 token.ppthub.shop。检查防火墙设置:
# 测试连通性
curl -s https://token.ppthub.shop/api/health
# 期望输出:{"status":"healthy",...}
# 如果被拦截,检查防火墙规则
sudo ufw status
sudo iptables -L OUTPUT注销后环境变量消失
确认你编辑的是正确的 Shell 配置文件。运行 echo $SHELL 查看当前 Shell,对应文件如下:
| Shell | 配置文件 |
|---|---|
| bash | ~/.bashrc 或 ~/.bash_profile |
| zsh | ~/.zshrc |
| fish | ~/.config/fish/config.fish |
下一步
- 支持的模型 — 查看可用模型列表
- Codex CLI 接入 — 配置 Codex 编程助手
- Claude Code 接入 — 配置 Claude Code
- 流式输出 — 了解如何使用流式响应