Pi
安装 Pi Coding Agent，通过 AIGoCode 使用 GPT、Claude 和 Gemini
安装 Pi 后，选择下方一种接入方式，填写 API Key，即可在终端中开始对话和处理项目文件。
安装 Pi
Pi 需要 Node.js 22.19 或更高版本。如果还没有安装，请先阅读 Node.js 环境。
Windows 用户还需要安装 Git for Windows，使用默认安装路径即可。安装后重新打开终端。
运行官方安装命令：
npm install -g --ignore-scripts @earendil-works/pi-coding-agent安装完成后验证版本：
pi --version能看到版本号后继续配置。本教程已在 Windows 的 Pi 0.86.1 上验证。
打开配置文件
打开以下位置的 models.json。如果文件或目录不存在，请先创建，注意文件名不要保存成 models.json.txt。
%USERPROFILE%\.pi\agent\models.json~/.pi/agent/models.json选择下面一种配置，将 sk-your-api-key 替换为对应分组的 API Key 后保存。如果已有其他供应商配置，请将新供应商添加到现有的 providers 中，保留原有内容。
OpenAI 接入
-
前往 AIGoCode API Key 页面，选择支持第三方调用的 Codex（可外接） 分组并创建 API Key。
-
将以下配置写入
models.json：
{
"providers": {
"aigocode-openai": {
"baseUrl": "https://api.aigocode.dev/v1",
"api": "openai-responses",
"apiKey": "sk-your-api-key",
"models": [
{ "id": "gpt-6-astra" }
]
}
}
}Claude 接入
-
前往 AIGoCode API Key 页面，选择支持第三方调用的 Claude Code（可外接） 分组并创建 API Key。
-
将以下配置写入
models.json：
{
"providers": {
"aigocode-claude": {
"baseUrl": "https://api.aigocode.dev",
"api": "anthropic-messages",
"apiKey": "sk-your-api-key",
"models": [
{ "id": "claude-sonnet-5" }
]
}
}
}Gemini 接入
-
前往 AIGoCode API Key 页面，选择支持第三方调用的 Gemini 分组并创建 API Key。
-
将以下配置写入
models.json：
{
"providers": {
"aigocode-gemini": {
"baseUrl": "https://api.aigocode.dev/v1beta",
"api": "google-generative-ai",
"apiKey": "sk-your-api-key",
"models": [
{ "id": "gemini-3.8-flash" }
]
}
}
}验证
在项目文件夹中打开终端，运行：
pi输入“你好”并发送，模型正常回复即表示接入成功。需要切换模型时输入 /model，选择要使用的模型后继续发送消息。
也可以让 Pi 读取项目中的一个文件并简要说明内容，确认它能正常调用工具。
常见问题
遇到 401、403、429 时查看 错误码。如果模型不可用，检查 API Key 所属分组、请求地址和 模型名称列表。连接失败时检查网络或代理设置。
更多用法见 Pi 官方文档。