当前位置：首页 > news >正文

CC Desktop：基于Claude Code CLI的桌面AI编程工作台深度解析

news 2026/5/14 0:58:56

1. 项目概述：一个为AI编程而生的桌面工作台

如果你和我一样，每天大部分时间都泡在终端里，和Claude Code CLI打交道，那你肯定也经历过这种场景：一边开着终端窗口敲命令，一边还得在浏览器和代码编辑器之间来回切换，就为了能顺畅地和Claude对话、让它帮忙写代码、或者整理项目资料。这种割裂感，说实话，挺影响“心流”状态的。CC Desktop这个项目，就是冲着解决这个痛点来的。它本质上是一个基于Electron构建的桌面应用，但它不是简单地给Claude Code CLI套个壳，而是把它从一个命令行工具，彻底升级成了一个集成了终端、AI对话、项目工作台三位一体的桌面AI编程工作台。

简单来说，它让你可以在一个统一的图形界面里，完成所有与AI辅助编程相关的工作：用熟悉的终端操作项目、和Claude进行流式对话（甚至能给它看代码截图）、在一个结构化的Notebook里整理需求和生成成果。更重要的是，它把Claude Code CLI背后那套强大的扩展能力——比如MCP（模型上下文协议）、插件、技能、钩子——都做了可视化的管理，还内置了插件市场。这意味着你不用再死记硬背一堆claude plugin命令，点点鼠标就能安装、配置各种增强功能。

这个项目特别适合两类人：一是重度依赖Claude进行代码生成、调试、重构的开发者，尤其是那些觉得纯CLI交互不够直观的；二是希望将AI能力深度集成到团队工作流中的技术负责人，因为它提供了像钉钉机器人集成这样的功能，能把AI辅助开发带到移动端。接下来，我会结合自己从零开始配置、使用到深度定制的全过程，拆解它的核心设计、实操细节以及那些官方文档里没写的“坑”。

2. 核心设计思路与架构解析

2.1 为什么是“三模式”工作流？

CC Desktop最核心的设计就是它的“三模式”工作流：Developer模式、Agent模式和Notebook模式。这绝不是简单的功能堆砌，而是针对AI编程不同阶段的需求做的精心划分。

Developer模式的本质是一个PTY（伪终端）直连。它不是一个简单的stdin/stdout转发，而是通过Node.js的node-pty模块，在Electron的主进程或渲染进程中创建一个真正的终端实例，直接与你的系统Shell（如bash、zsh、PowerShell）交互。这意味着你在这个模式里运行claude命令，和你在系统终端里运行，环境变量、工作目录、进程状态都是完全一致的。这种设计的最大好处是状态持久化。比如，你启动了一个长期运行的开发服务器，或者激活了一个Python虚拟环境，这个状态会一直保留在这个终端会话里，不会因为你切到Agent模式聊几句天就丢失。这解决了传统“聊天机器人式”AI工具与本地开发环境脱节的问题。

Agent模式则聚焦于高交互性的AI对话。它提供了一个类似ChatGPT的聊天界面，但背后连接的是Claude Code CLI的对话能力。它的关键特性是流式输出和视觉支持。流式输出不用多说，看着代码一个字一个字“敲”出来，体验比等半天然后蹦出一大段要好得多。视觉支持则是个隐藏的利器：你可以直接把代码文件的截图、UI设计图甚至错误日志的截图拖进对话框，Claude能“看到”并理解其中的内容。这对于调试无法直接复制的图形界面错误，或者基于视觉稿生成前端代码，效率提升是巨大的。

Notebook模式的定位是结构化的工作空间。你可以把它理解为一个轻量级的、AI原生的“项目Wiki”或“实验记录本”。在这里，你可以分门别类地存放项目需求文档、代码片段、API文档、以及Claude生成的解决方案。它的核心价值在于“成果物管理”和“上下文沉淀”。一次成功的AI调试会话，其输入（问题描述、错误日志）、过程（Claude的分析和尝试）、输出（最终可用的代码片段）都可以被保存为一个Notebook条目。下次遇到类似问题，直接打开这个条目，完整的上下文就回来了，无需重新描述。这对于复杂项目的问题追踪和知识积累至关重要。

