ClaudeMap

cc-remote

笔记本上不装 Claude Code、不登录也能用:cc-remote 把模型、登录与订阅留在服务器,工具调用跑在你自己的机器上——ssh 之上的真 Claude Code,以 ACP agent 形态接入 acpc、Zed、paseo 等客户端

插件与代理remote developmentacpclaude codesshzed

cc-remote 让你熟悉的编辑器用上「跑在别处的 Claude Code」(撰稿时 367 星,2026-11-11):claude 进程连同你的登录与订阅留在可通过 ssh 访问的服务器上,而 Read、Write、Edit、Bash(Windows 上是 PowerShell)、Glob、Grep 等工具全部在本机执行——编辑的文件、依赖、git 配置与构建工具都是你自己的。它是 Agent Client Protocol(ACP)的 agent:基于 agentclientprotocol 的 Claude Code 适配器 claude-agent-acp 改了一处——启动的 claude 换成 ssh 上的那一份;会话、权限审批、模式、模型、fork 与 diff 的行为与 claude-agent-acp 一致,对编辑器来说「看起来就是 Claude Code」。服务器端零安装:没有 daemon、不开端口,只要 ssh 进去后 claude --version 能跑(Claude Code 2.1.248+ 且已登录)即可。本机 MCP 服务器随行:编辑器传入的与你本地 Claude Code 配置里的(~/.claude.json、已批准的 .mcp.json)都在你的机器上运行,OAuth 登录也一并支持。会话镜像到本机 ~/.claude/projects/,可从客户端列出、重放、加载与 fork。

它做什么

  • 模型在服务器、工具在你机器上:Read / Write / Edit / NotebookEdit / Bash / Glob / Grep 全在本机执行;系统提示词、会话、网页搜索、subagents 与 skills 留在远端
  • 服务器端零安装:没有 daemon、不开端口——能免密 ssh 登录、服务器上的 Claude Code 2.1.248+ 已登录,就是全部前提
  • 经 claude-agent-acp 保留真实 Claude Code 行为:按命令前缀审批;含 ; & |、重定向、$(…)、反引号或换行的命令绝不自动批准
  • 本机 MCP 服务器随行,OAuth 登录也支持;重名时客户端的赢过本地配置的,两者都赢过服务器上的
  • 会话像本地 Claude Code 一样镜像到 ~/.claude/projects/;服务器按本机目录在 ~/.cc-remote/ws/ 下建独立工作目录
  • 一个无依赖二进制,用 Bun 构建,覆盖 macOS、Linux 与 Windows

什么时候用

适合把 Claude 登录与订阅放在一台常驻服务器(开发机、公司服务器、或网络可达 Claude 的机器)而代码在本机的开发者;适合多人共用一台已登录的服务器;也适合不想在本机安装 claude 或留存登录态的笔记本。

如何上手

# 本机需要 Bun 来构建;构建出的二进制无依赖
git clone https://github.com/AkaraChen/cc-remote && cd cc-remote
bun install
bun run compile    # 为本机构建二进制到 dist/cc-remote
bun link           # 把 cc-remote 放上 PATH(~/.bun/bin)

# 前提:ssh 免密登录服务器;服务器上的 claude(2.1.248+)已登录
mkdir -p ~/.config/cc-remote && echo <your-server> > ~/.config/cc-remote/host
cc-remote doctor   # 检查 ssh 与远端 claude 版本

# Zed —— 加入 settings.json:
{
  "agent_servers": {
    "Claude (remote)": { "command": "cc-remote", "args": ["--host", "<your-server>"] }
  }
}

# 终端里的 acpc:
acpc add --slug cc-remote --name "Claude (remote)" cc-remote --host <your-server>
acpc -a cc-remote

注意事项

撰稿时该仓库没有许可文件(GitHub API 报告为无),因此尚未给出任何复用条款。README 列明的已知限制:项目的 .claude/ 目录(commands、skills、agents、settings)不会发到服务器——服务器自己的用户级设置、skills 与 MCP 服务器仍然生效;文件检查点与回滚记录在服务器上,看不到你本机的编辑;桥接的 MCP 服务器只暴露工具,不暴露资源与提示词;LSP、Monitor 与 worktree 工具被关闭。Windows 细节:shell 工具是 PowerShell(PATH 里有 pwsh 7 就用它,否则 Windows PowerShell 5.1),Grep 需要 PATH 里有 ripgrep;Windows 的 OpenSSH 无法共享连接,每个会话各自开一条。默认所有会话共用一条保持 10 分钟的 ssh ControlMaster,断链约一分钟内报错。服务器需要 POSIX 登录 shell。撰稿时 367 星(2026-11-11)。

代码仓库

AkaraChen/cc-remote

收录日期

地图上的相关资源

  • clawd-conduit

    插件 / 代理

    把全部 15 个 Claude Code hook 事件接进 Clawd on Desk 桌面宠物,权限请求变成可等待的桌面卡片。

    • hooks
    • desktop
    • notifications
    • claude-code
  • CometixCode

    插件 / 代理

    非官方的 Claude Code 终端 UI 复刻:用 Rust 按 1:1 逐文件移植到 iocraft 这套 React 风格 TUI 框架上。

    • terminal-ui
    • rust
    • reimplementation
    • unofficial
  • Abide

    插件 / 代理

    把 AGENTS.md、CLAUDE.md 里的自然语言规则变成钩子级强制:每次编辑都被评审,违规当场修复。

    • hooks
    • code-review
    • rules
    • agents-md