CG-Claude README

The project's README from github.com/LcodeCoder/CG-Claude. As one markdown file: README.md.

CG Claude 标志

CG Claude

本地 Claude 环境检测与配置工具

v1.2.7 · Electron 桌面应用 · macOS / Windows / Linux

安装 · 开始使用 · 应用截图 · 开发文档 · 问题反馈

CG Claude 把系统时区、终端环境、浏览器设置和 Claude Code 配置集中到一个桌面工作台。先检测问题、查看修改预览，再保存配置；需要回退时，可以恢复修改前的快照。

CG Claude 环境检测首页：检测统计、结果分类与配置修复入口

实际应用界面，使用独立演示目录。截图中的配置与检测结果仅作示例。

可以做什么

功能 使用方式
环境检测 31 项检查，默认连续检测 3 遍。点击「需要关注」直接定位问题，展开查看证据、处理方法和来源。
一键配置 5 步向导先确认目标和修改范围，再预览执行。13 个节点依次处理，每个节点首次失败后最多重试 3 次；仍失败则继续下一项。
备份恢复 写入前自动备份并保存完整配置快照。可恢复单次修改，或预览后还原整份配置快照。
本机配置 编辑 Claude Code 的代理、API 地址、NO_PROXY 和额外 CA 路径；外部浏览器语言配置提供独立预览、保存与还原。
项目扫描 选择本地项目，核对 Claude 配置、权限、Hooks、MCP、TLS、凭据声明与锁文件。只读扫描，不执行项目脚本。
记录与依据 保留检测历史、导出报告、记录人工复核。内置原文对照与参考文献，可从检测项跳到对应来源。
翻译模型 配置 OpenAI 兼容或 Anthropic 接口，测试中译英、英译中。当前尚未接入 Claude Code 原生会话。
应用设置 中英文界面、浅色／护眼／深色配色、减少动画、版本检查，以及菜单栏／系统托盘。打包的 macOS / Windows 版支持开机自启。

首页还提供 LC-time 浏览器环境配置插件 入口，方便单独查看浏览器插件及安装说明。

安装

前往 GitHub Releases 选择已发布版本，下载与你的系统和 CPU 架构对应的附件。安装桌面版后，无需另外安装 Node.js。若发布页暂未提供安装包，可以先按下方「源码启动」运行。

当前版本为 1.2.7，安装包命名如下：

系统 安装包 安装方式
macOS · Apple Silicon CG-Claude-1.2.7-macos-arm64.dmg 打开 DMG，将应用拖入「应用程序」。
macOS · Intel CG-Claude-1.2.7-macos-x64.dmg 打开 DMG，将应用拖入「应用程序」。
Windows · x64 CG-Claude-1.2.7-windows-x64-setup.exe 运行安装程序，按提示完成安装。
Linux · x64 CG-Claude-1.2.7-linux-x86_64.AppImage 添加执行权限后直接运行。
Debian / Ubuntu · x64 CG-Claude-1.2.7-linux-amd64.deb 使用系统软件安装器，或通过 apt 安装。
Linux 启动命令与安装包校验

AppImage：

chmod +x CG-Claude-1.2.7-linux-x86_64.AppImage
./CG-Claude-1.2.7-linux-x86_64.AppImage

Debian / Ubuntu：

sudo apt install ./CG-Claude-1.2.7-linux-amd64.deb

下载同一版本的 SHA256SUMS.txt，在安装包所在目录核对文件完整性：

shasum -a 256 -c SHA256SUMS.txt

Windows PowerShell 可计算单个文件的校验值，与清单对照：

Get-FileHash .\CG-Claude-1.2.7-windows-x64-setup.exe -Algorithm SHA256

macOS 安装包尚未签名、公证，Windows 安装包尚未进行发布者签名。Windows / Linux 的桌面交互尚未实机验证，已验证范围见 交付记录。

源码启动

需要 Node.js 22.12 或更新版本：

git clone https://github.com/LcodeCoder/CG-Claude.git
cd CG-Claude
npm ci
npm run desktop