2.2 可扩展能力体系：从CLI命令到可视化工作台

Claude Code CLI本身已经通过MCP、插件等机制具备了强大的扩展性，但这一切都需要通过命令行来管理。CC Desktop的第二个核心设计，就是将这些能力可视化、中心化。

内置插件运行时是这项设计的基石。在原始CLI中，运行claude plugin install <name>实际上是在你的系统环境里安装一个Node.js包或可执行文件。CC Desktop改变了这一点：它将插件的安装、卸载、更新、启停等操作，全部接管到Electron的主进程中执行。这样做有几个深层考量：

环境隔离：避免插件污染用户的全局Node环境或与项目依赖冲突。
权限统一：桌面应用可以更安全地管理插件所需的系统权限（如文件访问、网络请求）。
状态管理：应用可以集中管理所有插件的状态，并提供统一的启用/禁用开关。

能力设置工作台则是可视化的体现。在这里，所有已安装的MCP服务器、技能、插件、代理和钩子，都以卡片或列表的形式呈现。你可以清晰地看到每个能力的描述、版本、状态，并进行配置。例如，一个“代码仓库分析”插件，你可以直接在工作台里设置它要扫描的目录、忽略的文件模式，而不用去翻找晦涩的JSON配置文件。这种设计极大地降低了扩展功能的使用门槛。

内置市场进一步简化了发现和安装流程。你不需要去GitHub上寻找插件，再手动安装。在CC Desktop的应用内，就能浏览、搜索、一键安装社区贡献的各类能力。这构建了一个潜在的正向生态循环：开发者更容易分发插件，用户更容易发现和使用插件。

2.3 多服务商API管理：灵活性与成本控制的平衡

依赖单一的官方API服务，可能会遇到速率限制、地域访问或成本问题。CC Desktop的多服务商API管理功能，提供了宝贵的灵活性。

它允许你配置多个API端点。比如：

官方端点：https://api.anthropic.com，稳定可靠。
代理/中转端点：一些第三方服务提供的兼容Anthropic API的端点，可能价格更优或网络延迟更低。
自建端点：如果你通过一些开源项目自己部署了兼容API的服务。

更巧妙的是自定义模型映射功能。不同的服务商对模型的命名可能不同。官方可能叫claude-3-5-sonnet-20241022，而某个中转服务可能将其简化为claude-3.5-sonnet。你可以在CC Desktop中创建一个映射规则，告诉应用：当我在界面上选择“Claude 3.5 Sonnet”时，如果当前激活的是A服务商，就使用model_a这个参数；如果是B服务商，就使用model_b。这样，你在切换不同供应商时，无需改变自己使用模型的操作习惯。

这个设计背后是开发者对生产环境使用的深刻理解。它让团队可以根据预算、性能需求或合规要求，灵活地切换或组合使用不同的AI服务供应商，而无需修改应用本身的代码。

3. 从零开始的完整配置与实操指南

3.1 环境准备与基础安装

虽然CC Desktop提供了打包好的可执行文件，但为了后续可能的调试或功能尝鲜，我建议从源码构建开始，这能帮你理解整个应用的构成。

第一步：克隆项目与安装依赖

git clone https://github.com/hydroCoderClaud/cc-desktop.git cd cc-desktop npm install

注意：这里有个关键点。项目依赖了electron、node-pty等原生模块。node-pty的编译严重依赖系统构建工具链。在Windows上，你必须确保已安装Visual Studio Build Tools和Python（且版本匹配）。在macOS上，则需要Xcode Command Line Tools。如果npm install失败，大概率是这里的环境没准备好。

第二步：安装Claude Code CLI这是CC Desktop运行的前提。官方提供的快速安装命令确实方便：

