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

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

概览

本指南帮助你在 macOS 上完成 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 环境才能运行。

方法一：Homebrew（推荐）

如果你已安装 Homebrew，直接运行：

brew install node

如果还没有安装 Homebrew，先安装它：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

方法二：官网安装包

打开浏览器，访问 https://nodejs.org
点击 LTS 版本下载 .pkg 安装包
双击下载的文件，按照安装向导完成安装

验证安装

打开 Terminal，运行：

node --version
npm --version

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

macOS 注意事项：

首次运行下载的程序时，macOS 可能弹出安全提示——前往系统设置 → 隐私与安全性，点击仍要打开
推荐使用 Terminal.app、iTerm2 或 Warp 终端

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

确认你的 Shell 类型

首先确认你使用的是哪种 Shell：

echo $SHELL

输出 /bin/zsh → 使用下方 zsh 配置方式（macOS Catalina 及以后版本的默认 Shell）
输出 /bin/bash → 使用下方 bash 配置方式

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

export TOKEN101_API_KEY="sk-你的APIKey"

关闭 Terminal 窗口后此设置失效。

永久设置 — zsh（macOS 推荐）

# 添加到 ~/.zshrc
echo '' >> ~/.zshrc
echo '# Token101 API' >> ~/.zshrc
echo 'export TOKEN101_API_KEY="sk-你的APIKey"' >> ~/.zshrc

# 立即生效
source ~/.zshrc

永久设置 — bash

# 添加到 ~/.bash_profile
echo '' >> ~/.bash_profile
echo '# Token101 API' >> ~/.bash_profile
echo 'export TOKEN101_API_KEY="sk-你的APIKey"' >> ~/.bash_profile

# 立即生效
source ~/.bash_profile

验证环境变量

echo $TOKEN101_API_KEY

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

第四步 — 发送第一个请求

方式 A：curl（Terminal）

curl -X POST 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": "你好，你能做什么？"}],
    "max_tokens": 256
  }'

方式 B：Python（OpenAI SDK）

先安装 SDK：

pip3 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，因为它和一键安装脚本写入的变量一致——只保留一个变量可以避免"两个同时存在"的不确定状态。请只设置其中一个。

zsh（推荐）：

echo '' >> ~/.zshrc
echo '# Token101 for Claude Code' >> ~/.zshrc
echo 'export ANTHROPIC_BASE_URL="https://token.ppthub.shop/api"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="sk-你的APIKey"' >> ~/.zshrc
source ~/.zshrc

bash：

echo '' >> ~/.bash_profile
echo '# Token101 for Claude Code' >> ~/.bash_profile
echo 'export ANTHROPIC_BASE_URL="https://token.ppthub.shop/api"' >> ~/.bash_profile
echo 'export ANTHROPIC_AUTH_TOKEN="sk-你的APIKey"' >> ~/.bash_profile
source ~/.bash_profile

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

export ANTHROPIC_API_KEY="sk-你的APIKey"

验证环境变量

echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_API_KEY

预期输出：

https://token.ppthub.shop/api
sk-你的APIKey

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

启动 Claude Code

# 在任意目录启动
claude

# 在指定项目目录启动
cd ~/Projects/my-project
claude

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

"帮我分析这个项目的代码结构"
"这个函数有什么 bug？"
"帮我写一个 Swift 用户认证类"

常见问题

macOS 安全性阻止运行

如果 macOS 阻止 Claude Code 运行：

前往系统设置 → 隐私与安全性
向下滚动找到被阻止的应用
点击仍要打开或允许

找不到 `claude` 命令

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

npm 权限错误（EACCES）

不要使用 sudo，改用以下方式修复权限：

mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc
source ~/.zshrc
npm install -g @anthropic-ai/claude-code

API 返回 401 错误

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

下一步

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

概览

本指南帮助你在 macOS 上完成 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 环境才能运行。

方法一：Homebrew（推荐）

如果你已安装 Homebrew，直接运行：

brew install node

如果还没有安装 Homebrew，先安装它：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

方法二：官网安装包

打开浏览器，访问 https://nodejs.org
点击 LTS 版本下载 .pkg 安装包
双击下载的文件，按照安装向导完成安装

验证安装

打开 Terminal，运行：

node --version
npm --version

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

macOS 注意事项：

首次运行下载的程序时，macOS 可能弹出安全提示——前往系统设置 → 隐私与安全性，点击仍要打开
推荐使用 Terminal.app、iTerm2 或 Warp 终端

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

确认你的 Shell 类型

首先确认你使用的是哪种 Shell：

echo $SHELL

输出 /bin/zsh → 使用下方 zsh 配置方式（macOS Catalina 及以后版本的默认 Shell）
输出 /bin/bash → 使用下方 bash 配置方式

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

export TOKEN101_API_KEY="sk-你的APIKey"

关闭 Terminal 窗口后此设置失效。

永久设置 — zsh（macOS 推荐）

# 添加到 ~/.zshrc
echo '' >> ~/.zshrc
echo '# Token101 API' >> ~/.zshrc
echo 'export TOKEN101_API_KEY="sk-你的APIKey"' >> ~/.zshrc

# 立即生效
source ~/.zshrc

永久设置 — bash

# 添加到 ~/.bash_profile
echo '' >> ~/.bash_profile
echo '# Token101 API' >> ~/.bash_profile
echo 'export TOKEN101_API_KEY="sk-你的APIKey"' >> ~/.bash_profile

# 立即生效
source ~/.bash_profile

验证环境变量

echo $TOKEN101_API_KEY

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

第四步 — 发送第一个请求

方式 A：curl（Terminal）

curl -X POST 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": "你好，你能做什么？"}],
    "max_tokens": 256
  }'

方式 B：Python（OpenAI SDK）

先安装 SDK：

pip3 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: ...

zsh（推荐）：

echo '' >> ~/.zshrc
echo '# Token101 for Claude Code' >> ~/.zshrc
echo 'export ANTHROPIC_BASE_URL="https://token.ppthub.shop/api"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="sk-你的APIKey"' >> ~/.zshrc
source ~/.zshrc

bash：

echo '' >> ~/.bash_profile
echo '# Token101 for Claude Code' >> ~/.bash_profile
echo 'export ANTHROPIC_BASE_URL="https://token.ppthub.shop/api"' >> ~/.bash_profile
echo 'export ANTHROPIC_AUTH_TOKEN="sk-你的APIKey"' >> ~/.bash_profile
source ~/.bash_profile

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

export ANTHROPIC_API_KEY="sk-你的APIKey"

验证环境变量

echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_API_KEY

预期输出：

https://token.ppthub.shop/api
sk-你的APIKey

启动 Claude Code

# 在任意目录启动
claude

# 在指定项目目录启动
cd ~/Projects/my-project
claude

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

"帮我分析这个项目的代码结构"
"这个函数有什么 bug？"
"帮我写一个 Swift 用户认证类"

常见问题

macOS 安全性阻止运行

如果 macOS 阻止 Claude Code 运行：

前往系统设置 → 隐私与安全性
向下滚动找到被阻止的应用
点击仍要打开或允许

找不到 `claude` 命令

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

npm 权限错误（EACCES）

不要使用 sudo，改用以下方式修复权限：

mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc
source ~/.zshrc
npm install -g @anthropic-ai/claude-code

API 返回 401 错误

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

下一步

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