Repository navigation
Releases
Claude Mirror v0.21.4
claude-mirror v0.21.4
- 更换为深灰底、白色斜杠与方块的新图标。
- 同步 macOS 应用图标、Windows 程序与安装程序图标、应用内品牌图及 README 展示图。
- 功能与 v0.21.3 一致，包含远端预览加速、原生 Markdown 渲染、用量与额度保护、上下文缓存设置。
macOS 安装包适用于 Apple Silicon、macOS 14+，仍为 ad-hoc 签名，尚未经过 Apple 公证。Windows 为原生预览版。
Claude Mirror v0.21.3
claude-mirror v0.21.3
本次包含尚未发布的 v0.21.2 更新，以及最新的远端文件预览、Markdown 渲染与缓存设置。
macOS
- 远端文件优先显示缓存，再校验版本；合并重复请求，大图优先缩略图，文本分段加载，减少等待和传输量。
- 使用独立原生 Markdown 渲染，改善列表、表格、代码块、链接与跨段选中复制；代码块收紧留白，悬停显示复制按钮。
- 修复底部输入框遮挡消息、内容穿透与聊天区域裁剪问题。
- 对话选项新增上下文缓存时长：远端默认、5 分钟、1 小时。需要远端 Claude Code 2.1.242 或更新版本；不会自动发送保活请求，一小时缓存写入成本更高。
- 账号菜单显示五小时、本周用量、重置倒计时与本地重置时间；不必进入某个会话查询。
- 改善侧栏宽度记忆、搜索、弹窗与异步状态，修复旧缓存回显及部分布局崩溃。
远端运行环境
- 同一远端登录下，订阅周期用量达到 90% 后限制并行；任一周期达到 95% 后拒绝新请求并停止正在运行的 worker。
- 用量统计有延迟，不能保证精确保留 5%，也无法限制其他主机或客户端。API Key 等缺少完整订阅用量数据的账号会被保护逻辑暂停。
- 保留空闲 worker 休眠及会话恢复机制；新逻辑随新启动的 worker 生效。
Windows
提供同版本原生预览版安装程序及便携包，共享远端逻辑更新。上述原生 Markdown 与界面调整属于 macOS，Windows 暂未完全对齐。
安装
macOS：Apple Silicon，macOS 14+。安装包仍为 ad-hoc 签名，尚未经过 Apple 公证。已经支持应用内更新的版本可检查更新。
安装包附 SHA-256 校验文件；应用内更新使用签名校验。
Claude Mirror for Windows v0.21.1 · 安装程序与工作台
Windows 10 1809+ / Windows 11 x64 用户请下载 Claude-Mirror-Setup-x64.exe，双击安装，然后在开始菜单打开 Claude Mirror。安装包内含运行时，当前未签名。ZIP 供需要便携版的用户使用。
- 修复点击“添加主机”或“连接”时因发布包缺少 WinUI 资源而崩溃的问题。
- 对齐 macOS 新对话页的布局、项目侧栏、输入框焦点和模型菜单。
- 聊天支持 Markdown、代码高亮、表格、任务框和复制代码。
- 聊天旁可打开多个远端文本文件，编辑并用 Ctrl+S 保存。检测到远端冲突时保留本地草稿。
- 已在 Windows 上验证安装、覆盖升级、启动与卸载。已通过回环 SSH 实测文件保存和冲突保护；本轮没有验证远端在线 Claude 的新回复。
claude-mirror v0.21.1
claude-mirror v0.21.1
修复 macOS 聊天区域反复白屏、滚动卡顿的问题。
- 调整长会话布局，避免动态消息高度导致正文区域突然变空。
- 移除滚动位置变化反复触发自动滚动的反馈循环。
- 缓存文本高度，减少重复排版；历史消息分批显示。
- 保留跨段落复制、文件链接和表格显示。
已在此前出现白屏的会话中验证滚动、调整聊天区宽度和返回最新消息。Swift 测试通过，8 项依赖特定环境的测试跳过。
macOS 14+，Apple Silicon。v0.21.0 用户可通过右上角“检查更新”直接安装；更早版本请下载 DMG 安装。
claude-mirror v0.21.0
claude-mirror v0.21.0
macOS 现在支持应用内更新。
- 每次启动自动检查新版，右上角也可以随时检查。
- 在更新窗口中下载、安装并重新启动，不用再手动打开 DMG、拖动替换应用。
- 更新包和更新源使用 Ed25519 签名，安装前验证。
- 退出前保存输入框草稿和已上传附件；未保存的文件编辑会提示确认。远端正在执行的任务保持运行。
首次升级：v0.20.0 及更早版本仍需手动安装一次本版 DMG；从 v0.21.0 起，后续版本可在应用内更新。
此版本提供 macOS 14+、Apple Silicon 安装包。Windows 原生预览版仍在独立 Release 中，本次没有加入 Windows 自动更新。
claude-mirror v0.20.0
claude-mirror v0.20.0
本次发布 macOS Apple Silicon（arm64）版本，要求 macOS 14 或更新版本。
修复内容
- 连续选中复制：支持跨段落、列表、代码及消息拖选复制，保留 Markdown 标题、表格分列与文件链接。
- 会话打开位置：进入会话定位到最新消息，修复排版后位置偏移；加载更早记录时保持阅读位置。
- 远端内存占用：新 Worker 连续空闲 15 分钟后释放 Claude 和 Worker 进程，保留历史和会话 ID，下次发送恢复。正在回复、等待授权或有后台任务时不会回收。
旧版本已经启动的远端 Worker 不会自动更新，需要正常关闭并重新建立后才能使用新的回收机制。本次没有强制清理旧进程。
安装
下载 claude-mirror-0.20.0-macOS-arm64.dmg，打开后将 claude-mirror.app 拖入 Applications 替换旧版。保留原有配置和会话数据。
本版本为 ad-hoc 签名，尚未经过 Apple 公证。核对来源后，可在系统设置的“隐私与安全性”中允许打开。
附带 SHA-256 校验文件与远端准备脚本。Windows 原生版仍是独立预览版，请使用对应的 Windows Preview Release。
claude-mirror Windows 原生预览版 1
Windows 原生客户端首个预览版，使用 C# / WinUI 3，复用现有 SSH 远端代理与 Claude 会话协议。
下载与使用
适用于 Windows 10 1809+ / Windows 11，x64 架构。
- 下载
claude-mirror-windows-x64.zip，完整解压。 - 运行目录中的
claude-mirror.exe，不要单独移动 EXE。 - 添加 SSH 主机，选择密码或私钥连接，确认服务器指纹。
本机无需安装 .NET、Node.js 或 Claude。远端需有 SSH、Node.js 18.14+ 和已认证的 Claude Code。当前为未签名便携版。
已接入
- 主机命名、密码/私钥认证、主机指纹校验和 SSH keepalive。
- 按项目读取历史会话、新建及继续对话、远端持久任务和停止回复。
- 远端模型与命令列表、工具授权及 AskUserQuestion 回答。
- 远端目录浏览、文本/图片预览、下载与拖拽上传；附件按内容哈希缓存。
验证与限制
Windows CI 已通过编译、核心单元测试和原生窗口启动检查；C# 核心已通过真实服务器的 SSH、历史读取、目录浏览、Claude 回复与会话能力读取测试。尚未完成 Windows 实机完整交互与视觉验收。
这是基础预览版，不代表 macOS 功能已全部移植。Markdown 富文本、复杂斜杠命令交互卡片、文件编辑/删除、自动重连、SSH config/ProxyJump/agent、反向访问、可视化 usage 与自动更新检查尚未完成。
附带 SHA-256 校验文件。本预览版不替代 macOS v0.19.0 正式版。
claude-mirror v0.19.0
claude-mirror v0.19.0
本次更新统一应用名称与图标，并改进聊天、文件和 SSH 连接体验。
- 新图标：珊瑚色小怪兽，加入卷角与 ω 表情；应用名称统一为
claude-mirror.app。 - 统一暖色主题，调整侧栏、设置与会话选项；同步按钮放到新建对话右侧，搜索默认收起。
- 修复密码认证选项缺少输入框的问题，输入的密码接入本次 SSH 认证。
- 回答中的行内文件路径支持点击打开远端预览，修复
file://路径处理。 /usage结果以用量卡片显示，改进命令搜索与历史命令输出。- 改进回到底部按钮、回复失败提示与思考状态展示。
- 支持将指定项目的远端聊天记录移入可恢复备份目录，不删除项目文件。
- 右上角提供更新入口，每次启动自动检查新版本。
下载与安装
下载 claude-mirror-0.19.0-macOS-arm64.dmg，将 claude-mirror.app 拖入 Applications。
当前安装包适用于 Apple Silicon，要求 macOS 14 或更新版本。包内仍使用原应用标识，已有主机和会话数据沿用。旧版本名称为 Claude Mirror.app 或 RemoteCC.app，请退出旧版后安装新版，避免重复启动。
此版本为 ad-hoc 签名，尚未经过 Apple 公证。首次打开若被系统阻止，请核对下载来源后按 macOS 的“隐私与安全性”提示操作。
镜像 Claude v0.18.0
镜像 Claude v0.18.0
本版重做了 macOS 界面，使它更接近原生应用；同时修复了 macOS 服务器上文件搜索没有结果的问题。
下载与安装
下载 Claude-Mirror-0.18.0-macOS-arm64.dmg，打开后将 Claude Mirror.app 拖入 Applications，替换旧版。聊天记录和机器配置会保留。已安装 0.17.0 的用户启动应用后会收到更新提示。
- 安装包：Apple Silicon（M1 及后续系列），macOS 14 或更新。
- 构建为 ad-hoc 签名，未经 Apple 公证；首次打开可能需要在“系统设置 → 隐私与安全性”中允许。
界面
- 侧边栏改用 macOS 原生的玻璃材质，不再覆盖一层不透明的灰色背景。顶部显示当前机器及其连接状态，不再重复显示应用名称；间距按系统规范收紧，行高跟随“侧边栏图标大小”设置。
- 字号统一为系统文字样式，圆角统一为固定的几档。
- 发送按钮、主要按钮和未读标记跟随系统强调色。
- 聊天正文和输入框收窄到便于阅读的宽度；工具调用记录和用户消息气泡更紧凑；输入框默认两行高，文件传输状态只在有内容时显示。
修复
- macOS 服务器没有安装 ripgrep 时，文件内容搜索总是返回空结果。原因是 BSD grep 把
-Z解释为解压缩，而不是以 NUL 分隔文件名；现在改用 GNU 和 BSD grep 都支持的--null。
开发
- 新增 GitHub Actions：CI 运行 Node 和 Swift 测试并打包 DMG；推送
v*标签时自动构建 DMG 并发布到 Release。 - 演示版可以通过 SSH 渲染自己的窗口截图，不需要“屏幕录制”权限（
macos/scripts/build-demo.sh、snapshot.sh）。
校验
下载同名 .sha256 文件后，在文件所在目录运行：
shasum -a 256 -c Claude-Mirror-0.18.0-macOS-arm64.dmg.sha256镜像 Claude v0.17.0
镜像 Claude v0.17.0
通过 SSH 在本地桌面使用远端 Claude Code。本版新增服务器反向连接本机、自动检查更新，以及跨机器同步记忆和会话。
下载与安装
下载 Claude-Mirror-0.17.0-macOS-arm64.dmg，打开后将 Claude Mirror.app 拖入 Applications，替换旧版即可。聊天记录和机器配置会保留。
- 本次安装包：Apple Silicon（M1 及后续系列），macOS 14 或更新。
- 本机无需 Node.js、Swift 或 Xcode；远端需要 SSH、Node.js ≥18.14、可用的 Claude Code 及认证。
- 构建为 ad-hoc 签名，未经 Apple 公证；首次打开可能需要在“系统设置 → 隐私与安全性”中允许。
本版内容
服务器反向连接本机
在机器菜单中右键服务器，勾选“允许此服务器反向连接本机”。服务器会通过应用已有的 SSH 连接登录这台 Mac，不用另开隧道，也不需要公网 IP 或端口映射。
- 默认关闭，每台服务器单独开启。
- 服务器端只使用一个私有 Unix socket，不监听 TCP 端口；断线重连后自动重新建立。
- 服务器获得一把专用密钥，限定只能经由该通道登录；取消勾选后会立即从
authorized_keys删除，离线时也会删除。 - 自动在服务器上固定本机的主机公钥，并生成支持连接复用的 ssh_config；菜单中可复制连接命令。
- 反向连接建立期间，Mac 不会因闲置自动休眠。
- 需要本机开启“远程登录”，服务器安装
socat。
检查更新
应用启动后会查询 GitHub Releases，之后每天最多查一次；发现新版本时可下载 DMG、查看更新内容或跳过此版本。菜单中新增“检查更新…”。应用不会自动替换自身。
跨机器同步记忆和会话（scripts/agent-sync.cjs）
- 在 VPS 和本地之间双向同步 Claude 的项目记忆，冲突时两个版本都保留。
- Claude Code 与 Codex 的会话生成脱敏交接记录，另一台机器可以读取后接手，也可以下载原始会话后用
resume恢复。 - 由 Claude Code hook、Codex
notify和定时任务触发，只通过 SSH 传输，从不读取凭据。
校验
下载同名 .sha256 文件后，在文件所在目录运行：
shasum -a 256 -c Claude-Mirror-0.17.0-macOS-arm64.dmg.sha256