Pi Coding Agent 的使用与配置包括终端操作、模型选择、项目指令、工具执行和权限边界。它们共同决定一次任务在哪个环境中运行、使用哪些能力，以及用户能观察到什么结果。
内容范围
| 主题 | 主要问题 |
|---|---|
| 使用方式 | 怎样提出任务、补充要求、检查结果和继续工作 |
| 模型与提供商 | 怎样连接模型，区分模型身份、认证与能力 |
| 配置与项目上下文 | 全局设置、项目设置及指令文件怎样影响运行 |
| 内置工具与执行环境 | 文件与命令操作在哪里发生，怎样理解返回结果 |
| 项目信任与安全边界 | 加载项目资源、开放工具与系统权限有何区别 |
| 运行状态与故障排查 | 怎样区分启动、模型、工具和结果层的问题 |
第一次使用可先阅读“使用方式”，再了解模型和配置。排查任务行为时，可以先阅读“运行状态与故障排查”，依次检查启动与加载、当前模型、工作目录、工具结果和最终验收。这个顺序是阅读与排查建议，不是 Pi 强制的执行步骤。