快速开始
本文带你从 fresh checkout 或 release binary 开始，跑起本地代理，并配置一个上游 provider。
- 1安装或构建 ProxAI使用 release 可执行文件，或在本地构建 Rust 项目。
- 2先运行一次生成 app 目录和本地配置文件。
- 3配置一个 provider设置 provider protocol、base_url、api_key 和默认路由。
- 4连接客户端把客户端 base URL 指向本地代理，并发送一个小请求。
| 端点 | 默认 URL | 用途 |
|---|---|---|
| Proxy | http://127.0.0.1:18080 | OpenAI 兼容与 Anthropic 风格请求代理 |
| MCP | http://127.0.0.1:18081/mcp | 本地 MCP 控制面 |
有些客户端需要不带 /v1 的 base URL，有些需要完整 endpoint path。按客户端约定填写即可；ProxAI 实际服务 /v1/responses、/v1/chat/completions 和 /v1/messages。
App 目录
Section titled “App 目录”运行时文件会生成在用户 app 目录：
| 平台 | 路径 |
|---|---|
| Windows | %USERPROFILE%\.proxai\ |
| Linux/macOS | ~/.proxai/ |
重要文件和目录：
config.toml—— 本地运行时配置，刻意不进入 gitconfig.example.toml—— 生成的示例/参考配置logs/—— 运行日志captures/—— 可选的分阶段请求/响应捕获
最小 provider 配置
Section titled “最小 provider 配置”先配置一个 provider，并为你要使用的入站协议设置默认路由：
[routing.default_provider_names]openai_responses = "openai"openai_chat_completions = "openai"
[providers.openai]protocol = "openai_responses"base_url = "https://api.openai.com"api_key = "..."如果上游使用 Anthropic Messages，把 provider protocol 设为 "anthropic_messages"，并填写对应 provider base URL/key。支持的协议取值见 协议。
客户端 base URL 指向本地代理：
http://127.0.0.1:18080如果客户端 UI 强制要求填写 API key，通常可以填一个 dummy key。对于 OpenAI 兼容 provider，ProxAI 会使用 config.toml 里的 provider key，而不是转发客户端原始 Authorization header。
验证是否成功
Section titled “验证是否成功”| 检查项 | 预期结果 |
|---|---|
| Proxy 启动 | 没有配置加载错误；默认监听 127.0.0.1:18080 |
| 客户端请求到达 ProxAI | 日志显示紧凑 request summary，不包含私有 body 内容 |
| Provider 被选中 | Route/default provider 解析到配置好的 provider 名称 |
| 上游返回响应 | 客户端收到协议兼容响应，或紧凑的 upstream error |
如果检查失败，去 常见排障，并为一次脱敏请求 capture 最窄的有用 phase。