TokenPilot 文档

简体中文

English

简体中文

English

主题

2026-05-13
2059
8.5m

Claude Code 接入 TokenPilot 中转服务 ​

学习如何在 Claude Code 命令行工具中配置 TokenPilot 中转服务，高效进行 AI 辅助编程。

实时同步 GET /v1/models
点击模型名称即可复制

TokenPilot 支持的模型清单

共 34 个 模型，覆盖 OpenAI GPT 与 Anthropic Claude 两大系列，统一通过 https://go.aitokenpilot.com/v1 调用。

OpenAI · GPT 系列

共 22 个模型

适用于 Codex、Cursor、Cline、Cherry Studio 等 OpenAI 协议客户端

对话与推理

通用对话、推理、长上下文

o 系列（深度推理）

复杂推理、数学、编程

编程专用

Codex 系列，代码生成与重构

多模态（音频 / 实时）

实时语音、音频输入输出

图像生成

文生图、图像编辑

Anthropic · Claude 系列

共 12 个模型

适用于 Claude Code、CC Switch、Hermes 等 Anthropic 协议客户端

Opus（旗舰推理）

最强推理与代码能力，适合复杂任务

Sonnet（均衡主力）

性能与速度均衡，日常开发首选

Haiku（轻量快速）

快速响应、低成本，适合简单任务

安装指南
快速安装 Claude Code
配置 TokenPilot
接入 TokenPilot 中转服务
基本使用
常用命令和技巧

Claude Code 简介 ​

Claude Code 是 Anthropic 官方推出的命令行 AI 编程助手。它直接在终端运行，能读懂你的代码库、执行命令、编辑文件——把过去要在 IDE 里点来点去的事，变成在终端里说一句话。

Claude Code 接入 TokenPilot ​

Claude Code 原生支持通过 ANTHROPIC_BASE_URL 切换 API 端点。把它指向 TokenPilot（https://go.aitokenpilot.com），就能用一个 token 直接调用 Claude Sonnet / Opus，按 token 实际用量计费。

适合谁 ​

  • 没有 Claude Pro 订阅，但想用 Claude Code CLI 写代码
  • 团队多人共享额度，需要按 token 精确计费的开发者
  • 国内访问 Anthropic 官方端点不稳定，需要中转的用户

和官方的区别 ​

对比项Anthropic 官方TokenPilot
计费方式Claude Pro 月付 $20 起按 token 用量付费
额度限制每 5 小时消息数软限制只看 token 总量
接入方式申请 console API key一个 sk- token 全搞定
国内访问需要稳定网络国内直连

终端原生

无需离开命令行，直接在终端中与 AI 交互

代码理解

自动分析项目结构，理解上下文，精准回答

按量计费

只为实际使用的 token 付费，无固定订阅成本

国内直连

国内主流网络可直连，无需额外代理

安装 Claude Code ​

使用 npm 全局安装 Claude Code：

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

INFO

安装完成后，运行 claude 命令即可启动 Claude Code。

Node.js 版本

Claude Code 要求 Node.js 18 或 20 LTS 及以上。如果未安装，推荐用 nvm / fnm 等版本管理工具。

配置 TokenPilot ​

获取 API Key

访问 TokenPilot 控制台，注册账号并获取 API Key。token 形如 sk-xxxx...，只显示一次，立刻复制保存。

设置环境变量

在终端中设置以下环境变量：

bash
# macOS / Linux
export ANTHROPIC_BASE_URL="https://go.aitokenpilot.com"
export ANTHROPIC_AUTH_TOKEN="sk-xxxxxxxxxx"

注意

  • ANTHROPIC_BASE_URL 不要带 /v1 后缀，Anthropic 协议走的是根路径
  • 用 ANTHROPIC_AUTH_TOKEN，不是 ANTHROPIC_API_KEY —— TokenPilot 走 Bearer 鉴权，读的是前者

验证配置

运行 Claude Code 验证配置是否成功：

bash
claude --version && claude 'Hello, are you connected?'

持久化到 Shell 配置 ​

上面的 export 只对当前会话生效。要每次开新终端都自动加载，写到 shell 配置文件里：

bash
# 追加到 ~/.zshrc（zsh 用户）或 ~/.bashrc（bash 用户）
echo 'export ANTHROPIC_BASE_URL=https://go.aitokenpilot.com' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN=sk-xxxxxxxxxx' >> ~/.zshrc

# 立即生效
source ~/.zshrc
powershell
# 当前会话
$env:ANTHROPIC_BASE_URL = "https://go.aitokenpilot.com"
$env:ANTHROPIC_AUTH_TOKEN = "sk-xxxxxxxxxx"

# 永久生效（用户级环境变量）
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://go.aitokenpilot.com", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "sk-xxxxxxxxxx", "User")

安全提示

token 等同密码 —— 不要写进代码、不要提交到 Git、不要发到聊天群。怀疑泄露立即去后台撤销重建。

回头检查环境变量是否生效：

bash
echo $ANTHROPIC_BASE_URL
# 应输出: https://go.aitokenpilot.com

echo $ANTHROPIC_AUTH_TOKEN
# 应输出: sk-xxxx...（前几位）

基本使用 ​

启动交互会话 ​

在项目根目录启动，Claude 会读取当前目录上下文：

bash
cd ~/your-project
claude

之后就可以直接说：