Windows (PowerShell):
```
irm https://claude.ai/install.ps1 | iex
```

macOS/Linux (bash):

curl -fsSL https://claude.ai/install.sh | bash

安装完成后，务必在终端里运行一下claude --version，确认CLI已正确安装并加入PATH。CC Desktop在启动时会主动寻找这个命令。

第三步：启动开发模式

npm run dev

这会同时启动Electron应用窗口和必要的开发服务。第一次启动时，应用会检测CLI，如果没找到，会给出明确的提示。

3.2 核心配置详解：服务商、API密钥与模型

应用启动后，别急着用，花几分钟做好配置，后续体验会顺畅很多。

1. 配置API服务商点击设置（通常是齿轮图标），进入“服务商管理”。这里默认可能只有Anthropic官方。点击“添加服务商”。

名称：起个容易识别的名字，如“Anthropic官方”、“XX云中转”。
API 基础 URL：这是核心。对于官方，就是https://api.anthropic.com。对于其他服务商，填入他们提供的端点地址，例如https://api.xxx.com/v1。
模型列表URL（可选）：有些服务商提供单独的接口来获取支持的模型列表。如果留空，CC Desktop会使用默认的模型列表，或尝试从对话接口推断。

2. 添加API密钥在“API配置管理”中，为你刚添加的服务商配置密钥。

密钥名称：用于区分，比如“我的工作密钥”。
服务商：选择上一步创建的服务商。
API密钥：填入从该服务商处获取的实际密钥。对于Anthropic官方，密钥以sk-ant-开头。这里有一个高级技巧：CC Desktop支持配置多个密钥，甚至可以为同一个服务商配置多个。应用在请求时可能会轮询使用，这在一定程度上可以绕过单个密钥的速率限制。

3. 理解与配置模型映射这是进阶功能，但非常实用。在服务商配置或全局设置中，找到“模型映射”相关选项。假设你添加了一个中转服务商“MyProxy”，它提供的模型名是gpt-4（实际上背后是Claude）。而你在CC Desktop的界面上想看到的、以及在其他插件中引用的，可能是标准的claude-3-opus。你可以在映射规则中添加一条：

界面显示/内部引用名: claude-3-opus -> 实际向服务商请求的模型参数: gpt-4

这样，无论你在Agent模式选择模型，还是在Notebook中调用，你只需要认准claude-3-opus这个逻辑名，CC Desktop会自动帮你转换成对应服务商能识别的实际参数。

3.3 三大工作模式的核心操作流程

配置完成后，我们来深入每一个模式。

Developer模式实战

连接项目：在侧边栏选择或输入一个本地项目文件夹的路径，点击“连接”。CC Desktop会在后台为该路径启动一个PTY终端会话。
终端操作：你会看到一个功能完整的终端界面。你可以运行任何Shell命令，ls,cd,git status等等。关键在于，你可以直接在这里运行claude命令。
与CLI无缝交互：例如，输入claude，“帮我检查当前目录下app.js文件的语法”。Claude Code CLI会处理这个请求，并将结果流式地输出在这个终端里。所有CLI的原生功能，包括插件、MCP，在这里都完全可用。你的终端环境（虚拟环境、环境变量）与外部完全一致。

Agent模式实战

开启对话：切换到Agent模式，界面变成一个聊天窗口。你可以直接输入问题，如“用Python写一个快速排序函数”。
利用视觉输入：尝试将一张含有代码错误的截图拖入输入框。Claude不仅能识别图片中的文本，还能理解代码结构和错误信息，并给出修复建议。这对于编译错误、运行时异常提示的排查特别有用。
处理长上下文：当对话历史很长时，注意观察界面是否有“总结”或“压缩上下文”的选项。合理使用这些功能，可以避免达到模型的上下文窗口限制，导致最早的对话内容被“遗忘”。

Notebook模式实战

