Pi (终端极简编程助手) 接入指引

Pi（@earendil-works/pi-coding-agent）是一款现代、极速、高扩展性的终端 AI 编程助手。它内置完整的代码阅读、终端执行（Bash）、文件编辑与写入工具，支持通过丰富的协议接入第三方大语言模型。

通过 GWLLM，您可以让 Pi 连接 Claude Opus/Sonnet 5.5、GPT-6 Sol、Gemini 4 Argon、Grok 4.7 等旗舰模型进行全自动结对编程。

---

配置文件路径

Pi 的自定义模型配置文件默认位于用户主目录下：

• macOS / Linux：~/.pi/agent/models.json
• Windows：%USERPROFILE%\.pi\agent\models.json

如果该文件或目录不存在，您可以手动创建它。

---

配置步骤

编辑 ~/.pi/agent/models.json，在 providers 对象中添加 GWLLM 服务配置。

Pi 同时支持 Anthropic Messages 协议（推荐用于 Claude 系列）和 OpenAI 兼容协议（推荐用于 GPT / Gemini / Grok 等）：

{
  "providers": {
    "gwllm": {
      "name": "GWLLM (Anthropic)",
      "baseUrl": "https://gwllm.com",
      "api": "anthropic-messages",
      "apiKey": "sk-您的GWLLM令牌",
      "models": [
        {
          "id": "claude-opus-5-5",
          "name": "Claude Opus 5.5",
          "reasoning": true,
          "input": ["text", "image"],
          "contextWindow": 1048576,
          "maxTokens": 32768
        },
        {
          "id": "claude-sonnet-5-5",
          "name": "Claude Sonnet 5.5",
          "reasoning": true,
          "input": ["text", "image"],
          "contextWindow": 1048576,
          "maxTokens": 16384
        }
      ]
    },
    "gwllm-openai": {
      "name": "GWLLM (OpenAI Compatible)",
      "baseUrl": "https://gwllm.com/v1",
      "api": "openai-completions",
      "apiKey": "sk-您的GWLLM令牌",
      "models": [
        {
          "id": "gpt-6-sol",
          "name": "GPT-6 Sol",
          "reasoning": true,
          "input": ["text", "image"],
          "contextWindow": 1048576,
          "maxTokens": 32768
        },
        {
          "id": "gemini-4-argon",
          "name": "Gemini 4 Argon",
          "reasoning": true,
          "input": ["text", "image"],
          "contextWindow": 1048576,
          "maxTokens": 32768
        },
        {
          "id": "grok-4.7",
          "name": "Grok 4.7",
          "reasoning": true,
          "input": ["text", "image"],
          "contextWindow": 524288,
          "maxTokens": 16384
        }
      ]
    }
  }
}

> `maxTokens` 为客户端本地生成上限，按需调整，不影响计费。

注意事项

1. 若使用 anthropic-messages 协议，baseUrl 填写 https://gwllm.com。
2. 若使用 openai-completions 协议，baseUrl 建议填写带有版本路径的 https://gwllm.com/v1。
3. 请将 sk-您的GWLLM令牌 替换为在 GWLLM 控制台生成的真实 API Key。

---

启动与使用

1. 启动交互式编程会话

在你的代码工程根目录下运行以下命令，即可启动 Pi 并开始结对编程：

# 使用 Claude Sonnet 5.5
pi --provider gwllm --model claude-sonnet-5-5

# 使用 GPT-6 Sol
pi --provider gwllm-openai --model gpt-6-sol

2. 多模型轮换体验

你可以通过 --models 参数指定允许轮换的模型范围，在交互界面中通过 Ctrl+P 快捷键即时切换不同模型：

pi --models "gwllm/*,gwllm-openai/*"

3. 一次性命令行执行 (Print 模式)

无需进入交互式界面，直接在终端中让 Pi 处理任务并输出结果：

# 审查 Git 暂存区改动
git diff --staged | pi --provider gwllm --model claude-sonnet-5-5 -p "审查这段代码变更，指出潜在隐患并提出优化建议"

# 读取并重构某个文件
pi --provider gwllm --model claude-sonnet-5-5 -p @src/utils.ts "为其中的所有导出函数补充类型声明与单元测试用例"

4. 会话恢复与继续

Pi 具备持久化会话机制，可以在后续继续推进未完成的编码任务：

• pi -c：继续上一次最近的会话。
• pi -r：弹出历史会话列表，选择并恢复任意历史会话。