Skip to content
huanfengPublic

About

Claude Code 的远程访问工具

Topics

Resources

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

CC Remote

CC Remote

在一个 Web 页面中,管理多台服务器上的 Claude Code 会话。

远程处理会话,保留历史切换供应商,集中管理官方 OAuth Token 与订阅用量。

CI 最新正式版 MIT License

简体中文 · English
快速开始 · 首次使用指南 · 项目主页 · 打开网页客户端 · 下载

桌面端界面示例:会话、工具结果与待回答问题   手机端界面示例:查看任务并继续对话

界面示例;实际样式以当前版本为准。

主要功能

1. 用 Web 管理多台服务器的会话

把家里的电脑、工作站或远程服务器添加到同一个网页,在服务器之间切换、按项目浏览会话。可以新建 Claude Code 会话、继续已有对话、查看流式回复和工具过程,并处理审批与提问;手机浏览器也能使用。

每台服务器分别运行 CC Remote 后台,会话在对应服务器上执行,关闭网页不会停止后台任务。远程访问前,需要先配置好可达的网络地址、HTTPS 和访问令牌;使用独立网页连接多台服务器时,还需要允许该网页的来源。

连接方式见首次使用指南,多服务器与 HTTPS 配置见独立网页前端。

2. 保留会话,切换供应商

直接读取服务器上的 CC-Switch 配置,在新建会话时选择供应商,也可以为已有 Claude Code 会话更换供应商。切换时保留原会话 ID 和历史,停止旧进程;继续发送消息时自动按新供应商配置恢复会话,无需重新创建对话。

每个会话可以使用自己的供应商,也可以设置新会话的默认供应商。正在执行任务时,切换前会要求确认中断;切换后不会自动重发上一条请求。

配置与使用方式见供应商选择与切换。

3. 管理 Claude Code 官方 OAuth Token 与用量

集中添加、重命名、更换或删除多个官方账号的 OAuth Token,并像选择供应商一样为会话选择账号。Token 可通过 claude setup-token 获取,保存在对应服务器上;会话继续使用服务器原有的模型、插件、Hooks、MCP 和权限配置。

查看各账号的 5 小时 / 每周订阅额度、重置时间与用量历史,了解哪些账号还有可用额度。后台定期采集,关闭网页或客户端后仍会继续;Windows 托盘也能直接查看账号额度。

添加方法见OAuth 令牌配置,额度与历史说明见订阅用量监控。

其它使用方式

  • 终端与网页接力:在项目里运行 ccr 开始 Claude Code 会话,按 Ctrl+] 断开后任务继续运行;在网页处理任务,回来再用 ccr 接入。
  • Windows 桌面客户端:通过独立标签页同时连接多台服务器,提供前进、后退、刷新和应用内更新;内置托盘可悬停查看用量。
  • 手机与 PWA:从手机查看进度、回复消息和处理审批,也可将网页安装为 PWA。
  • Codex 会话:支持新建托管会话、读取本机历史并导入继续,具体范围见下方对照表。

CC Remote 是自托管工具。会话使用服务器上的 CLI 与配置运行,模型请求发往你选择的提供方。

先选适合你的入口

你想做什么 使用方式
Windows 客户端和用量托盘 下方 Windows 完整安装,支持 x64
Linux / macOS 或 Windows ARM64 宿主 安装后台,使用它自带的网页
在手机上接着处理任务 先安装宿主,再按手机连接指南配置网络
用同一个网页连接多台宿主 打开公共网页客户端,先阅读连接要求

网页客户端需要连接你自己的、正在运行的宿主;公共页面不提供云端计算或预置账号。默认监听地址只允许本机访问。

快速开始

1. 准备本机 CLI

在运行宿主的同一个系统账户下,按需安装并登录 Claude Code 或 Codex CLI。只使用其中一个时,安装对应 CLI 即可。

claude auth login  # 使用 Claude Code
codex login        # 使用 Codex

2. 安装 CC Remote

Windows x64:后台 + 桌面客户端 + 内置托盘(PowerShell 5.1 / 7):

irm https://github.com/huanfeng/cc-remote/releases/latest/download/install-desktop.ps1 | iex

Linux / macOS:后台 + 网页界面:

