LcodeCoder/CG-Claude

选用指南

AI 根据 README 整理 · 2026/10/18 19:11:18

适用场景

适用于需要检测和配置本地 Claude Code 环境、系统时区、终端和浏览器设置的场景，支持项目扫描和配置备份恢复。

查看 README 依据

<p align="center"> <img src="public/logo.svg" width="80" height="80" alt="CG Claude 标志" /> </p> <h1 align="center">CG Claude</h1> <p align="center">本地 Claude 环境检测与配置工具</p> <p align="center">v1.2.7 · Electron 桌面应用 · macOS / Windows / Linux</p> <p align="center"> <a href="#安装">安装</a> · <a href="#第一次使用">开始使用</a> · <a href="#应用截图">应用截图</a> · <a href="docs/architecture.md">开发文档</a> · <a href="https://github.com/LcodeCoder/CG-Claude/issues">问题反馈</a> </p> CG Claude 把系统时区、终端环境、浏览器设置和 Claude Code 配置集中到一个桌面工作台。先检测问题、查看修改预览，再保存配置；需要回退时，可以恢复修改前的快照。

 _实际应用界面，使用独立演示目录。截图中的配置与检测结果仅作示例。_ ## 可以做什么 | 功能 | 使用方式 | | ---------- | ------------------------------------------------------------------------------------------------------------------- | | 环境检测 | 31 项检查，默认连续检测 3 遍。点击「需要关注」直接定位问题，展开查看证据、处理方法和来源。 | | 一键配置 | 5 步向导先确认目标和修改范围，再预览执行。13 个节点依次处理，每个节点首次失败后最多重试 3 次；仍失败则继续下一项。 |

| 备份恢复 | 写入前自动备份并保存完整配置快照。可恢复单次修改，或预览后还原整份配置快照。 | | 本机配置 | 编辑 Claude Code 的代理、API 地址、NO_PROXY 和额外 CA 路径；外部浏览器语言配置提供独立预览、保存与还原。 | | 项目扫描 | 选择本地项目，核对 Claude 配置、权限、Hooks、MCP、TLS、凭据声明与锁文件。只读扫描，不执行项目脚本。 | | 记录与依据 | 保留检测历史、导出报告、记录人工复核。内置原文对照与参考文献，可从检测项跳到对应来源。 | | 翻译模型 | 配置 OpenAI 兼容或 Anthropic 接口，测试中译英、英译中。**当前尚未接入 Claude Code 原生会话。** | | 应用设置 | 中英文界面、浅色／护眼／深色配色、减少动画、版本检查，以及菜单栏／系统托盘。打包的 macOS / Windows 版支持开机自启。 |

使用方式

作为 Electron 桌面应用使用，支持 macOS、Windows 和 Linux，也可通过源码启动或使用只读 CLI 检测。

查看 README 依据

<p align="center"> <img src="public/logo.svg" width="80" height="80" alt="CG Claude 标志" /> </p> <h1 align="center">CG Claude</h1> <p align="center">本地 Claude 环境检测与配置工具</p> <p align="center">v1.2.7 · Electron 桌面应用 · macOS / Windows / Linux</p> <p align="center"> <a href="#安装">安装</a> · <a href="#第一次使用">开始使用</a> · <a href="#应用截图">应用截图</a> · <a href="docs/architecture.md">开发文档</a> · <a href="https://github.com/LcodeCoder/CG-Claude/issues">问题反馈</a> </p> CG Claude 把系统时区、终端环境、浏览器设置和 Claude Code 配置集中到一个桌面工作台。先检测问题、查看修改预览，再保存配置；需要回退时，可以恢复修改前的快照。

