Windows 端 Claude Code + desktop-cc-gui 完整配置指南

本文假设你没有**，所有步骤走国内网络可达的镜像源。

你要装什么

三个组件，按顺序来：

flowchart LR Node["① Node.js<br/>（npmmirror 镜像）"] --> Mirror["② 配置 npm 镜像源"] Mirror --> Claude["③ Claude Code<br/>（npm 全局安装）"] Claude --> GUI["④ desktop-cc-gui<br/>（桌面图形界面）"]

第一步：安装 Node.js（nvm-windows）

1. 卸载旧版本

如果电脑上装过 Node.js，先去"控制面板 → 程序和功能"卸载，然后手动删除残留目录：

  • C:\Program Files\nodejs
  • %AppData%\npm
  • %AppData%\npm-cache

2. 下载 nvm-windows

GitHub 可能打不开或下载慢。两种方式：

  • 能打开 GitHub：去 nvm-windows Releases 下载 nvm-setup.exe
  • 打不开 GitHub：让朋友传一份 nvm-setup.exe 给你，或者用手机下载后传电脑

安装路径不要带空格和中文，推荐 D:\Dev\nvm。装完后重启终端。

3. 强制配置国内镜像（关键一步）

打开 nvm 安装目录下的 settings.txt，必须追加这两行，否则 nvm install 会从 Node.js 官网下载，没 VPN 会超时：

node_mirror: https://npmmirror.com/mirrors/node/
npm_mirror: https://npmmirror.com/mirrors/npm/

4. 安装 Node.js

以管理员身份打开 PowerShell：

nvm install lts        # 走 npmmirror 下载，速度正常
nvm use lts            # 切换到 LTS
node -v                # → v24.x.x
npm -v                 # → 10.x.x

第二步：配置 npm 镜像源

Node.js 装好后，npm 默认从 registry.npmjs.org 拉包，没 VPN 巨慢或直接失败。执行下面两条命令，永久走国内镜像：

npm config set registry https://registry.npmmirror.com
npm config set disturl https://npmmirror.com/mirrors/node

验证是否生效：

npm config get registry    # → https://registry.npmmirror.com

以后所有 npm install 都走淘宝镜像，速度正常。如果某天要切回去：npm config delete registry。

第三步：npm 安装 Claude Code

没有 VPN 就别折腾原生安装器（irm https://claude.ai/install.ps1）了，那个脚本要从 claude.ai 拉包，铁定超时。

只走 npm，镜像源已配好，一条命令：

npm install -g @anthropic-ai/claude-code

装完验证：

claude --version

进入工作目录，首次运行会引导登录：

cd D:\workspace
claude

按终端提示在浏览器中完成 Anthropic 账号认证。

需要 Claude Pro/Max 付费账号，免费版不包含 Claude Code。

如果 @anthropic-ai/claude-code 从镜像也拉不下来

极少数情况下 npmmirror 同步延迟，换腾讯云镜像试试：

npm config set registry https://mirrors.cloud.tencent.com/npm/
npm install -g @anthropic-ai/claude-code

装完记得切回 npmmirror（腾讯云有些包不全）：

npm config set registry https://registry.npmmirror.com

第四步：安装 desktop-cc-gui

下载

去 desktop-cc-gui Releases 下载最新版（当前 v0.4.0）的 Windows 安装包：

  • desktop-cc-gui_0.4.0_x64-setup.exe — 安装版（推荐）

GitHub Releases 在国内不挂代理也能访问，只是速度慢。.exe 文件大概 10MB，等一下就好。实在打不开也用传文件的方式解决。

安装

双击 .exe 按向导完成。Tauri 应用，体积小，半分钟装完。

首次启动

flowchart TD A["启动 desktop-cc-gui"] --> B["选择 AI 引擎"] B --> C["Claude Code（默认）"] C --> D{"自动检测到 claude？"} D -->|"是"| E["进入主界面"] D -->|"否"| F["手动指向 npm 全局安装路径"] F --> E

启动后选择 Claude Code 引擎。如果你已按第三步装好，desktop-cc-gui 会自动检测到 claude。

没检测到的话，手动指定路径。npm 全局包的位置可以通过下面命令查到：

npm root -g

在该目录下找 @anthropic-ai/claude-code。

第五步：desktop-cc-gui 功能速览

flowchart TB subgraph GUI["desktop-cc-gui 主界面"] Chat["💬 Chat Canvas<br/>对话画布 · @文件引用 · /命令触发"] Terminal["🖥️ 终端面板<br/>内置 xterm.js"] Git["📦 Git 面板<br/>可视化提交/分支/差异"] Board["📋 看板<br/>任务卡片管理"] Plan["📐 计划面板<br/>计划查看与追踪"] MCP["🔌 MCP 管理<br/>配置 MCP Server"] end
  • Chat Canvas — 核心面板。不用在命令行敲，直接在画布里用 @文件 引用项目文件、/命令 触发快捷操作，结果富文本渲染
  • 终端面板 — Claude Code 的执行过程实时展示，习惯命令行的可以两边切换
  • Git 面板 — 查看改动、提交、推拉代码，不用切 VS Code
  • 看板 + 计划面板 — 配合 Superpowers writing-plans 使用，把 plan 拆成卡片追踪
  • MCP 管理 — 内置 MCP 协议支持，添加 MCP Server 扩展工具能力

第六步：实战——用 GUI 完成一个任务

sequenceDiagram actor You as 🧑 你 participant GUI as desktop-cc-gui participant Claude as Claude Code participant FS as 文件系统 You->>GUI: 打开项目目录 D:\workspace\my-project You->>GUI: Chat Canvas：@README.md 帮我写一份项目说明 GUI->>Claude: 转发指令 + 文件上下文 Claude->>FS: 读取项目文件 Claude->>GUI: 流式返回内容 GUI->>You: Markdown 渲染预览 You->>GUI: 确认保存 GUI->>FS: 写入 README.md

安装流程总览

一图概括整个安装链路：

flowchart TD subgraph Step1["① Node.js 环境"] NVM["下载 nvm-setup.exe"] --> Settings["settings.txt 配置国内镜像"] Settings --> Install["nvm install lts"] end subgraph Step2["② npm 镜像"] Registry["npm config set registry<br/>https://registry.npmmirror.com"] end subgraph Step3["③ Claude Code"] CC["npm install -g @anthropic-ai/claude-code"] end subgraph Step4["④ 桌面 GUI"] DL["GitHub Releases 下载 .exe"] --> Setup["双击安装"] Setup --> Launch["启动 desktop-cc-gui"] Launch --> Auto["自动检测 Claude Code 引擎"] end Step1 --> Step2 --> Step3 --> Step4

常见问题

问题 原因 解决
nvm install lts 下载超时 settings.txt 没配镜像 检查 node_mirror 行是否已添加
npm install -g 下载卡住 registry 没切镜像 执行 npm config set registry https://registry.npmmirror.com
claude 命令不识别 安装后没重启终端 关掉所有 PowerShell 重新打开
desktop-cc-gui 找不到引擎 PATH 或路径问题 设置中手动指向 npm 全局包路径
npm install -g 报 EACCES 管理员权限不足 右键以管理员身份运行 PowerShell
GUI 白屏/闪退 缺少 WebView2 运行时 微软官网 下载安装
Chat Canvas 发消息没反应 Claude Code 未认证 先在终端里跑一次 claude 完成登录
npmmirror 拉不到某个包 镜像同步延迟 临时切腾讯云镜像，装完切回来
posted @ 2026-05-19 17:45  司野良  阅读(1394)  评论(0)    收藏  举报