macOS 也可双击 启动工具.command，Windows 可双击 启动工具.cmd；首次运行需要安装依赖并构建应用。

第一次使用

  1. 选择检测目标。 在「检测偏好」设置实际使用的网络模式、服务方式与目标时区；也可以在「一键配置」中逐项选择。
  2. 开始检测。 默认连续检查 3 遍，仅读取本机配置。需要比较公网出口或 WebRTC 时，再勾选对应网络检测。
  3. 查看并处理问题。 点击顶部「需要关注」定位详情。自动修改先展示预览，确认后备份并执行。
  4. 完成剩余设置。 配置结束后查看手动清单，按步骤打开系统设置、复制核对命令或打开终端。重新打开终端与 Claude Code 后再次检测。
  5. 需要时恢复。 在「备份恢复」选择修改记录或完整快照，查看还原预览后恢复。

最小化或关闭桌面窗口后，应用留在菜单栏／系统托盘，检测与配置任务继续执行。需要完全退出时，从图标菜单选择「退出 CG Claude」。

应用截图

以下截图来自 1.2.7 macOS 桌面版，使用隔离演示数据；配置写入只作用于临时目录，系统时区使用模拟状态。点击展开查看完整界面。

一键配置：逐项选择，先预览再执行

向导依次确认网络模式、Claude 服务、隐私偏好与修改范围。系统时区可以按文章建议、当前 IP 出口或手动目标核对。

一键配置向导：网络模式、目标时区与浏览器语言选择

执行记录显示每个节点的结果和重试次数。配置完成后，仍需手动处理的事项集中列出，并提供设置入口与操作步骤。

一键配置执行记录：已完成节点、重试次数与原始备份入口

备份恢复：保留修改记录与完整配置快照

可以查看单次修改的备份，或还原一键配置前的完整快照。还原前再次核对当前文件；有后续修改时会阻止覆盖，并在还原前保存当前状态。

备份恢复页面：完整快照、修改记录与一键还原入口

翻译模型：接口、模型、密钥与双向测试

模型配置集中在「双向翻译」导航中。测试只发送两段固定示例，不读取项目或 Claude 会话；页面明确显示原生终端的接入状态。

双向翻译页面：模型配置表单与尚未接入原生终端的状态

应用设置：深色模式与常用偏好

提供中英文界面、浅色／护眼／深色配色、减少动画和版本检查。语言与外观保存在本机，重新打开后仍保留。

应用设置的深色模式：界面语言、配色、动画与启动设置

检测与数据范围

完整的写入规则、快照覆盖范围、网络访问与本机记录说明见 检测与配置说明。

开发与文档

技术栈：Vue 3、TypeScript、Vite、Electron、Node.js 与 Zod。界面、共享类型、本机服务和桌面能力分别位于 src/、shared/、server/、electron/。

npm run check        # 架构边界、类型与测试
npm run format:check # 格式检查
npm run pack         # 生成应用目录
npm run dist         # 生成当前平台安装包
浏览器版、隔离演示与只读 CLI

在已经运行 npm ci 的项目目录中：

npm run build
npm start

浏览器访问 http://127.0.0.1:4318。服务只监听回环地址，使用 Ctrl+C 退出。同一记录目录不能同时运行浏览器服务与桌面版。

npm run demo            # 隔离浏览器演示，默认端口 4319
npm run desktop:demo    # 隔离桌面演示
npm run doctor -- --json # 只读 CLI 检测

demo 在临时目录中创建示例配置，需先完成 npm run build。desktop:demo 自动构建，使用独立桌面资料目录。隔离模式不注册开机自启，系统时区与 TZ 使用模拟状态；平台信息及客户端版本仍按本机读取。CLI 加上 --network 可开启终端公网查询。

