AkaraChen/cc-remote

项目介绍

cc-remote 把 Claude Code 封装成 ACP 代理：模型、系统提示词和会话跑在远程服务器上，而读文件、改文件、搜索和 Shell 命令都在本机执行。它基于 claude-agent-acp 修改，唯一的关键变化是让启动的 claude 进程运行在通过 SSH 连接的服务器上。

这种拆分是刻意的。服务器只负责模型和会话状态，本机负责内置工具（Read、Write、Edit、Bash/PowerShell、Glob、Grep）、CLAUDE.md、git 状态、环境变量，以及本地 Claude Code 配置和 ACP 客户端带来的 MCP 服务器。服务器上只需要装好并登录 claude，本机完全不需要安装。

适合使用 Zed、paseo 等 ACP 客户端、但希望把模型计算放到远程的开发者，或者已经在一台服务器上登录好 Claude Code 的用户。任何支持 ACP 的客户端都能接入。

安装与连接

需要能免密 SSH 登录服务器（用密钥，端口和跳板机写在 ~/.ssh/config），服务器上的 Claude Code 2.1.248 或更高版本已登录，且有 POSIX 登录 Shell。本机需要 Bun 来构建二进制。

git clone https://github.com/AkaraChen/cc-remote && cd cc-remote
bun install
bun run compile    # 为本机构建二进制到 dist/cc-remote
bun link           # 把 cc-remote 放进 ~/.bun/bin

指定主机后检查连接：

mkdir -p ~/.config/cc-remote && echo devbox > ~/.config/cc-remote/host
cc-remote doctor

主机按 --host、$CC_REMOTE_HOST、~/.config/cc-remote/host 的顺序查找，任何 ssh 能接受的主机名都行；需要自定义命令时设置 CC_REMOTE_SSH。服务器还没登录的话，运行 cc-remote --cli auth login。

接入 ACP 客户端

Zed 在 settings.json 中加入：

"agent_servers": {
  "Claude (devbox)": { "command": "cc-remote", "args": ["--host", "devbox"] }
}

paseo 可以在 ~/.paseo/config.json 的 agents.providers 下添加 provider，也可以直接安装仓库自带的 paseo 插件：paseo plugin install github:AkaraChen/cc-remote:paseo-plugin，然后在插件设置界面里配置主机，设置里的「Check」按钮会执行 cc-remote doctor。

运行行为

权限请求交给 ACP 客户端处理。Read、Glob、Grep 不会询问；「Accept edits」只批准会话目录内的 Write、Edit 和 NotebookEdit。Bash 命令按命令前缀授权（例如 npm test:*），而不是整个 Bash；含 ;、&、|、重定向、$(…)、反引号或换行的命令永远不会被自动批准。授权在 cc-remote 退出前一直有效。

会话会镜像到本机的 ~/.claude/projects/，客户端可以列出、回放、加载和 fork。恢复服务器没见过的会话（例如 fork）时，会先把它复制到服务器。服务器上每个本地目录对应 ~/.cc-remote/ws/<主机名>/<本地路径>/ 下的工作目录。SSH 连接默认共享一个 ControlMaster，并设置 keepalive，断线约一分钟内失败；Windows 的 OpenSSH 不能共享连接，因此每个会话单独开一个。

使用约束

• 项目的 .claude/ 目录（命令、技能、代理、设置）不会发送到服务器，但服务器上的用户级设置和技能仍然生效。
• 文件检查点和回退记录在服务器上，看不到本机的修改。
• 桥接的 MCP 服务器只暴露工具，不暴露资源和提示词。
• LSP、Monitor 和 worktree 工具被关闭。
• Windows 上 Shell 工具是 PowerShell（优先 pwsh，否则 Windows PowerShell 5.1），Grep 需要 rg 在 PATH 中。
• 仓库未声明许可证。

HotRepo 点评

cc-remote 在 2026-11-07 进入 HotRepo 新项目榜，在 04:45 至 05:45 UTC 约一小时的观察窗口内新增 22 Star 和 3 Fork，总数达到 137 Star。项目创建于 2026-11-01，几天内就有这个增速，说明早期关注度上升很快，但这只是单次窗口的数据，还谈不上持续采用。GitHub 全语言日榜没有名次记录，也没有 HN 讨论可供参考。从技术设计看，用普通 SSH 流把模型执行和工具执行分开、并借助 SDK 的工具通道替换内置工具，确实解决了远程计算场景下 ACP 用户的实际限制。