快速开始 / 接入 Agent 工具
接入 Pi
Pi 是 Mario Zechner 开源的终端 AI 编程助手,界面简洁,可以通过配置文件接入任意模型服务。本站以 Anthropic 格式接入。
一键配置
已经安装 Pi 时,运行下面这行命令,把 Key 换成你自己的,会自动写好配置(原配置会先备份)。API Key 在控制台的 API Keys 页创建。
在终端中执行:
curl -fsSL https://tokenjoy.org/setup.sh | TOKENJOY_BASE_URL=https://api.tokenjoy.org sh -s -- <你的 API Key> pi claude-sonnet-4-6
创建 Key 时弹出的窗口里可以选择 Pi,命令中已经带上了你的 Key,直接复制即可。默认模型为 claude-sonnet-4-6,之后可以随时切换。
手动配置
1. 安装 Pi
安装 Node.js 20.6 或更高版本。然后执行:
npm install -g @mariozechner/pi-coding-agent
2. 添加模型提供方
编辑 ~/.pi/agent/models.json(没有就新建),加入本站。已有其他提供方时,只在 providers 里加入 tokenjoy 这一项:
~/.pi/agent/models.json
{
"providers": {
"tokenjoy": {
"baseUrl": "https://api.tokenjoy.org",
"api": "anthropic-messages",
"apiKey": "TOKENJOY_API_KEY",
"models": [
{
"id": "claude-sonnet-4-6",
"reasoning": true,
"input": [
"text",
"image"
],
"contextWindow": 200000,
"maxTokens": 32000
}
]
}
}
}baseUrl填https://api.tokenjoy.org,不带/v1:Pi 会自己加上/v1/messages。apiKey写环境变量名时,Pi 会读取这个环境变量;也可以直接写 Key。models里可以加入 模型列表中的其他 Claude 模型,只有id是必填项。- 想用 GPT 模型,再加一个提供方,
api填openai-responses,baseUrl填https://api.tokenjoy.org/v1。
然后设置 Key:API Key 在控制台的 API Keys 页创建。
加到 ~/.zshrc 或 ~/.bashrc 末尾
export TOKENJOY_API_KEY="<你的 API Key>"
再在 ~/.pi/agent/settings.json 中把本站设为默认:
~/.pi/agent/settings.json
{
"defaultProvider": "tokenjoy",
"defaultModel": "claude-sonnet-4-6"
}3. 开始使用
cd /path/to/my-project pi
进去后输入 /model 可以切换模型,TokenJoy 下列出的就是刚才添加的模型。