运行变量 用途
CG_PORT 浏览器服务端口，默认 4318；桌面版使用随机回环端口。
CG_HOME 配置根目录，默认当前用户主目录；可用于隔离验证。
CG_DATA_DIR 记录目录，默认配置根目录下 .claude-guard。
CG_DEMO=1 标记隔离模式，应同时指定独立配置根目录。
文档 内容
项目架构 分层、代码入口、检查扩展与样式组织。
参与开发 本地验证、提交约定与改动要求。
检测与配置说明 修复流程、配置范围、快照与本机数据。
原文逐项对照 43 项文章要求的检测、修复与人工核对映射。
参考文献审计 69 条来源的采用内容与适用边界。
时区检测说明 系统、进程与浏览器时区的证据来源。
验证记录 各轮验收、实际测试与未覆盖范围。
发布说明 多平台构建、校验值与 GitHub Release 流程。

安装包通过 GitHub Release 附件分发，源码仓库不提交二进制产物。Check 工作流验证三个系统；Build installers 在原生平台构建安装包并上传 Artifacts，正式 Release 由维护者发布。

查看版本 · 报告问题 · 给项目一个 Star

社区与鸣谢

感谢 LINUX DO 提供技术交流与经验分享的平台，也感谢社区里乐于分享的佬友。

欢迎在 LINUX DO 社区 交流 CG Claude 的使用体验。遇到问题或有功能建议，也可以提交到 GitHub Issues。

CG-Claude (LcodeCoder/CG-Claude)

Searching Database…

233 ·GitHub
CG-Claude
Что это?CG Claude — это настольное приложение на Electron, которое обнаруживает и настраивает ваше локальное окружение (часовой пояс системы, терминал, настройки браузера, конфигурацию Claude Code), чтобы Claude Code корректно работал на вашей машине. Оно выполняет 31 проверку, позволяет просматривать исправления до их применения и хранит резервные копии/снимки, чтобы вы могли откатиться.
Это настольное приложение или инструмент командной строки?Это в основном настольное приложение на Electron для macOS, Windows и Linux, но сборка из исходников также даёт демонстрационный режим в браузере и CLI только для чтения.
Нужен ли Node.js для использования?Не для готовых установщиков. Node.js 22.12 или новее требуется, только если вы хотите запускать приложение из исходников вместо упакованного установщика.
Установщики подписаны и полностью проверены на работоспособность?Нет — сборка для macOS не подписана и не нотаризована, сборка для Windows не имеет подписи издателя, а десктопные взаимодействия на Windows/Linux пока не проверены на реальном железе. Целостность скачанного установщика можно проверить по SHA256SUMS.txt.
Что именно покрывает проверка окружения из 31 пункта?Она проверяет такие вещи, как часовой пояс системы, переменные окружения терминала, настройки браузера и proxy/API-конфигурацию Claude Code; по каждому отмеченному пункту можно кликнуть 'Needs attention' и увидеть доказательства, исправление и источник.
Может ли он также проверить конкретную папку проекта?Да — сканирование проекта это проверка только для чтения выбранного локального проекта: конфигурация Claude, разрешения, хуки, MCP, TLS и декларации учётных данных/lockfile-файлы; собственные скрипты проекта он никогда не выполняет.
Что делает функция перевода?Можно подключить OpenAI-совместимый или Anthropic API, чтобы протестировать перевод с китайского на английский на двух фиксированных примерах предложений; она не читает ваши файлы проекта или сессию Claude Code и пока не встроена в нативную сессию Claude Code.
Гарантирует ли проверка окружения безопасность моего аккаунта Claude?Нет — проверки отражают только вашу фактическую локальную конфигурацию и выбранные цели; они не определяют и не гарантируют статус аккаунта, региональный доступ, вход на устройствах или биллинг — это по-прежнему требует ручной проверки.
What are similar projects?open-codesign, downvid, evenfire, headroom, easyread, osw, claudecodeui, get-it
Which topics is it in?zod, vue3, configuration, backup, vite, openai-compatible, electron, anthropic, claude, privacy, claude-code, desktop-app
Creator
LcodeCoder
Size
2.8 MB
Stars
233
Updated
CommitOct 11Release1.2.7Oct 11
Age
7d
Commits · 90 Days