Pi Agent和Claude Code

在windows电脑上安装 为Pi agent，并配置自定义模型。
在windows电脑上安装 为Claude Code，并配置自定义模型。
配置相同模型的话，Pi Agent 和 Claude Code 相比，那个更好，2者的优劣势。

要在 Windows 上从零开始配置一个自主可控的 AI 编程助手，Pi Agent 和 Claude Code 是两种核心路径的代表。简单来说，这像是一个选择：自定义积木 vs 智能成品。

如果你享受从零搭建，渴望极致的掌控和成本效益，Pi Agent 是你的“变形金刚”，我通常会首先推荐 Pi Agent；如果你需要开箱即用，专注于大型项目的复杂重构，Claude Code 则是那个强大的“专用工具”。

💡 配置自定义模型

两者都支持在配置文件中通过设置 API key 和 Base URL 来对接其他兼容的模型提供商。

Pi Agent 实战：比如将 Pi Agent 与 Ollama 或 LM Studio 这类本地服务器连接，即可用上 Gemma 4 这样的模型，实现完全离线的 AI 编程环境。

🏆 深度对比与适用场景

一个“瘦”到极致的 TypeScript 套件和一个功能完备的独立工具，它们的优劣势具体如何：

当使用相同模型时，这种哲学差异会直观地体现在性能和成本上。Pi Agent 极简的设计让它像一个毫无冗余的“精准工具”，而 Claude Code 完备的功能集则像一辆功能齐全但自重较大的“重型卡车”。

🚀 在 Windows 上快速部署

部署步骤配置思路是相通的，下面是把它们跑起来的具体步骤。

1. 安装 Pi Agent

前置要求：

• Node.js (v14+) 或 Bun 运行时。
• Git for Windows：提供 Pi 所需的 bash 环境。

步骤：

1. 安装：以管理员身份打开 Git Bash 或 PowerShell，执行：

   npm install -g @mariozechner/pi-coding-agent
   

   或通过 Bun 安装（推荐，速度更快）：

   bun install -g @oh-my-pi/pi-coding-agent
   

2. 验证安装：

   pi --version
   

3. 配置自定义模型：Pi 的配置非常灵活，你可以在 ~/.pi/agent/models.json 中定义新模型。对于本地模型，例如通过 Ollama 运行 qwen2.5-coder，可以这样配置：

   {
     "models": [
       {
         "id": "ollama-qwen",
         "name": "Qwen 2.5 Coder (Ollama)",
         "provider": "openai-compatible",
         "model": "qwen2.5-coder:latest",
         "baseUrl": "http://localhost:11434/v1",
         "apiKey": "ollama"
       }
     ]
   }
   

   然后，在 Pi 的会话中输入 /model ollama-qwen 即可切换到该模型。

2. 安装 Claude Code

前置要求：

• Node.js (v14+)。
• Git for Windows：获得更好的 Unix 命令兼容性。

步骤：

1. 安装：以管理员身份打开 PowerShell 或 Git Bash，执行：

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

2. 验证安装：

   claude --version
   

3. 配置自定义模型：

   • 环境变量法：使用支持 Anthropic API 或 OpenAI API 的第三方模型服务。通过设置环境变量来覆盖 Claude Code 的默认后端。

     $env:ANTHROPIC_AUTH_TOKEN = "你的第三方API Key"
     $env:ANTHROPIC_BASE_URL = "https://api.third-party.com/v1"
     

   • 包装器法：使用社区工具如 claude-glm-installer，它能自动创建别名，让你用 ccg 等命令调用 GLM 模型，且不影响原版 Claude Code 的使用。

     npx claude-glm-installer
     

总结：

对于追求掌控与效率的你，Pi Agent 那条充满极客精神的 DIY 之路，无疑充满了无法抗拒的吸引力。它能让你深刻体会到"工具为你所用"的自由。虽然 Claude Code 在某些特定场景下有其优势，但它终将需要向更开放、更低成本的方案进化。

希望这份详尽的对比和指南能帮你做出最适合自己的选择～