cc-remote

桌面应用 · 终端 · Zed · AionUi

Claude 留在安全的远端，
工具留在你自己的电脑。

只在你掌控的服务器上登录一次 Claude Code。cc-remote 通过 SSH 让编辑器使用它，所有文件、命令和 MCP 工具都在本地执行，并由你确认。

开始使用为什么更安全
  • 凭据不离开服务器
  • 本地工具，本地确认
  • 绝不悄悄重放
cc-remote 桌面应用概览：用量统计、每日图表、近期项目与会话

让 Claude 更安全、更稳定、始终可控

把同一个 Claude 登录分散到多台电脑、多个网络和多个工具里，会让账号更难保持安全和可预期。cc-remote 反其道而行：一个登录只在一个地方，项目所需的一切都留在本地。

安全的远端

  • Claude 登录与凭据
  • Claude Code 与模型会话
  • 固定、稳定的运行环境

你的电脑

  • 项目文件与修改
  • 终端命令
  • MCP 工具与 Skills

  • 一个登录，一个地方

    只需在服务器上登录一次 Claude。凭据不会被复制到笔记本、台式机或其他工具，cc-remote 也不会读取或保存它们。

  • 稳定一致的使用环境

    所有请求都来自同一台服务器、同一个网络和同一份 Claude Code，而不是不断变化的设备、Wi-Fi 和 VPN 出口。

  • 由官方 Claude Code 工作

    认证、模型调用和 agent loop 都在 Claude Code 内完成。cc-remote 不引入本地 harness，也不代理、合并或转售访问权限。

  • 触碰本机的操作由你确认

    文件、终端和 MCP 操作经权限确认后在本地执行。Skill 自带的 allowed-tools 不会被当作执行许可。

  • 不会悄悄重放

    每次 prompt 只发送新输入。SSH 断开时结果显示为未知，由你决定下一步，绝不在背后重新执行。

  • 查额度不调用模型

    通过 SSH 查看 5 小时与每周额度，无需发送任何 prompt。本地只缓存百分比、重置时间和单向的账号标识。

cc-remote 能降低账号风险暴露，但无法承诺 Anthropic 如何对待任何账号。请在 Anthropic 使用政策范围内使用 Claude。

聊天之外的一切，交给桌面应用

在一个紧凑的窗口里配置主机、查看用量、同步 Skills。支持 macOS、Windows 和 Linux；无论是否打开桌面应用，编辑器都能正常使用。

用量一目了然

查看今天、近 7 天或近 30 天的会话、对话轮次、Tokens 和估算费用，配合每日图表，以及最近的项目与会话（标注客户端和主机）。

cc-remote 桌面应用概览：用量统计、每日图表、近期项目与会话

  • 原生轻量

    基于 Tauri 2 和系统 WebView，不内置浏览器。

  • 托盘与开机启动

    支持开机启动、关闭窗口后驻留托盘、隐藏启动。

  • 默认私密

    统计数据只留在本机，可设置保留天数或随时清除。

截图为应用界面，数据为示例。

一条 SSH 连接，两种清晰分工。

服务器负责模型会话，本机负责开发环境，cc-remote 是两者之间的桥。

你的机器

编辑器 · 文件 · 终端 · MCP 工具

cc-remote

本地 ACP 网关

远端服务器

Claude Code · 登录 · 模型

  1. 01

    只在远端登录一次

    Claude 登录、模型调用和 agent loop 都留在安装了 Claude Code 的服务器上。

  2. 02

    在本地执行

    读写文件、终端命令和 MCP 工具都作用于本地项目，权限请求由你确认。

  3. 03

    绝不悄悄重放

    每次 prompt 只发送新输入。断线后由你重连并恢复会话，不会在背后重新执行任何操作。

为长时间运行的远端 Agent 而做

  • 标准 ACP

    通过 stdio 使用 Agent Client Protocol，任何 ACP 客户端都能启动它；扩展均为可选元数据。

  • 本地工具执行

    文件、终端和 MCP 工具在你的工作区内运行，复用现有的权限处理。

  • Skills 同步

    本地 Skills、旧版命令、自定义 Agent 和插件 Skills 自动镜像到服务器并重新加载。

  • 稳健的 SSH

    指数退避加抖动重试；认证和主机密钥错误会立即返回。

  • 真实状态

    连接、工具和权限状态来自 ACP。断线表示结果未知，不会伪造成功。

  • 账号额度

    通过 SSH 查看每个远端账号的 5 小时与每周额度，无需发送模型请求。

  • 浏览器对话

    在浏览器中打开同一套聊天界面。默认只监听本机，局域网访问需显式开启。

  • 终端对话

    基于 Ink 的 TUI，支持斜杠命令菜单、会话恢复、粘贴图片，以及中日韩输入法光标定位。

用你习惯的客户端

Zed 和 AionUi 把 cc-remote 作为自定义 ACP Agent 启动。偏爱终端？TUI 就在同一个可执行文件里。

在本地项目目录中运行，/resume 可选择历史会话。

sh
cc-relay --host devbox tui

四步开始第一个会话

把 devbox 替换为主机名、user@host，或 SSH 配置中的别名。

  1. 01

    构建并安装

    本机需要 Bun 和 SSH 客户端。

    sh
    bun install && bun install --cwd app
bun run compile
bun link
  2. 02

    选择主机并检查

    先用普通 ssh 接受主机密钥并配置密钥认证。

    sh
    ssh devbox claude --version
mkdir -p ~/.config/cc-relay
echo devbox > ~/.config/cc-relay/host
cc-relay doctor
  3. 03

    在服务器上登录 Claude

    凭据只保存在服务器上。

    sh
    cc-relay --cli auth login
  4. 04

    开始对话

    从终端连接，或让 Zed、AionUi 使用同一命令。

    sh
    cc-relay --host devbox tui

服务器需要 Claude Code 2.1.248 或更高版本、POSIX 登录 shell 和已认证的 Claude。自动同步 Skills 还需要服务器安装 Python 3。

常见问题