> 帮我把 services/billing.ts 里的同步调用改成并发
> 这段 OpenAI 兼容请求漏了 Authorization header，补一下
> 给 utils/rate-limiter.ts 加一份单测

单次提问 ​

不进入交互会话，直接问一句：

bash
claude "这个正则匹配不到带连字符的邮箱，帮我修一下"

分析当前目录 ​

bash
claude -p . '帮我捋一下这个项目的鉴权链路'

指定模型 ​

通过 ANTHROPIC_MODEL 环境变量指定默认模型：

bash
# Sonnet 4.6 —— 日常开发推荐，编码能力强
export ANTHROPIC_MODEL=claude-sonnet-4-6

# Opus 4.7 —— 最强推理，适合复杂任务
export ANTHROPIC_MODEL=claude-opus-4-7

# Haiku 4.5 —— 毫秒级响应，便宜 10x
export ANTHROPIC_MODEL=claude-haiku-4-5-20251001

也可以用 --model 临时指定一次：

bash
claude --model claude-opus-4-7 '帮我设计一个支持指数退避的请求重试组件'

或在会话内用 /model 切换。

会话内常用命令 ​

命令说明
/help查看可用命令
/clear清空当前对话上下文
/compact压缩当前会话历史，保留要点，省 token
/model查看或切换当前模型
/cost查看本次会话的 token 消耗
/exit退出会话

最佳实践 ​

按场景选模型 ​

场景推荐模型理由
日常代码生成claude-sonnet-4-6代码质量高、速度合适
架构设计、复杂重构claude-opus-4-7推理深度最好
简单问答、commit messageclaude-haiku-4-5-20251001便宜 10x，速度快
大型代码库分析claude-sonnet-4-6200K 上下文 + 高性价比

控制 token 消耗 ​

  • 上下文塞太满时优先 /compact 压缩历史（保留要点）；彻底换话题就 /clear 清掉
  • 简单任务（写注释、commit message）切到 Haiku
  • 会话结束前用 /cost 看消耗，及时调整
  • 在 .gitignore 加上 .claude/，避免缓存提交进仓库

用 claude-hud 监控用量 ​

claude-hud 是社区做的 Claude Code 插件，在状态栏实时显示本次会话的 token / 上下文使用率，超过阈值会提醒你 /compact 或 /clear，比自己心算靠谱。

bash
# 在 claude 会话内执行
/plugin marketplace add jarrodwatts/claude-hud
/plugin install claude-hud
/reload-plugins
/claude-hud:setup

装完会让你跑一次 /claude-hud:setup 选 statusline 显示项（用量 / 余量 / 模型 / 自定义提示）。设完重启 claude，状态栏就常驻一个用量条。

项目级配置 ​

在项目根目录建 CLAUDE.md，写下项目约定，Claude Code 会自动加载：

markdown
# CLAUDE.md

## 技术栈
- 前端：Vue 3 + Vite + TypeScript + Tailwind CSS
- 后端：Go 1.22 + Gin + sqlc
- 数据库：PostgreSQL，缓存 Redis

## 代码风格
- Go：错误用 wrap 而不是 `fmt.Errorf` 反复格式化；公共包不引用业务模型
- 前端：组合式 API + `<script setup>`，全局状态走 Pinia
- 命名：Vue 组件 PascalCase，composables 用 `use-` 前缀

## 测试
- Go：`go test ./...`，table-driven 风格
- 前端：Vitest，`*.test.ts` 与源文件同目录

替换成你自己的

上面是示例。把它替换成你项目的真实约定 —— 风格、命名、目录、测试规范 —— Claude Code 每次进会话都会读，省去反复交代。

老技巧

  • 在项目根目录运行 Claude Code，让它理解完整的项目上下文
  • 使用 -p 参数指定要分析的文件或目录
  • 配合 Git 使用，让 Claude 帮你 review 代码变更

常见问题 ​

Q: 报错 401 / Authentication failed

API Key 无效或未生效。先确认变量有没有被正确加载，再 curl 自检：

bash
# 确认环境变量已加载（应输出 sk-xxxx...）
echo $ANTHROPIC_AUTH_TOKEN

# curl 自检——返回 200 即通，返回 401 则 token 有问题
curl https://go.aitokenpilot.com/v1/messages \
  -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-4-6","max_tokens":50,"messages":[{"role":"user","content":"hi"}]}'

常见原因：token 复制时首尾带了空格；或用了 ANTHROPIC_API_KEY 而非 ANTHROPIC_AUTH_TOKEN；或 base URL 带了 /v1 后缀。

Q: 报错 connection timeout

网络不通。先测试连通性，再检查公司 / 学校代理是否拦截：

bash
# 测试连通性
curl -I https://go.aitokenpilot.com

# 走本地 HTTP 代理（端口按实际修改）
export HTTPS_PROXY=http://127.0.0.1:7890
claude

Q: 余额不足 / 用量超限

登录 TokenPilot 控制台，在「账户余额」页面充值；在「用量统计」可查看各模型的具体消耗明细。

Q: 如何切换模型？

使用 --model 参数临时指定，如 claude --model claude-opus-4-7；或在会话内用 /model 命令切换。

相关资源 ​

TokenPilot 控制台
管理 API Key、查看用量
Claude Code 官方文档
完整功能说明和高级用法

Copyright © 2026 TokenPilot