创建知识单元：Notebook通常以“项目”或“主题”为单位。为你正在开发的功能创建一个新的Notebook，例如“用户登录模块重构”。
结构化记录：
- 源材料区：粘贴产品需求文档、旧的代码片段、API接口文档。
- 对话区：将你在Agent模式中关于此主题的有价值对话“保存”到这里。
- 成果区：将Claude生成的最终代码、配置说明、测试用例整理到这里。
生成最终文档：利用Notebook的“生成”功能，可以将整个工作台的内容（源材料、对话、成果）整合成一份结构清晰的Markdown或HTML文档，直接用于项目归档或分享。

3.4 扩展能力：插件安装与钉钉集成

插件市场的使用

在“扩展能力”或“市场”页面，你会看到一个插件列表。每个插件都有简短描述、作者、评分（如果有）。
找到你需要的插件，例如一个“代码风格检查”插件，点击“安装”。CC Desktop会在后台自动完成下载、依赖安装和注册。
安装后，在“能力工作台”找到该插件，你可以查看其详细说明，并进行配置（如指定检查规则ESLint还是Prettier）。
关键步骤：大部分插件需要启用才会生效。确保插件卡片的开关是打开状态。

钉钉机器人集成配置这个功能能将你的CC Desktop变成一个“服务器”，通过钉钉机器人接收指令并返回结果，实现移动端编程。

创建钉钉机器人：在你的钉钉群或自建应用中，添加一个自定义机器人，获取它的Webhook地址和加签密钥。
在CC Desktop中配置：在设置中找到“钉钉集成”或“Webhook”选项。
- 填入钉钉机器人的Webhook地址。
- 填入加签密钥（如果需要）。
- 设置一个通信令牌，这是一个由你自定义的密码，用于验证请求来自你信任的钉钉机器人。
安全配置（非常重要）：务必配置IP白名单或请求签名验证。在CC Desktop的设置中，限制只接收来自钉钉官方IP段的请求，并在代码逻辑中验证钉钉请求的签名，防止恶意调用。
使用：在钉钉群里@你的机器人，发送如/claude 查看当前项目状态这样的指令。CC Desktop收到后，会在后台执行相应的claude命令，并将结果返回到钉钉群中。

4. 深度使用技巧与高级配置

4.1 性能调优与资源管理

CC Desktop作为一个Electron应用，本身会消耗一定的内存和CPU资源。当同时运行多个终端会话、进行长时间的流式对话时，资源管理尤为重要。

终端会话管理：

会话冻结：对于暂时不用的Developer模式会话，看看应用是否支持“冻结”或“休眠”功能。这会将终端进程挂起，释放其占用的CPU和内存，当需要时再快速唤醒。如果原生不支持，一个变通的方法是手动停止在该终端中运行的活跃进程（如开发服务器），保留一个空闲的Shell。
定期清理历史：长时间的终端输出会积累在应用的渲染进程中，占用内存。可以定期清理滚动缓冲区，或者在设置中限制终端历史输出的最大行数（例如，保留最近10000行）。

流式对话优化：

调整流式块大小：在设置中，可能可以找到“流式响应块大小”或类似的选项。较小的块（如100个字符）会让输出看起来更“实时”，但会增加网络请求次数。较大的块（如500个字符）可以减少请求数，但每次更新的延迟感会更明显。根据你的网络状况进行调整。
禁用非活动标签的实时更新：如果你打开了多个Agent对话标签页，可以确保只有当前激活的标签页在进行流式接收，其他后台标签页在激活前暂停更新，这能节省前端渲染开销。

Electron应用层面：

启用硬件加速：在CC Desktop的启动参数或设置中，确保硬件加速是开启的（通常是默认的）。这能让UI渲染更流畅。
监控渲染进程内存：通过Electron DevTools（如果开发模式可用）或系统监控工具，观察渲染进程的内存占用。如果发现内存只增不减（内存泄漏），尝试重启应用。一个良好的习惯是，每天结束工作时关闭CC Desktop。

4.2 自定义主题与快捷键