curl -fsSL https://github.com/huanfeng/cc-remote/releases/latest/download/install.sh | sh
Windows 仅安装后台(x64 / ARM64)
irm https://github.com/huanfeng/cc-remote/releases/latest/download/install.ps1 | iex

安装脚本下载最新正式版、校验 SHA256、注册并启动当前用户的后台服务,同时创建 ccr 命令。安装后找不到 ccr 时,新开一个终端即可。

3. 开始第一个任务

Windows 客户端:点击托盘图标或从开始菜单打开 CC Remote,在「本机服务」中连接。

浏览器:打开 http://127.0.0.1:8787,按首次使用指南读取本机访问令牌并连接。然后点「新建」,选择 Claude Code 或 Codex,以及宿主上已有的项目目录。

Claude Code 终端接力:在项目目录运行:

cd your-project
ccr
# Ctrl+] 断开,任务继续运行;再次运行 ccr 接回。

本机跑通后,再连接手机:局域网访问、远程访问与连接排查。

支持范围

能力 Claude Code Codex
网页 / 桌面客户端新建托管会话 支持 支持
流式回复、工具过程、审批与提问 支持 支持
读取本机历史并导入继续 支持 支持
ccr 终端与网页接力、网页终端视图 支持 暂不支持
官方订阅额度 支持的官方登录 / OAuth 账号 本机官方登录账号

后台支持 Windows、Linux、macOS;原生客户端发布包和图形化悬停托盘目前提供 Windows x64。订阅额度由提供方实际返回,API Key / 第三方配置不保证有订阅读数。更多边界见 Codex、订阅监控和已知限制。

日常只需几个命令

ccr 和 cc-remote 是同一个入口,以下用短名称:

ccr                    # 选择当前项目会话,没有则新建
ccr ls                 # 浏览并接入最近的终端会话
ccr --resume <会话ID>  # 恢复 Claude Code 会话
ccr -c                 # 继续当前目录最近的 Claude Code 会话
ccr status             # 查看后台状态
ccr logs -f            # 查看后台日志
ccr update             # 仅更新命令行与后台

列表支持上下键、编号加回车、/ 筛选、r 刷新和 q / Esc 退出。完整用法见使用说明。

更新客户端和托盘:签名正式版会自动检查更新,可从「… → 关于与更新」、设置或托盘中下载安装。也可以重新执行 Windows 完整安装命令;配置、账号与历史会保留。ccr update 单独更新命令行与后台。详见桌面应用。

按你的下一步找文档

我想…… 阅读
从安装到完成第一个任务 首次使用指南
用手机连接、找到令牌、排查连不上 连接与排查
学会会话、审批、附件与文件查看 使用说明
使用 Codex 或继续原生历史 Codex 指南
保留会话切换供应商、配置官方 OAuth Token 供应商配置
查看多账号额度和历史 订阅监控
使用桌面客户端、托盘与本机路径菜单 桌面应用
配置代理、模型、服务环境或监听地址 配置说明
部署独立网页、配置 HTTPS 或反向代理 独立网页 · 安全说明
手动下载、更新或卸载 发布与安装
从源码构建、开发或贡献 开发指南 · 架构

常见问题

手机能直接打开本机的 127.0.0.1:8787 吗? 不能,手机上的 127.0.0.1 指向手机自己。请使用宿主电脑的局域网地址或配置好的远程地址,见连接指南。

关掉浏览器或断开终端,任务还在吗? 只要宿主及其会话进程仍在运行,任务就会继续。Ctrl+] 是断开终端;停止任务请在会话中使用停止操作。

终端能用,服务里却报错? 后台服务不加载 shell 配置,CLI 路径、账号与代理环境可能不同。按连接与环境排查检查。

访问令牌拥有在宿主上执行代码的权限。默认仅监听本机;局域网 HTTP 是明文连接,远程访问请配置可信网络或 HTTPS,并妥善保管令牌。见安全说明。

参与项目

使用中遇到问题,请在 Issues 提供版本、系统、复现步骤和去除敏感信息的日志;功能建议和改进也欢迎提交。开发前请阅读开发指南。

如果 CC Remote 帮你把任务从工位带到了手机上,欢迎分享项目地址,或点一个 Star,让更多使用 Claude Code / Codex 的人找到它。

MIT License

About

Claude Code 的远程访问工具

Topics

Resources

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages