远程接入（公网 AI）
在 claude.ai 网页版（或任何支持远程 MCP 的 AI 客户端）里聊天，AI 就能直接动手改你电脑上的项目：读代码、改代码、编译、跑测试、提交，不用再在网页和编辑器之间来回复制粘贴。
网页上的 AI 当「大脑」，智码给它「手脚」。智码全程不调用你电脑上的任何 AI 命令行，所以本机 CLI 登录不了、只能用网页版时，照样能让 AI 动手写代码。
关于额度
干活消耗的是网页端 AI 账号的额度。如果网页版和本机 Claude Code 用的是同一个 Claude 订阅，两边额度是共用的 —— 远程接入解决的是「能不能动手」，不是「省额度」。
它解决什么问题
| 不接入 | 远程接入 | |
|---|---|---|
| 谁读代码 | 你复制给 AI | AI 自己读、自己搜 |
| 谁改代码 | 你手动粘回编辑器 | AI 直接改，改完回显改动片段 |
| 谁编译测试 | 你跑，再把报错贴回去 | AI 自己跑，看到报错自己修 |
| 要不要本机 CLI | 不涉及 | 不需要，CLI 登录不了也能干活 |
| 在哪能用 | 只能坐在电脑前 | 任何能打开网页 AI 的地方，手机也行 |
典型场景：某个账号登不上 Claude Code 这类命令行工具、只能用网页版；出门在外，想让家里那台电脑上的项目修个 bug、跑一遍测试。
能做什么
| 能力 | 说明 |
|---|---|
| 读懂项目 | 识别技术栈、项目 CLAUDE.md 规范和 .claude/skills 技能体系，动手前先按项目自己的规矩来 |
| 读写代码 | 按行读（带行号）、跨文件搜索、多处原子修改（全部成功才写入）；兼容 CRLF / BOM / GBK，改完不会把文件格式改乱 |
| 防覆盖 | 读文件时拿到版本号，修改时带上；期间文件被别人改过会拒绝写入，让 AI 先重读再改 |
| 执行命令 | 编译、测试、装依赖、git add / commit；Windows 上默认用 Git Bash，长任务先返回「还在跑」，AI 接着等结果 |
| 结构化编译检查 | 直接给出「哪个文件第几行什么错」；TypeScript 走增量编译，第二次检查只要几秒 |
| 只读看 git | 状态、差异、提交记录 |
| 内置浏览器 | 打开网页、点击、填表；截图直接回传给 AI 看；页面快照只列看得见的元素并带坐标；console 报错带调用栈 |
| 看图片 | 项目里的图片、截图，AI 能直接看到画面 |
| 转接本机 MCP | 你电脑上的 sigil（凭据库）、reeve（运维）等，网页 AI 也能调用，见下文 |
五分钟上手
第一步：启动远程网关
远程接入复用「远程访问」的网关和公网地址，不另开端口。
设置 → 远程访问：填好公网访问地址并点「启动」。还没有公网地址的话，按安装与网络方案里的「网络方案」一节，用 frp / Cloudflare Tunnel / Tailscale 等任选一种把端口暴露出去。第二步：打开远程接入、勾选信任目录
设置 → MCP 接入 → 「远程接入（公网）」区块：
- 打开开关，状态变成「可连接」
- 在信任目录里勾选允许 AI 操作的项目。列表里是你用过的项目目录，可「全选」或「只选有技能的」，没列出来的点「添加目录」
- 复制连接器 URL，或者分开复制端点 URL 和请求头
远程专用密钥
这是远程专用的密钥，和本机接入的 token、手机配对 token 都不是同一个。「重置密钥」或「紧急断开」只影响远程，不影响本机。
第三步：在 AI 客户端里添加连接器
| 客户端 | 怎么填 |
|---|---|
| claude.ai 网页版 / 手机 App | 设置 → 连接器 → 添加自定义连接器：URL 填端点 URL，认证选「无需登录」，再「添加请求头」，填 Authorization 和上面复制的值 |
| Cursor 等用 JSON 配置的客户端 | 直接复制「JSON 配置」那一行 |
| 不能自定义请求头的客户端 | 用备用 URL（密钥在路径里，见下方提醒） |
备用 URL 慎用
备用 URL 把密钥放进了地址里，往往会明文显示在客户端界面上，拿到 URL 就等于拿到密钥。能填请求头的客户端都优先用请求头。
第四步：开始干活
在对话里直接说：
用智码看看我的 tauri-cc 项目，帮我把 xx 的 bug 修了，改完跑一下测试AI 会依次：列出信任目录 → 读项目规范和技能 → 搜相关代码 → 修改 → 编译测试 → 汇报改了什么。
claude.ai 会逐个工具问授权
第一次用某个工具时，claude.ai 会单独弹一次授权，点「始终允许」后就不再问。这是 claude.ai 自己的机制，与智码无关。
权限三档
原则是能给的权限尽量给足，只在真正危险的地方拦。否则 AI 每动一步都要你点确认，就不如自己动手了。
| 档位 | 包括 | 处理方式 |
|---|---|---|
| 直接放行 | 信任目录内读 / 写 / 改文件，项目技能与经验，只读 git，执行命令，内置浏览器，会话历史、记忆、片段 | 不打扰你 |
| 桌面审批 | 危险命令（rm -rf、git reset --hard、强删分支、按 PID 结束进程等），切换 API 档案，读写浏览器 Cookie / Storage，启动桌面程序，以及以后新增、还没归类的工具 | 你电脑上弹窗，「允许一次」才执行；一段时间内不处理按拒绝 |
| 直接拒绝 | 信任目录外的路径，.git / .env / 私钥文件，本机 git push / pull / fetch / clone，读取凭据（git credential、gh auth token），按进程名结束进程（taskkill /IM 等），以及任何会在本机起 AI CLI 的工具 | 不执行，并告诉 AI 原因和正确做法 |
几个细节：
- 拒绝会说清原因：AI 收到的是「为什么不行、该怎么做、需要你去哪里设置」，它会原样转告你，不会自己乱猜。
- 联网 git 为什么直接拒：本机 git 联网会弹凭据窗口等人点，远程触发没人点，会一直卡到超时。推送请走 sigil（见下文）。
- 按进程名为什么直接拒：同名的 node / powershell 里有智码自己、你的其它会话和终端，会被一起结束。先查 PID 再按 PID 结束，这种走审批。
- 凭据读不到：远程执行的命令环境里凭据助手是清空的，就算写脚本绕道调用也读不到你保存的凭据。
AI 会守你的规矩
本机 Claude Code 每次启动都会读 CLAUDE.md，网页上的 AI 默认看不到。智码会把规矩交给它：
| 规矩来源 | 怎么交给 AI |
|---|---|
项目规范（项目根目录的 CLAUDE.md） | AI 查看项目时，标 🔴 的强制章节连同正文一起给它 |
你的全局规则（用户级 CLAUDE.md） | 同样只给 🔴 章节；各 MCP 自动写入的托管区块会去掉 |
项目技能（.claude/skills） | AI 按任务匹配技能，动手前先读 |
- 两份冲突时以项目为准，与 Claude Code 自己的优先级一致。
- 没读规范就动手：AI 改某个项目时如果近 30 分钟没看过规范，结果里会附一份 🔴 标题清单提醒它；同一项目 30 分钟内只提醒一次。
- 不想发给网页 AI 的段落：用
<!-- remote:skip -->和<!-- /remote:skip -->包起来，这段只留在本机。适合账号对照表这类只对本机有用的内容。 - 本机做法在远程怎么对应：「调用 Skill」「推送只走 sigil」这类写给本机工具的规则，连接时智码会附一张对照表告诉 AI 在远程用什么工具，项目规范不用为网页端专门改写。
转接本机 MCP
你电脑上已配置的本机 MCP（stdio 类），可以开放给网页 AI 调用：
设置 → MCP 接入 → 远程接入（公网）→ 转接本机 MCP，勾选要开放的项，保存即生效，不用重连。
改完了，提交并通过 sigil 推送到 giteeAI 会先在本地提交，再经转接调用 sigil 推送。凭据由 sigil 在你电脑上注入，网页 AI 从头到尾看不到明文。
- 被转接的工具自己有审批的（如 sigil 推送、reeve 危险命令），审批照常在你电脑上弹出，由它们自己负责，不经智码审批。
- 等审批期间，AI 会告诉你「正在等你在电脑上处理弹窗」，不会重复发起。
- HTTP 类 MCP 本身就是公网服务，不需要转接，在 AI 客户端里直接添加即可。
常见问题
| 现象 | 原因 | 处理 |
|---|---|---|
| 状态显示「网关未启动」 | 远程访问网关没在运行 | 设置 → 远程访问，点「启动」 |
| AI 说路径不在信任目录 | 这个项目没勾选 | 在信任目录里勾选，保存即生效，不用重连 |
| AI 让你「在桌面端打开项目」 | 它理解错了，不需要打开项目 | 让它先列出信任目录；不在列表里就去设置勾选 |
| 推送被拒 | 联网 git 不允许直接执行 | 让 AI 经 sigil 推送；还没开转接就先勾选 sigil |
| 命令一直显示「还在跑」 | 没跑完，或在等交互输入 | AI 会接着等；在等输入的话让它改成非交互写法（如加 -y） |
| 改了设置，AI 还按旧说明行事 | 连接说明只在建立连接时下发一次 | 在客户端里断开重连连接器，或新开一个对话 |
| 连不上 | 智码没运行 / 电脑休眠 / 穿透断开 / 开关没开 | 逐项检查；智码重启期间会短暂断开，之后自动恢复 |
安全说明
- 独立密钥：远程接入用单独的密钥，与本机 MCP token、手机配对 token 分开。
- 信任目录：只能操作勾选过的项目，
.git、.env、私钥文件默认拦截。 - 全程审计：每次调用都记入本地审计日志，事后可查 AI 做了什么。
- 一键止损：「紧急断开」立即关闭远程接入并作废当前密钥，已连上的 AI 下一次调用就会失败。
远程密钥约等于这台电脑的 shell 权限
能执行命令，就意味着拿到密钥的人能在你电脑上做任何事：信任目录只约束工作目录，命令本身能碰任何地方；危险命令审批防的是误操作，不是安全边界。密钥只放在你自己的账号里，怀疑泄露立刻点「紧急断开」。
另外几点：电脑要开着、智码要在运行；建议只勾选需要的目录；让 AI 动手前先把手头改动提交，有 git 兜底，改坏了随时能退回。
相关章节
- 让外部 AI 接入 AICoder — 本机 AI 客户端经 127.0.0.1 接入智码
- 安装与网络方案 — 远程网关与公网地址的配置方法
- 浏览器自动化 — 内置浏览器的完整能力
- MCP Server 管理 — 在智码里配置本机 MCP（转接的来源）