首页还提供 [LC-time 浏览器环境配置插件](https://github.com/LcodeCoder/LC-time) 入口，方便单独查看浏览器插件及安装说明。 ## 安装 前往 [GitHub Releases](https://github.com/LcodeCoder/CG-Claude/releases) 选择已发布版本，下载与你的系统和 CPU 架构对应的附件。安装桌面版后，无需另外安装 Node.js。若发布页暂未提供安装包，可以先按下方「源码启动」运行。 当前版本为 **1.2.7**，安装包命名如下： | 系统 | 安装包 | 安装方式 | | --------------------- | --------------------------------------- | --------------------------------------- | | macOS · Apple Silicon | `CG-Claude-1.2.7-macos-arm64.dmg` | 打开 DMG，将应用拖入「应用程序」。 |

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`。 |

部署要求

安装桌面版无需额外安装 Node.js；源码启动需要 Node.js 22.12 或更新版本。

查看 README 依据

首页还提供 [LC-time 浏览器环境配置插件](https://github.com/LcodeCoder/LC-time) 入口，方便单独查看浏览器插件及安装说明。 ## 安装 前往 [GitHub Releases](https://github.com/LcodeCoder/CG-Claude/releases) 选择已发布版本，下载与你的系统和 CPU 架构对应的附件。安装桌面版后，无需另外安装 Node.js。若发布页暂未提供安装包，可以先按下方「源码启动」运行。 当前版本为 **1.2.7**，安装包命名如下： | 系统 | 安装包 | 安装方式 | | --------------------- | --------------------------------------- | --------------------------------------- | | macOS · Apple Silicon | `CG-Claude-1.2.7-macos-arm64.dmg` | 打开 DMG，将应用拖入「应用程序」。 |

sudo apt install ./CG-Claude-1.2.7-linux-amd64.deb ``` 下载同一版本的 `SHA256SUMS.txt`，在安装包所在目录核对文件完整性： ```sh shasum -a 256 -c SHA256SUMS.txt ``` Windows PowerShell 可计算单个文件的校验值，与清单对照： ```powershell Get-FileHash .\CG-Claude-1.2.7-windows-x64-setup.exe -Algorithm SHA256 ``` </details> macOS 安装包尚未签名、公证，Windows 安装包尚未进行发布者签名。Windows / Linux 的桌面交互尚未实机验证，已验证范围见 [交付记录](docs/release-1.2.7.md)。 ### 源码启动 需要 **Node.js 22.12 或更新版本**： ```sh git clone https://github.com/LcodeCoder/CG-Claude.git cd CG-Claude npm ci npm run desktop ``` macOS 也可双击 `启动工具.command`，Windows 可双击 `启动工具.cmd`；首次运行需要安装依赖并构建应用。

已知限制

macOS 安装包尚未签名、公证，Windows 安装包尚未进行发布者签名；Windows/Linux 桌面交互尚未实机验证。翻译模型当前尚未接入 Claude Code 原生会话。

查看 README 依据

sudo apt install ./CG-Claude-1.2.7-linux-amd64.deb ``` 下载同一版本的 `SHA256SUMS.txt`，在安装包所在目录核对文件完整性： ```sh shasum -a 256 -c SHA256SUMS.txt ``` Windows PowerShell 可计算单个文件的校验值，与清单对照： ```powershell Get-FileHash .\CG-Claude-1.2.7-windows-x64-setup.exe -Algorithm SHA256 ``` </details> macOS 安装包尚未签名、公证，Windows 安装包尚未进行发布者签名。Windows / Linux 的桌面交互尚未实机验证，已验证范围见 [交付记录](docs/release-1.2.7.md)。 ### 源码启动 需要 **Node.js 22.12 或更新版本**： ```sh git clone https://github.com/LcodeCoder/CG-Claude.git cd CG-Claude npm ci npm run desktop ``` macOS 也可双击 `启动工具.command`，Windows 可双击 `启动工具.cmd`；首次运行需要安装依赖并构建应用。

| 备份恢复 | 写入前自动备份并保存完整配置快照。可恢复单次修改，或预览后还原整份配置快照。 | | 本机配置 | 编辑 Claude Code 的代理、API 地址、NO_PROXY 和额外 CA 路径；外部浏览器语言配置提供独立预览、保存与还原。 | | 项目扫描 | 选择本地项目，核对 Claude 配置、权限、Hooks、MCP、TLS、凭据声明与锁文件。只读扫描，不执行项目脚本。 | | 记录与依据 | 保留检测历史、导出报告、记录人工复核。内置原文对照与参考文献，可从检测项跳到对应来源。 | | 翻译模型 | 配置 OpenAI 兼容或 Anthropic 接口，测试中译英、英译中。**当前尚未接入 Claude Code 原生会话。** | | 应用设置 | 中英文界面、浅色／护眼／深色配色、减少动画、版本检查，以及菜单栏／系统托盘。打包的 macOS / Windows 版支持开机自启。 |