登录注册
快速开始Pi

快速开始 / 接入 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 下列出的就是刚才添加的模型。