Pi 快速上手：安装、登录服务商和选择模型
用 npm 或安装脚本安装 Pi，用 /login 连接订阅或 API Key，用 /model 和 /thinking 选择模型与思考强度，以及配置文件的位置。
安装
用 npm 安装，需要 Node.js 22.19 或更高版本：
npm install -g --ignore-scripts @earendil-works/pi-coding-agentPi 的正常安装不需要依赖包的生命周期脚本，所以官方的命令带了 --ignore-scripts。
macOS 或 Linux 也可以用安装脚本：
curl -fsSL https://pi.dev/install.sh | sh启动
在你希望它工作的目录里运行：
cd /path/to/project
pi连接模型
在 Pi 里运行：
/login选择一个服务商，Pi 会引导你完成 OAuth 登录或者填入 API Key，凭据保存在 ~/.pi/agent/auth.json。
/login <服务商> 可以查看某个服务商支持哪些登录方式。在远程或无浏览器的机器上，OAuth 回调可能到不了本机，这时按提示把最终的跳转网址或授权码粘贴回 Pi。
/logout 移除某个服务商已保存的凭据。
也可以不保存凭据，直接用环境变量提供 Key，适合 CI：
export ANTHROPIC_API_KEY=sk-ant-...
pi各服务商对应的变量名见 官方文档。
选择模型
| 操作 | 作用 |
|---|---|
/model | 搜索并选择模型。只显示已经有可用凭据的服务商的模型 |
在模型上按 Ctrl+S | 存为新会话的默认模型 |
/thinking | 选择当前模型的思考强度，可选项取决于模型 |
Ctrl+P | 在可用模型之间循环切换 |
/scoped-models | 控制 Ctrl+P 循环哪些模型 |
会话会记录模型和思考强度的变化，恢复会话时一并恢复，不影响新会话的默认值。
配置文件在哪里
| 路径 | 内容 |
|---|---|
~/.pi/agent/ | 用户级配置目录，可用环境变量 PI_CODING_AGENT_DIR 修改 |
~/.pi/agent/auth.json | 保存的 API Key 和 OAuth 凭据。不要提交到代码库 |
~/.pi/agent/models.json | 兼容接口、自定义模型和模型覆盖 |
项目目录下的 .pi/ | 项目级配置，信任项目后才加载 |
安全提醒
项目级的设置和扩展在你信任项目之后会在 Pi 进程里执行。从不可信的目录加载配置之前，先看一下官方的 Security 文档。