为了提升长时间使用的舒适度和效率，个性化设置必不可少。

主题定制： CC Desktop提供了6套配色方案和深色/浅色模式。但你可以走得更远。

查找用户配置目录：通常，Electron应用的用户数据会存放在%APPDATA%（Windows）或~/.config（macOS/Linux）下的一个以应用名命名的文件夹中。例如，%APPDATA%\cc-desktop。
探索主题文件：在该目录下，寻找themes、styles或config.json等文件。主题可能以CSS文件或JSON配置的形式存在。
自定义CSS：如果支持，你可以创建自己的CSS文件，覆盖原有的样式。比如，修改代码高亮字体、调整终端背景色透明度、更改聊天框的边框圆角等。将自定义CSS文件放在指定位置，并在设置中引用它。

快捷键配置：效率工具的灵魂在于快捷键。查看CC Desktop的“设置”->“快捷键”部分。

系统全局快捷键：有些应用支持设置全局热键（如Cmd+Shift+C），即使应用在后台，也能快速唤出。这对于随时记录灵感或快速提问非常有用。确保你设置的组合键不与系统或其他常用应用冲突。
应用内快捷键：熟悉并定制以下关键操作的快捷键：
- 快速切换Developer/Agent/Notebook模式。
- 在当前模式中，快速新建会话或标签页。
- 清除当前终端或聊天记录。
- 触发常用插件功能（如代码格式化、解释）。
- 如果支持，为“将当前对话保存至Notebook”设置一个快捷键，这是积累知识库的关键动作。

4.3 插件开发入门：扩展你的工作台

当内置插件和市场插件无法满足你的特定需求时，自己开发一个插件是最佳选择。CC Desktop的插件体系与Claude Code CLI兼容，这降低了学习成本。

插件结构概览：一个典型的插件目录结构如下：

my-awesome-plugin/ ├── package.json ├── index.js (或 main.js) └── README.md

package.json：最重要的文件。必须包含name(以claude-plugin-开头)、version、main(入口文件)、keywords(包含"claude-plugin")，以及在claude字段下声明插件提供的能力（capabilities）。
index.js：插件的主逻辑文件。导出Claude CLI期望的接口。

定义一个简单的“时间戳”插件：假设我们想添加一个命令，让Claude能输出当前时间戳。

创建项目并初始化package.json:

{ "name": "claude-plugin-timestamp", "version": "1.0.0", "description": "A plugin to get current timestamp", "main": "index.js", "keywords": ["claude-plugin"], "claude": { "capabilities": ["timestamp"] } }

编写插件逻辑 (index.js):

