macOS 的本地 API 调试代理

让每一次 API
联调更可控。

转发请求、处理 CORS、注入 Header、模拟响应,并把重复配置交给 AI Agent。 AgentProxy 常驻菜单栏,专注你真正要验证的那一条流量。

支持 macOS 13+ · 轻量本地运行 · 源码可审阅

PROXY CONTROL CENTER
AgentProxy 控制面板,含开启代理、请求转发、CORS 与 Mock 功能
LIVE RULEapi.example.com→ localhost:3000
System proxy ready

为本机开发而生

不改变你的应用代码

规则可被 Agent 自动化

一台 Mac,一个可控的调试入口

从请求到响应,
每一环都能介入。

不是又一个笨重的抓包工具。AgentProxy 用清晰规则处理本地开发中最常见、最消耗心力的 API 问题。

01
请求转发

把线上请求,安全导向本地

按域名、路径、方法和排除条件配置规则;将真实流量路由到 localhost 或测试环境,不改一行业务代码。

02
CORS · Headers

调 CORS、Header,不再靠猜

命中规则即可自动处理预检与响应头,也可分别注入请求头和响应头,定位联调问题更直接。

03
API Mock

用 Mock 让前端继续向前

根据 URL 与方法返回本地响应,支持状态码和 JSON body。后端未就绪时,体验和开发都不用停。

04
Agent-ready CLI

让 AI Agent 也能操作代理

内置 agentproxyctl,JSON 输出、manifest、schema 与示例齐备,可由 Claude Code、Cursor 等 Agent 编排配置。

从安装到第一条规则

少一点环境配置,
多一点验证结果。

无需手动填写代理端口。开启时,AgentProxy 会自动分配本地端口并写入 macOS HTTP/HTTPS 系统代理配置。

获取最新版 DMG
  1. 01

    安装

    下载 DMG,拖入 Applications。

  2. 02

    设置

    添加一条转发、CORS 或 Mock 规则。

  3. 03

    开启

    点击开启代理,系统代理自动指向本机。

为 AI Agent 而设计,不是后来补上的

把代理配置
写进你的 workflow。

agentproxyctl 以 JSON 输出配置结果,内置命令 manifest、schema 和示例。让你的 Agent 不止会写代码,也能搭好本地联调环境。

JSON-firstSelf-describing CLIHot reload rules
agentproxyctl
$ agentproxyctl forward add \--name local-api \--match api.example.com \--target http://127.0.0.1:3000 Rule created and synced to AgentProxy$ agentproxyctl ai manifest --pretty{ "ok": true, "commands": [...] }

为这些时刻准备

调试,不该成为
交付的瓶颈。

01

前后端并行开发

用转发与 Mock 把未完成的接口变成可验证的体验。

02

跨域与权限排查

按 URL 精确处理预检和响应头,确认真正的接口行为。

03

多环境 API 验证

在生产、预发与 localhost 之间切换,不再改 hosts 或重打包。

常见问题

关于 AgentProxy

AgentProxy 适合谁?

适合在 macOS 上做 Web、客户端或 API 联调的开发者,尤其是需要请求转发、跨域调试、Mock 和 Header 注入的人。

HTTPS 请求可以调试吗?

可以。安装并信任本地根证书后,可对标准 443 HTTPS 连接进行本地拦截和规则处理;使用证书固定的应用可能不兼容。

它会把流量上传到云端吗?

不会。代理服务与规则均在本机运行,AgentProxy 是面向本地开发调试的工具。

可以用 AI Agent 配置吗?

可以。内置 agentproxyctl CLI 提供 JSON 输出、命令清单、schema 和示例,便于开发 Agent 按规则读写配置。

下载的 DMG 可以直接安装吗?

可以。将 App 拖到 Applications 后打开即可;当前安装包尚未进行 Apple Developer ID 签名和公证,首次打开时 macOS 可能要求你在“系统设置”中确认。

准备好把调试变简单了吗?

给你的 API
一条更短的路。

下载 AgentProxy for macOS

DMG 安装包 · macOS 13+ · 开源仓库可审阅