跳到正文
智码 AICoder
Esc
本栏目菜单

远程接入(公网 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 接入 → 「远程接入(公网)」区块:

  1. 打开开关,状态变成「可连接」
  2. 在信任目录里勾选允许 AI 操作的项目。列表里是你用过的项目目录,可「全选」或「只选有技能的」,没列出来的点「添加目录」
  3. 复制连接器 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 推送到 gitee

AI 会先在本地提交,再经转接调用 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 兜底,改坏了随时能退回。

相关章节