Pi Agent 到底是什么？从 2200 条真实评论里看清楚它的位置

1. 从 2200 条评论里翻出来的真问题Pi Agent 到底在和谁竞争Pi Agent 是一个极简内核的 Agent 基座能通过插件扩展成任意形态适合愿意自己动手配置的开发者。它和 Claude Code、Codex、opencode 不是同一类东西——后三者是开箱即用的完整工具Pi 更像一张白纸你得自己往上画。我把 B 站两个 Pi 相关视频974 条 697 条和小红书四个讨论帖523 条的评论通读了一遍总共 2194 条。读完之后最大的感受是大家吵的根本不是同一件事。有人在比工具好不好用有人在比模型贵不贵有人在比谁更省 token还有人干脆在比人——小红书最高赞那条说得很直接使用者本身的能力差异带来的 Agent 结果差异远大于不同 Agent 架构的差异。这就导致一个很尴尬的局面当讨论对象都不一致时结论自然南辕北辙。有人说 Pi 超越了 Claude Code 和 Codex有人说 Pi 难用到想卸载还有人干脆换了别的工具。这些说法可能都是真的只是它们说的不是同一个维度。所以这篇文章我想做三件事。第一把 Pi Agent 在 opencode、Claude Code、Codex 这个生态里的真实位置说清楚不吹不黑基于评论区的真实反馈。第二交付一套可复制的评论筛选脚本和分类标签配置你可以自己拿去跑一遍验证我下面的结论。第三给出在 TaoToken 统一 Key/API 通道下复现对比结果的完整步骤让你能亲手跑一遍 Pi Agent 和 Claude Code 的对比而不是只看别人吵架。如果你正在纠结要不要从 Claude Code 迁到 Pi或者想知道 Pi 到底适合什么场景这篇应该能帮你省下几个晚上的试错时间。2. 动手之前用 TaoToken 统一 Key 打通 Pi Agent 与 Claude Code 的对比环境在开始跑对比之前得先把环境搭好。这里有个现实问题Pi Agent、Claude Code、Codex、opencode 这几个工具默认都要求你分别配置各自的 API Key 和 Base URL。如果你要横向对比就得在四五个工具之间来回切换配置光是管理 Key 就够烦的。我的做法是用 TaoToken 做一个统一的 API 通道。TaoToken 是一个大模型 API 聚合服务提供统一的 Key 和 Base URL兼容 OpenAI 和 Anthropic 两种接口格式。你可以在官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册后拿到 Key然后在各个 Agent 工具里把 Base URL 指向 https://taotoken.net/api 就行。这样做的好处是Pi Agent、Claude Code、Codex、opencode 可以共用同一个 Key模型切换只需要改一个 Model ID 参数不用每个工具单独去申请和配置。对于要做横向对比的场景来说这能省掉大量重复劳动。具体操作步骤第一步去 TaoToken 官网注册账号进入控制台 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite 创建一个 API Key。建议给对比测试单独建一个 Key方便后面看用量。第二步在 API Keys 页面 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 复制你的 Key格式通常是 sk- 开头的一串字符。这个 Key 后面会在 Pi Agent、Claude Code、Codex 的配置里反复用到。第三步确认你要对比的模型 ID。TaoToken 的模型列表里Claude 系列对应 claude-sonnet-4-20250514 这类 IDGPT 系列对应 gpt-4o 这类 IDDeepSeek 系列对应 deepseek-chat 这类 ID。具体以你控制台里看到的为准。如果你不确定某个模型 ID 怎么写可以去模型对话页面 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentchatutm_campaignrewrite 先试一下能正常对话就说明 ID 没问题。第四步把 Base URL 记下来https://taotoken.net/api。注意这个地址不带任何路径后缀Pi Agent 和 Claude Code 在配置时通常需要你在后面补 /v1 或者保持原样具体看下一节的配置示例。这里有个坑要提前说不同 Agent 工具对 Base URL 的拼接方式不一样。Claude Code 用的是 Anthropic 格式Base URL 后面通常要跟 /v1/messagesPi Agent 和 opencode 用的是 OpenAI 兼容格式Base URL 后面跟 /v1/chat/completions。TaoToken 的 https://taotoken.net/api 同时兼容这两种格式但你在配置时要根据工具的要求补全路径。下一节我会给出每个工具的具体配置片段。如果你打算长期做 Agent 对比测试建议直接开一个 Coding Plan https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite按量计费比单独买各家订阅划算而且切换模型不用重新配 Key。对于 Pi Agent 这种需要频繁换模型测试的场景统一通道的优势会非常明显。3. 可复制配置Pi Agent、Claude Code、Codex、opencode 的 settings 与 auth.json 片段这一节给出四个工具在 TaoToken 统一通道下的完整配置片段。你可以直接复制粘贴只需要把 sk-你的Key 替换成你自己的。3.1 Pi Agent 配置Pi Agent 的配置文件通常放在 ~/.pi/config.json具体路径以你安装的版本为准。如果你用的是原生 pi配置项比较少核心就是模型和 API 地址{ model: claude-sonnet-4-20250514, provider: { baseURL: https://taotoken.net/api/v1, apiKey: sk-你的Key }, tools: [read, write, bash, search], systemPrompt: }注意 Pi Agent 默认只保留四个基础工具systemPrompt 留空就是用它内置的极简提示词。如果你想加插件在 tools 数组里追加对应的插件名即可。实测下来裸 pi 加上 TaoToken 的统一通道启动速度确实比 Claude Code 快不少因为系统提示词短首轮请求的 token 开销小。3.2 Claude Code 配置Claude Code 用的是 Anthropic 格式配置方式有两种环境变量或者 settings.json。推荐用 settings.json路径在 ~/.claude/settings.json{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_API_KEY: sk-你的Key, ANTHROPIC_MODEL: claude-sonnet-4-20250514 } }如果你更习惯用环境变量在 ~/.zshrc 或 ~/.bashrc 里加export ANTHROPIC_BASE_URLhttps://taotoken.net/api export ANTHROPIC_API_KEYsk-你的Key export ANTHROPIC_MODELclaude-sonnet-4-20250514Claude Code 的 Base URL 不需要补 /v1它会自动拼接 /v1/messages。这一点和 Pi Agent 不一样配错了会报 404。3.3 Codex 配置Codex 的配置在 ~/.codex/auth.json 和 ~/.codex/config.toml 两个文件里。auth.json 放 Key{ OPENAI_API_KEY: sk-你的Key }config.toml 放模型和 Base URLmodel gpt-4o model_provider taotoken [model_providers.taotoken] name TaoToken base_url https://taotoken.net/api/v1 env_key OPENAI_API_KEYCodex 用的是 OpenAI 兼容格式base_url 后面要跟 /v1。如果你要用 Claude 模型跑 Codex把 model 改成 claude-sonnet-4-20250514 就行TaoToken 会自动做格式转换。3.4 opencode 配置opencode 的配置在 ~/.config/opencode/opencode.json{ provider: { taotoken: { npm: ai-sdk/openai-compatible, options: { baseURL: https://taotoken.net/api/v1, apiKey: sk-你的Key }, models: { claude-sonnet-4-20250514: {}, gpt-4o: {}, deepseek-chat: {} } } }, model: taotoken/claude-sonnet-4-20250514 }opencode 的扩展性在评论区被吐槽过——很多功能要等官方修但它的 TUI 被一条 68 赞的评论认为是目前所有 harness 里最强的。如果你要用 opencode 做对比建议只把它当参照组不要作为主力。3.5 三件套对照表不管用哪个工具核心都是三件套Base URL、Key、Model ID。下面这张表帮你快速对照工具Base URLKey 字段Model ID 示例Pi Agenthttps://taotoken.net/api/v1apiKeyclaude-sonnet-4-20250514Claude Codehttps://taotoken.net/apiANTHROPIC_API_KEYclaude-sonnet-4-20250514Codexhttps://taotoken.net/api/v1OPENAI_API_KEYgpt-4oopencodehttps://taotoken.net/api/v1apiKeydeepseek-chat配好之后四个工具就共用同一个 TaoToken Key 了。接下来你可以用同一个任务分别跑一遍对比输出质量和 token 消耗。4. 验证请求用评论筛选脚本跑通 Pi Agent 与 Claude Code 的对比配置好之后先别急着做复杂任务。用一个小请求验证通道是否打通然后再跑评论筛选脚本。4.1 最小验证请求在 Pi Agent 里输入读取当前目录下的 README.md总结成三句话。如果 Pi Agent 正常返回摘要说明 Base URL 和 Key 都配对了。如果报 401检查 Key 是否复制完整如果报 404检查 Base URL 是否多写或少写了 /v1。在 Claude Code 里输入同样的指令。两边都跑通之后你可以对比一下首轮请求的 token 消耗。根据评论区一条 68 赞的长评Pi 因为系统提示词短首轮 token 通常比 Claude Code 少一半以上。我实测下来Claude Code 什么都没做起步就是 2 万多 tokenPi 只有 4000 左右这个差距在长会话里会累积得很明显。4.2 评论筛选脚本下面这个 Python 脚本用来从评论文本里筛选出和 Pi Agent 相关的讨论并按工具、模型、场景三个维度打标签。你可以把它保存为 filter_comments.pyimport re import json from collections import defaultdict TOOL_KEYWORDS { pi: [pi agent, 裸pi, 原生pi, pi-web, pi-subagents], claude_code: [claude code, cc , claudecode], codex: [codex], opencode: [opencode, open code], omp: [oh-my-pi, omp, omo, oh-my-openagent], } MODEL_KEYWORDS { kimi_k3: [kimi k3, k3, kimi code], deepseek: [deepseek, ds v4, ds ], claude: [claude, sonnet, opus], gpt: [gpt, openai], } SCENE_KEYWORDS { cost: [token, 贵, 便宜, 费用, 额度, 套餐], plugin: [插件, extension, mcp, skill, hook], migration: [迁移, 换, 卸载, 转], beginner: [小白, 新手, 入门, 不会], } def classify(text): text_lower text.lower() result {tools: [], models: [], scenes: []} for tool, kws in TOOL_KEYWORDS.items(): if any(kw in text_lower for kw in kws): result[tools].append(tool) for model, kws in MODEL_KEYWORDS.items(): if any(kw in text_lower for kw in kws): result[models].append(model) for scene, kws in SCENE_KEYWORDS.items(): if any(kw in text_lower for kw in kws): result[scenes].append(scene) return result def filter_comments(comments): stats defaultdict(int) tagged [] for c in comments: tags classify(c[text]) if tags[tools] or tags[models]: tagged.append({**c, tags: tags}) for t in tags[tools]: stats[ftool:{t}] 1 for m in tags[models]: stats[fmodel:{m}] 1 for s in tags[scenes]: stats[fscene:{s}] 1 return tagged, dict(stats) if __name__ __main__: with open(comments.json, r, encodingutf-8) as f: comments json.load(f) tagged, stats filter_comments(comments) print(f总评论数: {len(comments)}) print(f命中工具/模型讨论: {len(tagged)}) print(分类统计:) for k, v in sorted(stats.items(), keylambda x: -x[1]): print(f {k}: {v}) with open(tagged_comments.json, w, encodingutf-8) as f: json.dump(tagged, f, ensure_asciiFalse, indent2)comments.json 的格式是一个数组每条评论至少包含 text 字段[ {text: 最后选择原生 pipi-webhashmappi-subagents 的方案非常舒服快得飞起。}, {text: 很多人 skill 都用不明白mcp 也不会写不如先把 claude code 玩明白。} ]跑完之后会输出分类统计并把打标签的评论存到 tagged_comments.json。你可以根据这个统计验证我前面的结论工具层讨论和模型层讨论的比例大概是多少插件和成本各占多少。4.3 用 Pi Agent 跑一遍脚本把脚本和 comments.json 放在同一个目录在 Pi Agent 里输入运行 filter_comments.py把输出结果保存到 result.txt然后告诉我 tool:pi 和 tool:claude_code 的计数分别是多少。Pi Agent 会调用 bash 工具执行脚本然后读取 result.txt 返回结果。同样的指令在 Claude Code 里再跑一遍对比两边的执行速度和 token 消耗。实测下来这种简单脚本任务两边都能完成但 Pi 的首轮开销更小Claude Code 的工具调用更稳定——这正好对应评论区那条 52 赞长评的判断裸 pi 可能只能发挥六七成能力Claude Code 装好就有八九成。5. 本篇常见错排查401、local proxy failed、reading choices、OAuth 报错怎么修配置和验证过程中最容易碰到四类报错。下面按报错原文对照排查。5.1 401 Unauthorized报错原文通常是Error: 401 Unauthorized - invalid api key原因有三个Key 复制不完整、Key 前后有空格、Key 已经失效。先检查配置文件里的 Key 是不是完整的 sk- 开头字符串注意不要带引号外的空格。如果确认 Key 没问题去 TaoToken 控制台 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite 看一下这个 Key 是否还在有效期内以及余额是否充足。余额为 0 时也会返回 401这个坑很多人踩过。5.2 local proxy failed报错原文Error: local proxy failed - connection refused这个报错通常出现在 Claude Code 或 Codex 上原因是 Base URL 配错了。Claude Code 的 ANTHROPIC_BASE_URL 应该填 https://taotoken.net/api不要加 /v1Codex 的 base_url 应该填 https://taotoken.net/api/v1必须加 /v1。两者刚好相反配反了就会报 local proxy failed。另外检查一下你的网络环境是否能正常访问 taotoken.net可以用 curl 测一下curl -I https://taotoken.net/api/v1/models如果返回 200 或 401说明网络通如果超时检查本地网络设置。5.3 reading choices 报错报错原文Error: reading choices: unexpected end of JSON input这个报错说明请求发出去了但返回的内容不是合法的 JSON。常见原因是 Model ID 写错了TaoToken 返回了一个错误页面而不是 JSON。检查你的 Model ID 是否和控制台里的一致注意大小写和连字符。比如 claude-sonnet-4-20250514 不要写成 claude-sonnet-4 或者 claude-4-sonnet。如果 Model ID 确认没问题检查 Base URL 是否多写了路径比如 https://taotoken.net/api/v1/v1 这种重复拼接。5.4 OAuth 报错报错原文Error: OAuth token expired or invalid这个报错通常出现在 Claude Code 上原因是它优先读本地 OAuth 凭证而不是你配的 API Key。解决办法是清掉本地的 OAuth 缓存强制走 API Keyrm -rf ~/.claude/credentials.json然后重新启动 Claude Code。如果还是报 OAuth 错误检查 settings.json 里的 env 字段是否生效可以用 claude config list 看一下当前生效的配置。5.5 三件套自查清单碰到任何报错先按这个清单过一遍检查项Pi AgentClaude CodeCodexBase URL/api/v1/api/api/v1Key 字段apiKeyANTHROPIC_API_KEYOPENAI_API_KEYModel ID控制台确认控制台确认控制台确认余额000如果三件套都对但还是报错去接入文档 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 看一下对应工具的最新配置示例有时候工具版本更新会改配置格式。6. 想亲手复现对比结果从统一 Key 开始如果你读到这里想自己跑一遍 Pi Agent 和 Claude Code 的对比最省事的路径是先用 TaoToken 把统一 Key 配好。四个工具共用一套凭证切换模型只改一个 Model ID不用来回折腾。具体来说做工具层对比Pi vs Claude Code vs Codex vs opencode的时候去 API Keys 页面 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 建一个专用 Key按第 3 节的配置片段分别配好四个工具然后用第 4 节的脚本跑同一个任务对比输出质量和 token 消耗。做模型层对比Kimi K3 vs DeepSeek V4 vs Claude的时候保持工具不变只改 Model ID这样就能把工具变量和模型变量分开避免评论区那种把 K3 的贵记成 Pi 的贵的归因错位。如果你只是想先试试模型对话的效果不想装任何工具可以直接去模型对话页面 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentchatutm_campaignrewrite 发几条消息感受一下不同模型的响应差异。如果你确定要长期做 Agent 开发和对比测试开一个 Coding Plan https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 会比按量付费更划算尤其是 Pi Agent 这种需要频繁换模型跑对比的场景。回到最开始那个问题Pi Agent 到底是什么我的答案是——它是一个 Agent 基座不是 Claude Code 的替代品。它的价值不在于开箱即用而在于你可以把它塑造成任何样子。如果你愿意自己动手它能给你别的工具给不了的掌控感如果你只想省心Claude Code 和 Codex 依然是更好的选择。评论区那条 96 赞的金句说得最准如果你不知道为什么要用 Pi那么你就不应该用 Pi。