module.exports = (claude) => { // 注册一个名为 'timestamp' 的命令 claude.command('timestamp', 'Get current timestamp', async (args, context) => { const now = Date.now(); // 获取当前时间戳 return `Current timestamp is: ${now}`; }); // 也可以注册为一个工具（Tool），供AI在对话中调用 claude.tool('get_timestamp', { description: 'Get the current Unix timestamp in milliseconds', inputSchema: { type: 'object', properties: {} // 此工具不需要输入参数 } }, async () => { return { timestamp: Date.now() }; }); };

在CC Desktop中加载插件：
- 开发期：将插件目录链接到CC Desktop的插件扫描路径。通常，你可以在CC Desktop的设置中指定一个“本地插件目录”，或者直接将插件目录放到~/.claude/plugins/下（具体路径请参考CC Desktop文档）。
- 发布后：将插件发布到npm（包名需以claude-plugin-开头），它就有可能出现在CC Desktop的内置市场中，供其他用户一键安装。

插件与CC Desktop的交互：你的插件不仅可以响应CLI命令，还可以通过CC Desktop提供的API（如果暴露的话）来与UI交互。例如，一个插件可以在特定事件（如代码生成完成）时，在CC Desktop的界面上显示一个通知，或者将内容自动写入到Notebook的特定区域。这需要你查阅CC Desktop的开发者文档，了解其暴露给插件的IPC（进程间通信）或Renderer API。

5. 故障排查与常见问题实录

在实际使用中，你肯定会遇到各种问题。这里记录了我踩过的一些坑和解决方案。

5.1 安装与启动类问题

问题1：启动CC Desktop时提示“Claude Code CLI not found”

排查步骤：
1. 验证CLI安装：打开系统终端（如PowerShell或Terminal），直接输入claude --version。如果报错，说明CLI未正确安装或不在PATH中。
2. 检查PATH环境变量：在终端输入where claude(Windows) 或which claude(macOS/Linux)，查看命令所在路径。确保此路径包含在系统的PATH环境变量中。
3. 重启CC Desktop：有时应用在安装CLI之前启动，它缓存了“未找到”的状态。完全退出CC Desktop再重新启动。
4. 指定CLI路径：如果CLI安装在非标准位置，查看CC Desktop的设置中是否有选项可以手动指定claude可执行文件的完整路径。
根本原因：CC Desktop本质上是通过Node.js的child_process模块来调用claude命令。如果系统Shell找不到这个命令，调用就会失败。

问题2：Windows下终端显示乱码

现象：在Developer模式的终端中，中文或特殊符号显示为问号“?”或方块。
解决方案：
1. 确保Git Bash已安装：CC Desktop在Windows上默认优先使用Git Bash作为PTY的Shell。从 git-scm.com 下载并安装Git for Windows。
2. 配置默认Shell：在CC Desktop的设置中，找到“终端”或“开发者模式”设置项，将“默认Shell路径”明确设置为Git Bash的可执行文件，通常是C:\Program Files\Git\bin\bash.exe。
3. 设置正确的编码：在终端界面内右键（或通过设置），将字符编码（Encoding）设置为UTF-8。同时，在Git Bash自身的配置中，也应确保字符集为UTF-8。
原理：乱码通常是因为终端模拟器（PTY）的编码与Shell内部使用的编码不一致。UTF-8是统一的标准。

问题3：打包应用后，右侧面板（如设置页）空白

现象：使用npm run build或类似命令打包成独立应用后，运行发现某些页面没有内容。
解决方案：
1. 检查依赖：正如项目README提到的，确保在打包前运行了npm install。重点检查是否有像js-yaml这类在代码中require但未正确安装的依赖。
2. 检查打包配置：Electron打包工具（如electron-builder或electron-forge）需要正确配置files或extraResources字段，以确保渲染进程所需的所有前端资源（HTML, CSS, JS, 图片）都被包含进最终的应用包中。检查package.json中的构建配置。
3. 查看开发者工具：在打包后的应用中，通常可以通过菜单或快捷键（如Ctrl+Shift+I）打开开发者工具。在“Console”和“Network”标签页中查看是否有JavaScript错误或资源加载失败（404错误）。这能精准定位缺失的文件。

5.2 运行时与网络类问题

问题4：Agent模式对话响应慢或频繁超时

排查步骤：
1. 检查API端点与密钥：确认设置中配置的API服务商地址和密钥是否正确。可以尝试在终端直接用curl命令测试该API端点是否通畅。
2. 切换服务商：如果你配置了多个服务商，尝试切换到另一个，排除某个服务商网络不稳定或过载的问题。
3. 查看请求日志：CC Desktop可能提供了网络请求日志功能（通常在设置或开发者工具中开启）。查看具体是哪一步（DNS解析、TCP连接、SSL握手、请求响应）耗时过长。
4. 调整超时设置：在设置中寻找“请求超时”或“网络超时”配置，适当增大超时时间（例如从30秒增加到60秒）。
潜在原因：网络延迟、API服务商限流、代理配置错误、或请求的上下文过长导致模型处理时间久。

问题5：插件安装失败或启用后不生效

排查步骤：
1. 查看插件日志：CC Desktop应有插件管理日志。检查安装过程中是否有权限错误、网络下载失败或依赖安装失败的记录。
2. 检查插件兼容性：确认插件是否与你当前使用的Claude Code CLI版本兼容。有些插件可能依赖特定版本的CLI API。
3. 手动安装测试：尝试在系统终端中，使用claude plugin install <plugin-name>命令手动安装该插件。如果手动安装成功但在CC Desktop中失败，可能是CC Desktop的插件运行时环境有问题。
4. 检查插件权限：某些插件需要访问文件系统或网络。在CC Desktop的能力工作台中，查看该插件是否被授予了必要的权限。macOS/Linux系统也可能需要你为Electron应用授予相应的磁盘访问权限。
经验之谈：社区插件的质量参差不齐。优先选择星标多、最近有更新的插件。对于新插件，可以先在测试环境中试用。

问题6：钉钉机器人收不到回复或回复延迟高

排查步骤：
1. 验证Webhook：使用curl或 Postman 工具，直接向你的钉钉机器人Webhook地址发送一条测试消息，看钉钉群是否能收到。这可以排除钉钉侧的配置问题。
2. 检查CC Desktop服务状态：确认CC Desktop正在运行，并且钉钉集成功能已启用。查看CC Desktop的日志，看是否收到了来自钉钉的HTTP请求。
3. 检查网络可达性：你的CC Desktop所在机器必须有一个钉钉服务器能够访问到的IP地址。如果你在公司内网，可能需要配置端口映射或使用内网穿透工具。重要：确保CC Desktop监听的端口（通常在配置中设置，如7890）已在防火墙中放行。
4. 检查令牌验证：确认钉钉机器人发送请求时携带的令牌（如果有）与CC Desktop中配置的令牌完全一致，包括大小写。
5. 查看请求处理队列：如果CC Desktop正在处理一个非常耗时的Claude请求（如生成大量代码），它可能无法及时响应钉钉的请求。考虑设置一个超时机制，或者优化请求任务队列。

5.3 配置与数据管理

问题7：如何备份和迁移我的CC Desktop配置与数据？你的所有配置、会话历史、Notebook内容、插件数据通常存储在用户数据目录下。

定位目录：
- Windows:%APPDATA%\cc-desktop
- macOS:~/Library/Application Support/cc-desktop
- Linux:~/.config/cc-desktop或~/.cc-desktop
备份：关闭CC Desktop后，直接压缩复制整个上述目录。
迁移：在新机器上安装好CC Desktop和Claude Code CLI后，先运行一次CC Desktop（让它生成默认配置目录），然后关闭它。用备份的目录覆盖新生成的目录即可。
注意：备份数据可能包含你的API密钥（通常是加密存储的，但安全起见，迁移后建议在CC Desktop内验证或重新输入密钥）。

问题8：Notebook内容突然丢失或损坏

立即措施：不要进行任何写入操作。首先检查用户数据目录下的Notebook存储文件（可能是.json或.sqlite文件）。尝试用文本编辑器打开JSON文件看是否结构损坏，或用SQLite浏览器打开数据库文件。
寻找备份：CC Desktop可能具有自动备份功能，在数据目录下寻找backup文件夹，里面可能有按日期归档的旧版本数据。
预防措施：养成定期导出重要Notebook为Markdown文件的习惯。可以考虑编写一个简单的脚本，定时将用户数据目录同步到云盘或版本控制系统（如Git，注意忽略敏感文件）。

最后，关于这个项目的许可证需要特别注意。它采用了一个自定义许可证，明确允许个人使用、学习和开发，但禁止商业销售和再分发。这意味着你可以自由地使用它来提升自己的工作效率，也可以为它贡献代码、修复Bug，但你不能将它打包后作为你自己的产品去售卖。在考虑任何基于此项目的商业用途前，请务必仔细阅读项目根目录下的LICENSE文件。对于大多数开发者来说，这个许可协议是足够友好和开放的，它保护了原作者的权益，同时也鼓励了社区的学习和贡献。

查看全文

http://www.jsqmd.com/news/812094/