[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-aaddrick--claude-desktop-debian":3,"tool-aaddrick--claude-desktop-debian":64},[4,17,27,35,44,52],{"id":5,"name":6,"github_repo":7,"description_zh":8,"stars":9,"difficulty_score":10,"last_commit_at":11,"category_tags":12,"status":16},1381,"everything-claude-code","affaan-m\u002Feverything-claude-code","everything-claude-code 是一套专为 AI 编程助手（如 Claude Code、Codex、Cursor 等）打造的高性能优化系统。它不仅仅是一组配置文件，而是一个经过长期实战打磨的完整框架，旨在解决 AI 代理在实际开发中面临的效率低下、记忆丢失、安全隐患及缺乏持续学习能力等核心痛点。\n\n通过引入技能模块化、直觉增强、记忆持久化机制以及内置的安全扫描功能，everything-claude-code 能显著提升 AI 在复杂任务中的表现，帮助开发者构建更稳定、更智能的生产级 AI 代理。其独特的“研究优先”开发理念和针对 Token 消耗的优化策略，使得模型响应更快、成本更低，同时有效防御潜在的攻击向量。\n\n这套工具特别适合软件开发者、AI 研究人员以及希望深度定制 AI 工作流的技术团队使用。无论您是在构建大型代码库，还是需要 AI 协助进行安全审计与自动化测试，everything-claude-code 都能提供强大的底层支持。作为一个曾荣获 Anthropic 黑客大奖的开源项目，它融合了多语言支持与丰富的实战钩子（hooks），让 AI 真正成长为懂上",150720,2,"2026-04-11T11:33:10",[13,14,15],"开发框架","Agent","语言模型","ready",{"id":18,"name":19,"github_repo":20,"description_zh":21,"stars":22,"difficulty_score":10,"last_commit_at":23,"category_tags":24,"status":16},6121,"gemini-cli","google-gemini\u002Fgemini-cli","gemini-cli 是一款由谷歌推出的开源 AI 命令行工具，它将强大的 Gemini 大模型能力直接集成到用户的终端环境中。对于习惯在命令行工作的开发者而言，它提供了一条从输入提示词到获取模型响应的最短路径，无需切换窗口即可享受智能辅助。\n\n这款工具主要解决了开发过程中频繁上下文切换的痛点，让用户能在熟悉的终端界面内直接完成代码理解、生成、调试以及自动化运维任务。无论是查询大型代码库、根据草图生成应用，还是执行复杂的 Git 操作，gemini-cli 都能通过自然语言指令高效处理。\n\n它特别适合广大软件工程师、DevOps 人员及技术研究人员使用。其核心亮点包括支持高达 100 万 token 的超长上下文窗口，具备出色的逻辑推理能力；内置 Google 搜索、文件操作及 Shell 命令执行等实用工具；更独特的是，它支持 MCP（模型上下文协议），允许用户灵活扩展自定义集成，连接如图像生成等外部能力。此外，个人谷歌账号即可享受免费的额度支持，且项目基于 Apache 2.0 协议完全开源，是提升终端工作效率的理想助手。",100752,"2026-04-10T01:20:03",[25,14,26,13],"插件","图像",{"id":28,"name":29,"github_repo":30,"description_zh":31,"stars":32,"difficulty_score":10,"last_commit_at":33,"category_tags":34,"status":16},4721,"markitdown","microsoft\u002Fmarkitdown","MarkItDown 是一款由微软 AutoGen 团队打造的轻量级 Python 工具，专为将各类文件高效转换为 Markdown 格式而设计。它支持 PDF、Word、Excel、PPT、图片（含 OCR）、音频（含语音转录）、HTML 乃至 YouTube 链接等多种格式的解析，能够精准提取文档中的标题、列表、表格和链接等关键结构信息。\n\n在人工智能应用日益普及的今天，大语言模型（LLM）虽擅长处理文本，却难以直接读取复杂的二进制办公文档。MarkItDown 恰好解决了这一痛点，它将非结构化或半结构化的文件转化为模型“原生理解”且 Token 效率极高的 Markdown 格式，成为连接本地文件与 AI 分析 pipeline 的理想桥梁。此外，它还提供了 MCP（模型上下文协议）服务器，可无缝集成到 Claude Desktop 等 LLM 应用中。\n\n这款工具特别适合开发者、数据科学家及 AI 研究人员使用，尤其是那些需要构建文档检索增强生成（RAG）系统、进行批量文本分析或希望让 AI 助手直接“阅读”本地文件的用户。虽然生成的内容也具备一定可读性，但其核心优势在于为机器",93400,"2026-04-06T19:52:38",[25,13],{"id":36,"name":37,"github_repo":38,"description_zh":39,"stars":40,"difficulty_score":41,"last_commit_at":42,"category_tags":43,"status":16},4487,"LLMs-from-scratch","rasbt\u002FLLMs-from-scratch","LLMs-from-scratch 是一个基于 PyTorch 的开源教育项目，旨在引导用户从零开始一步步构建一个类似 ChatGPT 的大型语言模型（LLM）。它不仅是同名技术著作的官方代码库，更提供了一套完整的实践方案，涵盖模型开发、预训练及微调的全过程。\n\n该项目主要解决了大模型领域“黑盒化”的学习痛点。许多开发者虽能调用现成模型，却难以深入理解其内部架构与训练机制。通过亲手编写每一行核心代码，用户能够透彻掌握 Transformer 架构、注意力机制等关键原理，从而真正理解大模型是如何“思考”的。此外，项目还包含了加载大型预训练权重进行微调的代码，帮助用户将理论知识延伸至实际应用。\n\nLLMs-from-scratch 特别适合希望深入底层原理的 AI 开发者、研究人员以及计算机专业的学生。对于不满足于仅使用 API，而是渴望探究模型构建细节的技术人员而言，这是极佳的学习资源。其独特的技术亮点在于“循序渐进”的教学设计：将复杂的系统工程拆解为清晰的步骤，配合详细的图表与示例，让构建一个虽小但功能完备的大模型变得触手可及。无论你是想夯实理论基础，还是为未来研发更大规模的模型做准备",90106,3,"2026-04-06T11:19:32",[15,26,14,13],{"id":45,"name":46,"github_repo":47,"description_zh":48,"stars":49,"difficulty_score":10,"last_commit_at":50,"category_tags":51,"status":16},3704,"NextChat","ChatGPTNextWeb\u002FNextChat","NextChat 是一款轻量且极速的 AI 助手，旨在为用户提供流畅、跨平台的大模型交互体验。它完美解决了用户在多设备间切换时难以保持对话连续性，以及面对众多 AI 模型不知如何统一管理的痛点。无论是日常办公、学习辅助还是创意激发，NextChat 都能让用户随时随地通过网页、iOS、Android、Windows、MacOS 或 Linux 端无缝接入智能服务。\n\n这款工具非常适合普通用户、学生、职场人士以及需要私有化部署的企业团队使用。对于开发者而言，它也提供了便捷的自托管方案，支持一键部署到 Vercel 或 Zeabur 等平台。\n\nNextChat 的核心亮点在于其广泛的模型兼容性，原生支持 Claude、DeepSeek、GPT-4 及 Gemini Pro 等主流大模型，让用户在一个界面即可自由切换不同 AI 能力。此外，它还率先支持 MCP（Model Context Protocol）协议，增强了上下文处理能力。针对企业用户，NextChat 提供专业版解决方案，具备品牌定制、细粒度权限控制、内部知识库整合及安全审计等功能，满足公司对数据隐私和个性化管理的高标准要求。",87618,"2026-04-05T07:20:52",[13,15],{"id":53,"name":54,"github_repo":55,"description_zh":56,"stars":57,"difficulty_score":10,"last_commit_at":58,"category_tags":59,"status":16},2268,"ML-For-Beginners","microsoft\u002FML-For-Beginners","ML-For-Beginners 是由微软推出的一套系统化机器学习入门课程，旨在帮助零基础用户轻松掌握经典机器学习知识。这套课程将学习路径规划为 12 周，包含 26 节精炼课程和 52 道配套测验，内容涵盖从基础概念到实际应用的完整流程，有效解决了初学者面对庞大知识体系时无从下手、缺乏结构化指导的痛点。\n\n无论是希望转型的开发者、需要补充算法背景的研究人员，还是对人工智能充满好奇的普通爱好者，都能从中受益。课程不仅提供了清晰的理论讲解，还强调动手实践，让用户在循序渐进中建立扎实的技能基础。其独特的亮点在于强大的多语言支持，通过自动化机制提供了包括简体中文在内的 50 多种语言版本，极大地降低了全球不同背景用户的学习门槛。此外，项目采用开源协作模式，社区活跃且内容持续更新，确保学习者能获取前沿且准确的技术资讯。如果你正寻找一条清晰、友好且专业的机器学习入门之路，ML-For-Beginners 将是理想的起点。",85092,"2026-04-10T11:13:16",[26,60,61,25,14,62,15,13,63],"数据工具","视频","其他","音频",{"id":65,"github_repo":66,"name":67,"description_en":68,"description_zh":69,"ai_summary_zh":70,"readme_en":71,"readme_zh":72,"quickstart_zh":73,"use_case_zh":74,"hero_image_url":75,"owner_login":76,"owner_name":77,"owner_avatar_url":78,"owner_bio":79,"owner_company":79,"owner_location":80,"owner_email":81,"owner_twitter":79,"owner_website":79,"owner_url":82,"languages":83,"stars":100,"forks":101,"last_commit_at":102,"license":103,"difficulty_score":10,"env_os":104,"env_gpu":105,"env_ram":105,"env_deps":106,"category_tags":112,"github_topics":79,"view_count":10,"oss_zip_url":79,"oss_zip_packed_at":79,"status":16,"created_at":113,"updated_at":114,"faqs":115,"releases":145},6668,"aaddrick\u002Fclaude-desktop-debian","claude-desktop-debian","Claude Desktop for Debian-based Linux distributions","claude-desktop-debian 是一个让 Claude 桌面应用原生运行在 Linux 系统上的开源项目。它通过重新打包官方 Windows 版本，为 Debian、Ubuntu、Fedora、Arch 及 NixOS 等主流发行版提供了便捷的安装包（如 .deb、.rpm、AppImage 等），解决了 Linux 用户此前只能依赖虚拟机或 Wine 才能使用 Claude 客户端的痛点。\n\n该项目特别适合需要在 Linux 环境下高效工作的开发者、研究人员及技术爱好者。它不仅实现了原生的流畅体验，还完整支持模型上下文协议（MCP），允许用户通过配置文件灵活扩展功能。此外，它深度集成了 Linux 桌面环境，支持全局快捷键（Ctrl+Alt+Space）和系统托盘，操作习惯与原生应用无异。\n\n技术亮点方面，claude-desktop-debian 实验性地引入了“协作模式”（Cowork Mode），默认采用 bubblewrap 沙箱技术进行命名空间隔离，在保障安全的同时限制了对主目录的写入权限；若环境不支持，也可自动切换至主机模式。项目提供了一键添加软件源的脚本，让","claude-desktop-debian 是一个让 Claude 桌面应用原生运行在 Linux 系统上的开源项目。它通过重新打包官方 Windows 版本，为 Debian、Ubuntu、Fedora、Arch 及 NixOS 等主流发行版提供了便捷的安装包（如 .deb、.rpm、AppImage 等），解决了 Linux 用户此前只能依赖虚拟机或 Wine 才能使用 Claude 客户端的痛点。\n\n该项目特别适合需要在 Linux 环境下高效工作的开发者、研究人员及技术爱好者。它不仅实现了原生的流畅体验，还完整支持模型上下文协议（MCP），允许用户通过配置文件灵活扩展功能。此外，它深度集成了 Linux 桌面环境，支持全局快捷键（Ctrl+Alt+Space）和系统托盘，操作习惯与原生应用无异。\n\n技术亮点方面，claude-desktop-debian 实验性地引入了“协作模式”（Cowork Mode），默认采用 bubblewrap 沙箱技术进行命名空间隔离，在保障安全的同时限制了对主目录的写入权限；若环境不支持，也可自动切换至主机模式。项目提供了一键添加软件源的脚本，让用户能像安装普通系统软件一样轻松获取并自动更新最新版本，是 Linux 平台体验 Claude 能力的优质选择。","# Claude Desktop for Linux\n\nThis project provides build scripts to run Claude Desktop natively on Linux systems. It repackages the official Windows application for Linux distributions, producing `.deb` packages (Debian\u002FUbuntu), `.rpm` packages (Fedora\u002FRHEL), distribution-agnostic AppImages, an [AUR package](https:\u002F\u002Faur.archlinux.org\u002Fpackages\u002Fclaude-desktop-appimage) for Arch Linux, and a Nix flake for NixOS.\n\n**Note:** This is an unofficial build script. For official support, please visit [Anthropic's website](https:\u002F\u002Fwww.anthropic.com). For issues with the build script or Linux implementation, please [open an issue](https:\u002F\u002Fgithub.com\u002Faaddrick\u002Fclaude-desktop-debian\u002Fissues) in this repository.\n\n---\n\n> **⚠️ EXPERIMENTAL: Cowork Mode Support**\n> Cowork mode is **enabled by default** in this build with a pluggable isolation backend:\n>\n> | Backend | Isolation | Requirements |\n> |---------|-----------|-------------|\n> | **bubblewrap** (default) | Namespace sandbox | `bwrap` installed and functional |\n> | **host** (fallback) | None — runs directly on host | No additional requirements |\n>\n> The best available backend is auto-detected at startup. Run `claude-desktop --doctor` to check which backend will be used and which dependencies are missing.\n>\n> **Note:** The bubblewrap backend mounts your home directory as read-only (only the project working directory is writable). The host backend provides no isolation — use it only if you understand the security implications.\n>\n> **KVM status:** The KVM\u002FQEMU backend code exists but is non-functional — VM file downloads are disabled on Linux to prevent a checksum loop (#337). The backend code remains for potential future use.\n\n---\n\n## Features\n\n- **Native Linux Support**: Run Claude Desktop without virtualization or Wine\n- **MCP Support**: Full Model Context Protocol integration\n  Configuration file location: `~\u002F.config\u002FClaude\u002Fclaude_desktop_config.json`\n- **System Integration**:\n  - Global hotkey support (Ctrl+Alt+Space) - works on X11 and Wayland (via XWayland)\n  - System tray integration\n  - Desktop environment integration\n\n### Screenshots\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Faaddrick_claude-desktop-debian_readme_346158a6b392.png\" alt=\"Claude Desktop running on Linux\" \u002F>\n\u003C\u002Fp>\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Faaddrick_claude-desktop-debian_readme_f31a47767ab3.png\" alt=\"Global hotkey popup\" \u002F>\n\u003C\u002Fp>\n\n## Installation\n\n### Using APT Repository (Debian\u002FUbuntu - Recommended)\n\nAdd the repository for automatic updates via `apt`:\n\n```bash\n# Add the GPG key\ncurl -fsSL https:\u002F\u002Faaddrick.github.io\u002Fclaude-desktop-debian\u002FKEY.gpg | sudo gpg --dearmor -o \u002Fusr\u002Fshare\u002Fkeyrings\u002Fclaude-desktop.gpg\n\n# Add the repository\necho \"deb [signed-by=\u002Fusr\u002Fshare\u002Fkeyrings\u002Fclaude-desktop.gpg arch=amd64,arm64] https:\u002F\u002Faaddrick.github.io\u002Fclaude-desktop-debian stable main\" | sudo tee \u002Fetc\u002Fapt\u002Fsources.list.d\u002Fclaude-desktop.list\n\n# Update and install\nsudo apt update\nsudo apt install claude-desktop\n```\n\nFuture updates will be installed automatically with your regular system updates (`sudo apt upgrade`).\n\n### Using DNF Repository (Fedora\u002FRHEL - Recommended)\n\nAdd the repository for automatic updates via `dnf`:\n\n```bash\n# Add the repository\nsudo curl -fsSL https:\u002F\u002Faaddrick.github.io\u002Fclaude-desktop-debian\u002Frpm\u002Fclaude-desktop.repo -o \u002Fetc\u002Fyum.repos.d\u002Fclaude-desktop.repo\n\n# Install\nsudo dnf install claude-desktop\n```\n\nFuture updates will be installed automatically with your regular system updates (`sudo dnf upgrade`).\n\n### Using AUR (Arch Linux)\n\nThe [`claude-desktop-appimage`](https:\u002F\u002Faur.archlinux.org\u002Fpackages\u002Fclaude-desktop-appimage) package is available on the AUR and is automatically updated with each release.\n\n```bash\n# Using yay\nyay -S claude-desktop-appimage\n\n# Or using paru\nparu -S claude-desktop-appimage\n```\n\nThe AUR package installs the AppImage build of Claude Desktop.\n\n### Using Nix Flake (NixOS)\n\nInstall directly from the flake:\n\n```bash\n# Basic install\nnix profile install github:aaddrick\u002Fclaude-desktop-debian\n\n# With MCP server support (FHS environment)\nnix profile install github:aaddrick\u002Fclaude-desktop-debian#claude-desktop-fhs\n```\n\nOr add to your NixOS configuration:\n\n```nix\n# flake.nix\n{\n  inputs.claude-desktop.url = \"github:aaddrick\u002Fclaude-desktop-debian\";\n\n  outputs = { nixpkgs, claude-desktop, ... }: {\n    nixosConfigurations.myhost = nixpkgs.lib.nixosSystem {\n      modules = [\n        ({ pkgs, ... }: {\n          nixpkgs.overlays = [ claude-desktop.overlays.default ];\n          environment.systemPackages = [ pkgs.claude-desktop ];\n        })\n      ];\n    };\n  };\n}\n```\n\n### Using Pre-built Releases\n\nDownload the latest `.deb`, `.rpm`, or `.AppImage` from the [Releases page](https:\u002F\u002Fgithub.com\u002Faaddrick\u002Fclaude-desktop-debian\u002Freleases).\n\n### Building from Source\n\nSee [docs\u002FBUILDING.md](docs\u002FBUILDING.md) for detailed build instructions.\n\n## Configuration\n\nModel Context Protocol settings are stored in:\n```\n~\u002F.config\u002FClaude\u002Fclaude_desktop_config.json\n```\n\nFor additional configuration options including environment variables and Wayland support, see [docs\u002FCONFIGURATION.md](docs\u002FCONFIGURATION.md).\n\n## Troubleshooting\n\nRun `claude-desktop --doctor` for built-in diagnostics that check common issues (display server, sandbox permissions, MCP config, stale locks, and more). It also reports cowork mode readiness — which isolation backend will be used, and which dependencies (KVM, QEMU, vsock, socat, virtiofsd, bubblewrap) are installed or missing.\n\nFor additional troubleshooting, uninstallation instructions, and log locations, see [docs\u002FTROUBLESHOOTING.md](docs\u002FTROUBLESHOOTING.md).\n\n## Acknowledgments\n\nThis project was inspired by [k3d3's claude-desktop-linux-flake](https:\u002F\u002Fgithub.com\u002Fk3d3\u002Fclaude-desktop-linux-flake) and their [Reddit post](https:\u002F\u002Fwww.reddit.com\u002Fr\u002FClaudeAI\u002Fcomments\u002F1hgsmpq\u002Fi_successfully_ran_claude_desktop_natively_on\u002F) about running Claude Desktop natively on Linux.\n\nSpecial thanks to:\n- **k3d3** for the original NixOS implementation and native bindings insights\n- **[emsi](https:\u002F\u002Fgithub.com\u002Femsi\u002Fclaude-desktop)** for the title bar fix and alternative implementation approach\n- **[leobuskin](https:\u002F\u002Fgithub.com\u002Fleobuskin\u002Funofficial-claude-desktop-linux)** for the Playwright-based URL resolution approach\n- **[yarikoptic](https:\u002F\u002Fgithub.com\u002Fyarikoptic)** for codespell support and shellcheck compliance\n- **[IamGianluca](https:\u002F\u002Fgithub.com\u002FIamGianluca)** for build dependency check improvements\n- **[ing03201](https:\u002F\u002Fgithub.com\u002Fing03201)** for IBus\u002FFcitx5 input method support\n- **[ajescudero](https:\u002F\u002Fgithub.com\u002Fajescudero)** for pinning @electron\u002Fasar for Node compatibility\n- **[delorenj](https:\u002F\u002Fgithub.com\u002Fdelorenj)** for Wayland compatibility support\n- **[Regen-forest](https:\u002F\u002Fgithub.com\u002FRegen-forest)** for suggesting Gear Lever as AppImageLauncher replacement\n- **[niekvugteveen](https:\u002F\u002Fgithub.com\u002Fniekvugteveen)** for fixing Debian packaging permissions\n- **[speleoalex](https:\u002F\u002Fgithub.com\u002Fspeleoalex)** for native window decorations support\n- **[imaginalnika](https:\u002F\u002Fgithub.com\u002Fimaginalnika)** for moving logs to `~\u002F.cache\u002F`\n- **[richardspicer](https:\u002F\u002Fgithub.com\u002Frichardspicer)** for the menu bar visibility fix on Linux\n- **[jacobfrantz1](https:\u002F\u002Fgithub.com\u002Fjacobfrantz1)** for Claude Desktop code preview support and quick window submit fix\n- **[janfrederik](https:\u002F\u002Fgithub.com\u002Fjanfrederik)** for the `--exe` flag to use a local installer\n- **[MrEdwards007](https:\u002F\u002Fgithub.com\u002FMrEdwards007)** for discovering the OAuth token cache fix\n- **[lizthegrey](https:\u002F\u002Fgithub.com\u002Flizthegrey)** for version update contributions\n- **[mathys-lopinto](https:\u002F\u002Fgithub.com\u002Fmathys-lopinto)** for the AUR package and automated deployment\n- **[pkuijpers](https:\u002F\u002Fgithub.com\u002Fpkuijpers)** for root cause analysis of the RPM repo GPG signing issue\n- **[dlepold](https:\u002F\u002Fgithub.com\u002Fdlepold)** for identifying the tray icon variable name bug with a working fix\n- **[Voork1144](https:\u002F\u002Fgithub.com\u002FVoork1144)** for detailed analysis of the tray icon minifier bug, root-cause analysis of the Chromium layout cache bug, and the direct child `setBounds()` fix approach\n- **[sabiut](https:\u002F\u002Fgithub.com\u002Fsabiut)** for the `--doctor` diagnostic command and SHA-256 checksum validation for downloads\n- **[milog1994](https:\u002F\u002Fgithub.com\u002Fmilog1994)** for Linux UX improvements including popup detection, functional stubs, and Wayland compositor support\n- **[jarrodcolburn](https:\u002F\u002Fgithub.com\u002Fjarrodcolburn)** for passwordless sudo support in container\u002FCI environments, identifying the gh-pages 4GB bloat fix, identifying the virtiofsd PATH detection issue on Debian, detailed analysis of the CI release pipeline failure caused by runner kills during compare-releases, and diagnosing the session-start hook sudo blocking issue with three solution approaches\n- **[chukfinley](https:\u002F\u002Fgithub.com\u002Fchukfinley)** for experimental Cowork mode support on Linux\n- **[CyPack](https:\u002F\u002Fgithub.com\u002FCyPack)** for orphaned cowork daemon cleanup on startup\n- **[IliyaBrook](https:\u002F\u002Fgithub.com\u002FIliyaBrook)** for fixing the platform patch for Claude Desktop >= 1.1.3541 arm64 refactor\n- **[MichaelMKenny](https:\u002F\u002Fgithub.com\u002FMichaelMKenny)** for diagnosing the `$`-prefixed electron variable bug with root cause analysis and workaround\n- **[daa25209](https:\u002F\u002Fgithub.com\u002Fdaa25209)** for detailed root cause analysis of the cowork platform gate crash and patch script\n- **[noctuum](https:\u002F\u002Fgithub.com\u002Fnoctuum)** for the `CLAUDE_MENU_BAR` env var with configurable menu bar visibility and boolean alias support\n- **[typedrat](https:\u002F\u002Fgithub.com\u002Ftypedrat)** for the NixOS flake integration with build.sh, node-pty derivation, CI auto-update, and fixing the flake package scoping regression\n- **[cbonnissent](https:\u002F\u002Fgithub.com\u002Fcbonnissent)** for reverse-engineering the Cowork VM guest RPC protocol, fixing the KVM startup blocker, and fixing RPC response id echoing for persistent connections\n- **[joekale-pp](https:\u002F\u002Fgithub.com\u002Fjoekale-pp)** for adding `--doctor` support to the RPM launcher\n- **[ecrevisseMiroir](https:\u002F\u002Fgithub.com\u002FecrevisseMiroir)** for the bwrap backend sandbox isolation with tmpfs-based minimal root\n- **[arauhala](https:\u002F\u002Fgithub.com\u002Farauhala)** for detailed root cause analysis of the NixOS `isPackaged` regression\n- **[cromagnone](https:\u002F\u002Fgithub.com\u002Fcromagnone)** for confirming the VM download loop on bwrap installs with detailed logs that disproved the initial triage\n- **[aHk-coder](https:\u002F\u002Fgithub.com\u002FaHk-coder)** for diagnosing the hardcoded minified variable crash in the cowork smol-bin patch\n- **[RayCharlizard](https:\u002F\u002Fgithub.com\u002FRayCharlizard)** for detailed analysis of the self-referential `.mcpb-cache` symlink ELOOP bug\n- **[reinthal](https:\u002F\u002Fgithub.com\u002Freinthal)** for fixing the NixOS build breakage caused by the nixpkgs `nodePackages` removal\n- **[gianluca-peri](https:\u002F\u002Fgithub.com\u002Fgianluca-peri)** for reporting the GNOME quit accessibility issue and confirming tray behavior with AppIndicator\n\n## Sponsorship\n\nAnthropic doesn't publish release notes for Claude Desktop. Each release here includes AI-generated notes that analyze code changes between versions. I wrote up how that process works if you're curious: [Generating Real Release Notes from Minified Electron Apps](https:\u002F\u002Fnonconvexlabs.com\u002Fblog\u002Fgenerating-real-release-notes-from-minified-electron-apps).\n\nThe analysis runs against Claude's API. Costs vary a lot depending on how big the update is. Recent releases have run between **$3.36 and $76.16 per release**.\n\nIf this project is useful to you, consider [sponsoring on GitHub](https:\u002F\u002Fgithub.com\u002Fsponsors\u002Faaddrick) to help cover those costs.\n\n## License\n\nThe build scripts in this repository are dual-licensed under:\n- MIT License (see [LICENSE-MIT](LICENSE-MIT))\n- Apache License 2.0 (see [LICENSE-APACHE](LICENSE-APACHE))\n\nThe Claude Desktop application itself is subject to [Anthropic's Consumer Terms](https:\u002F\u002Fwww.anthropic.com\u002Flegal\u002Fconsumer-terms).\n\n## Contributing\n\nContributions are welcome! By submitting a contribution, you agree to license it under the same dual-license terms as this project.\n","# Claude Desktop for Linux\n\n本项目提供构建脚本，可在 Linux 系统上原生运行 Claude Desktop。它将官方 Windows 应用程序重新打包为适用于 Linux 发行版的软件包，生成 `.deb` 包（Debian\u002FUbuntu）、`.rpm` 包（Fedora\u002FRHEL）、与发行版无关的 AppImage、一个用于 Arch Linux 的 [AUR 软件包](https:\u002F\u002Faur.archlinux.org\u002Fpackages\u002Fclaude-desktop-appimage)，以及一个用于 NixOS 的 Nix Flake。\n\n**注意：** 这是一个非官方的构建脚本。如需官方支持，请访问 [Anthropic 官网](https:\u002F\u002Fwww.anthropic.com)。如遇到构建脚本或 Linux 实现方面的问题，请在此仓库中[提交问题](https:\u002F\u002Fgithub.com\u002Faaddrick\u002Fclaude-desktop-debian\u002Fissues)。\n\n---\n\n> **⚠️ 实验性功能：协作模式支持**\n>\n> 本构建版本默认启用协作模式，并采用可插拔的隔离后端：\n>\n> | 后端       | 隔离方式     | 要求                     |\n> |------------|--------------|--------------------------|\n> | **bubblewrap**（默认） | 命名空间沙箱 | 已安装且可用的 `bwrap`   |\n> | **host**（回退）    | 无 — 直接在主机上运行 | 无额外要求               |\n>\n> 启动时会自动检测并选择最佳可用后端。运行 `claude-desktop --doctor` 可检查将使用哪个后端以及缺少哪些依赖项。\n>\n> **注意：** bubblewrap 后端会将您的主目录挂载为只读（仅项目工作目录可写）。host 后端不提供任何隔离——请仅在充分了解其安全影响的情况下使用。\n>\n> **KVM 状态：** KVM\u002FQEMU 后端代码已存在，但目前无法正常工作——为避免校验和循环问题，Linux 上已禁用虚拟机文件下载（#337）。该后端代码仍保留，以备未来可能使用。\n\n---\n\n## 功能特性\n\n- **原生 Linux 支持**：无需虚拟化或 Wine 即可运行 Claude Desktop\n- **MCP 支持**：完整集成模型上下文协议\n  配置文件位置：`~\u002F.config\u002FClaude\u002Fclaude_desktop_config.json`\n- **系统集成**：\n  - 全局热键支持（Ctrl+Alt+Space）——在 X11 和 Wayland（通过 XWayland）下均可用\n  - 系统托盘集成\n  - 桌面环境集成\n\n### 截图\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Faaddrick_claude-desktop-debian_readme_346158a6b392.png\" alt=\"Claude Desktop 在 Linux 上运行\" \u002F>\n\u003C\u002Fp>\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Faaddrick_claude-desktop-debian_readme_f31a47767ab3.png\" alt=\"全局热键弹出窗口\" \u002F>\n\u003C\u002Fp>\n\n## 安装方法\n\n### 使用 APT 仓库（推荐：Debian\u002FUbuntu）\n\n添加仓库以便通过 `apt` 自动更新：\n\n```bash\n# 添加 GPG 密钥\ncurl -fsSL https:\u002F\u002Faaddrick.github.io\u002Fclaude-desktop-debian\u002FKEY.gpg | sudo gpg --dearmor -o \u002Fusr\u002Fshare\u002Fkeyrings\u002Fclaude-desktop.gpg\n\n# 添加仓库\necho \"deb [signed-by=\u002Fusr\u002Fshare\u002Fkeyrings\u002Fclaude-desktop.gpg arch=amd64,arm64] https:\u002F\u002Faaddrick.github.io\u002Fclaude-desktop-debian stable main\" | sudo tee \u002Fetc\u002Fapt\u002Fsources.list.d\u002Fclaude-desktop.list\n\n# 更新并安装\nsudo apt update\nsudo apt install claude-desktop\n```\n\n未来的更新将随您常规的系统更新（`sudo apt upgrade`）自动安装。\n\n### 使用 DNF 仓库（推荐：Fedora\u002FRHEL）\n\n添加仓库以便通过 `dnf` 自动更新：\n\n```bash\n# 添加仓库\nsudo curl -fsSL https:\u002F\u002Faaddrick.github.io\u002Fclaude-desktop-debian\u002Frpm\u002Fclaude-desktop.repo -o \u002Fetc\u002Fyum.repos.d\u002Fclaude-desktop.repo\n\n# 安装\nsudo dnf install claude-desktop\n```\n\n未来的更新也将随您常规的系统更新（`sudo dnf upgrade`）自动安装。\n\n### 使用 AUR（Arch Linux）\n\nAUR 中提供了 [`claude-desktop-appimage`](https:\u002F\u002Faur.archlinux.org\u002Fpackages\u002Fclaude-desktop-appimage) 软件包，每次发布时都会自动更新。\n\n```bash\n# 使用 yay\nyay -S claude-desktop-appimage\n\n# 或使用 paru\nparu -S claude-desktop-appimage\n```\n\n该 AUR 软件包会安装 Claude Desktop 的 AppImage 版本。\n\n### 使用 Nix Flake（NixOS）\n\n可以直接从 flake 安装：\n\n```bash\n# 基本安装\nnix profile install github:aaddrick\u002Fclaude-desktop-debian\n\n# 含 MCP 服务器支持（FHS 环境）\nnix profile install github:aaddrick\u002Fclaude-desktop-debian#claude-desktop-fhs\n```\n\n或者将其添加到您的 NixOS 配置中：\n\n```nix\n# flake.nix\n{\n  inputs.claude-desktop.url = \"github:aaddrick\u002Fclaude-desktop-debian\";\n\n  outputs = { nixpkgs, claude-desktop, ... }: {\n    nixosConfigurations.myhost = nixpkgs.lib.nixosSystem {\n      modules = [\n        ({ pkgs, ... }: {\n          nixpkgs.overlays = [ claude-desktop.overlays.default ];\n          environment.systemPackages = [ pkgs.claude-desktop ];\n        })\n      ];\n    };\n  };\n}\n```\n\n### 使用预编译的发布包\n\n从 [Releases 页面](https:\u002F\u002Fgithub.com\u002Faaddrick\u002Fclaude-desktop-debian\u002Freleases)下载最新的 `.deb`、`.rpm` 或 `.AppImage` 文件。\n\n### 从源码构建\n\n详细构建步骤请参阅 [docs\u002FBUILDING.md](docs\u002FBUILDING.md)。\n\n## 配置\n\n模型上下文协议的设置存储于：\n```\n~\u002F.config\u002FClaude\u002Fclaude_desktop_config.json\n```\n\n有关包括环境变量和 Wayland 支持在内的更多配置选项，请参阅 [docs\u002FCONFIGURATION.md](docs\u002FCONFIGURATION.md)。\n\n## 故障排除\n\n运行 `claude-desktop --doctor` 可执行内置诊断，检查常见问题（显示服务器、沙箱权限、MCP 配置、过期锁等）。它还会报告协作模式的准备情况——将使用哪种隔离后端，以及哪些依赖项（KVM、QEMU、vsock、socat、virtiofsd、bubblewrap）已安装或缺失。\n\n有关更多故障排除信息、卸载说明及日志位置，请参阅 [docs\u002FTROUBLESHOOTING.md](docs\u002FTROUBLESHOOTING.md)。\n\n## 致谢\n\n本项目受到 [k3d3 的 claude-desktop-linux-flake](https:\u002F\u002Fgithub.com\u002Fk3d3\u002Fclaude-desktop-linux-flake) 以及他们关于在 Linux 上原生运行 Claude Desktop 的 [Reddit 帖子](https:\u002F\u002Fwww.reddit.com\u002Fr\u002FClaudeAI\u002Fcomments\u002F1hgsmpq\u002Fi_successfully_ran_claude_desktop_natively_on\u002F) 的启发。\n\n特别感谢：\n- **k3d3** 提供了最初的 NixOS 实现和原生绑定方面的见解\n- **[emsi](https:\u002F\u002Fgithub.com\u002Femsi\u002Fclaude-desktop)** 修复了标题栏问题并提出了替代实现方案\n- **[leobuskin](https:\u002F\u002Fgithub.com\u002Fleobuskin\u002Funofficial-claude-desktop-linux)** 采用了基于 Playwright 的 URL 解析方法\n- **[yarikoptic](https:\u002F\u002Fgithub.com\u002Fyarikoptic)** 支持 codespell 检查和 shellcheck 规范\n- **[IamGianluca](https:\u002F\u002Fgithub.com\u002FIamGianluca)** 改进了构建依赖检查\n- **[ing03201](https:\u002F\u002Fgithub.com\u002Fing03201)** 添加了 IBus\u002FFcitx5 输入法支持\n- **[ajescudero](https:\u002F\u002Fgithub.com\u002Fajescudero)** 锁定了 @electron\u002Fasar 以确保与 Node.js 兼容\n- **[delorenj](https:\u002F\u002Fgithub.com\u002Fdelorenj)** 提供了 Wayland 兼容性支持\n- **[Regen-forest](https:\u002F\u002Fgithub.com\u002FRegen-forest)** 建议使用 Gear Lever 替代 AppImageLauncher\n- **[niekvugteveen](https:\u002F\u002Fgithub.com\u002Fniekvugteveen)** 修复了 Debian 打包权限问题\n- **[speleoalex](https:\u002F\u002Fgithub.com\u002Fspeleoalex)** 支持原生窗口装饰\n- **[imaginalnika](https:\u002F\u002Fgithub.com\u002Fimaginalnika)** 将日志移动到 `~\u002F.cache\u002F`\n- **[richardspicer](https:\u002F\u002Fgithub.com\u002Frichardspicer)** 修复了 Linux 上菜单栏的可见性问题\n- **[jacobfrantz1](https:\u002F\u002Fgithub.com\u002Fjacobfrantz1)** 支持 Claude Desktop 代码预览，并修复了快速提交窗口的问题\n- **[janfrederik](https:\u002F\u002Fgithub.com\u002Fjanfrederik)** 添加了 `--exe` 标志，以便使用本地安装程序\n- **[MrEdwards007](https:\u002F\u002Fgithub.com\u002FMrEdwards007)** 发现了 OAuth 令牌缓存的修复方法\n- **[lizthegrey](https:\u002F\u002Fgithub.com\u002Flizthegrey)** 贡献了版本更新内容\n- **[mathys-lopinto](https:\u002F\u002Fgithub.com\u002Fmathys-lopinto)** 创建了 AUR 包并实现了自动化部署\n- **[pkuijpers](https:\u002F\u002Fgithub.com\u002Fpkuijpers)** 分析了 RPM 仓库 GPG 签名问题的根本原因\n- **[dlepold](https:\u002F\u002Fgithub.com\u002Fdlepold)** 识别并修复了托盘图标变量名错误\n- **[Voork1144](https:\u002F\u002Fgithub.com\u002FVoork1144)** 对托盘图标压缩工具中的错误进行了详细分析，找到了 Chromium 布局缓存错误的根本原因，并提出了直接调用 `setBounds()` 方法来解决问题\n- **[sabiut](https:\u002F\u002Fgithub.com\u002Fsabiut)** 添加了 `--doctor` 诊断命令，并对下载文件进行 SHA-256 校验\n- **[milog1994](https:\u002F\u002Fgithub.com\u002Fmilog1994)** 改进了 Linux 用户体验，包括弹出窗口检测、功能桩代码以及 Wayland 合成器支持\n- **[jarrodcolburn](https:\u002F\u002Fgithub.com\u002Fjarrodcolburn)** 在容器\u002FCI 环境中支持无密码 sudo，发现了 gh-pages 4GB 冗余的修复方法，识别了 Debian 上 virtiofsd PATH 检测问题，详细分析了 CI 发布流水线因 runner 被终止而导致 compare-releases 失败的原因，并提出了三种解决会话启动钩子阻止 sudo 的方案\n- **[chukfinley](https:\u002F\u002Fgithub.com\u002Fchukfinley)** 在 Linux 上实验性地支持 Cowork 模式\n- **[CyPack](https:\u002F\u002Fgithub.com\u002FCyPack)** 在启动时清理了孤立的 cowork 守护进程\n- **[IliyaBrook](https:\u002F\u002Fgithub.com\u002FIliyaBrook)** 修复了 Claude Desktop >= 1.1.3541 arm64 架构的平台补丁重构问题\n- **[MichaelMKenny](https:\u002F\u002Fgithub.com\u002FMichaelMKenny)** 诊断了以 `$` 开头的 electron 变量错误，并给出了根本原因分析及 workaround\n- **[daa25209](https:\u002F\u002Fgithub.com\u002Fdaa25209)** 对 cowork 平台闸门崩溃问题及其补丁脚本进行了详细的根因分析\n- **[noctuum](https:\u002F\u002Fgithub.com\u002Fnoctuum)** 引入了 `CLAUDE_MENU_BAR` 环境变量，支持可配置的菜单栏可见性和布尔别名\n- **[typedrat](https:\u002F\u002Fgithub.com\u002Ftypedrat)** 将 NixOS flake 与 build.sh 集成，添加了 node-pty 衍生、CI 自动更新功能，并修复了 flake 包作用域回归问题\n- **[cbonnissent](https:\u002F\u002Fgithub.com\u002Fcbonnissent)** 反向工程了 Cowork VM 客户端 RPC 协议，修复了 KVM 启动阻塞问题，并解决了持久连接中 RPC 响应 ID 回显的问题\n- **[joekale-pp](https:\u002F\u002Fgithub.com\u002Fjoekale-pp)** 为 RPM 启动器添加了 `--doctor` 支持\n- **[ecrevisseMiroir](https:\u002F\u002Fgithub.com\u002FecrevisseMiroir)** 提供了 bwrap 后端沙箱隔离功能，采用基于 tmpfs 的最小化 root 文件系统\n- **[arauhala](https:\u002F\u002Fgithub.com\u002Farauhala)** 对 NixOS `isPackaged` 回归问题进行了详细根因分析\n- **[cromagnone](https:\u002F\u002Fgithub.com\u002Fcromagnone)** 通过详细日志证实了 bwrap 安装中的 VM 下载循环问题，推翻了最初的初步判断\n- **[aHk-coder](https:\u002F\u002Fgithub.com\u002FaHk-coder)** 诊断了 cowork smol-bin 补丁中硬编码的压缩变量导致的崩溃问题\n- **[RayCharlizard](https:\u002F\u002Fgithub.com\u002FRayCharlizard)** 对自引用 `.mcpb-cache` 符号链接 ELOOP 错误进行了详细分析\n- **[reinthal](https:\u002F\u002Fgithub.com\u002Freinthal)** 修复了因 nixpkgs 移除 `nodePackages` 导致的 NixOS 构建中断问题\n- **[gianluca-peri](https:\u002F\u002Fgithub.com\u002Fgianluca-peri)** 报告了 GNOME 退出时的无障碍问题，并确认了使用 AppIndicator 的托盘行为\n\n## 赞助\nAnthropic 并不发布 Claude Desktop 的发行说明。此处的每次发布都包含由 AI 生成的注释，用于分析版本之间的代码变更。如果您感兴趣，可以阅读我撰写的关于该流程的文章：[从压缩的 Electron 应用程序中生成真实的发行说明](https:\u002F\u002Fnonconvexlabs.com\u002Fblog\u002Fgenerating-real-release-notes-from-minified-electron-apps)。\n\n该分析是通过 Claude 的 API 运行的。费用会根据更新的大小有很大差异。最近几次发布的费用介于 **每版 3.36 美元到 76.16 美元** 之间。\n\n如果这个项目对您有所帮助，请考虑在 [GitHub 上赞助](https:\u002F\u002Fgithub.com\u002Fsponsors\u002Faaddrick)，以帮助支付这些成本。\n\n## 许可证\n本仓库中的构建脚本采用双重许可：\n- MIT 许可证（参见 [LICENSE-MIT](LICENSE-MIT)）\n- Apache 2.0 许可证（参见 [LICENSE-APACHE](LICENSE-APACHE)）\n\n而 Claude Desktop 应用程序本身则受 [Anthropic 的消费者条款](https:\u002F\u002Fwww.anthropic.com\u002Flegal\u002Fconsumer-terms) 约束。\n\n## 贡献\n欢迎贡献！通过提交贡献，即表示您同意将其按照与本项目相同的双重许可条款进行授权。","# Claude Desktop for Linux 快速上手指南\n\n本指南帮助你在 Debian\u002FUbuntu、Fedora\u002FRHEL、Arch Linux 或 NixOS 系统上原生运行 Claude Desktop。该项目通过重新打包官方 Windows 应用，提供 `.deb`、`.rpm`、AppImage 等多种格式支持。\n\n> **注意**：这是一个非官方构建脚本。如遇构建或 Linux 实现问题，请在原仓库提交 Issue。\n\n## 环境准备\n\n### 系统要求\n- **架构**：amd64 (x86_64) 或 arm64\n- **发行版**：\n  - Debian \u002F Ubuntu (推荐 apt 源)\n  - Fedora \u002F RHEL (推荐 dnf 源)\n  - Arch Linux (通过 AUR)\n  - NixOS (通过 Flake)\n- **显示服务器**：支持 X11 或 Wayland (通过 XWayland)\n\n### 前置依赖\n大多数安装方式会自动处理依赖。若需手动检查环境或排查沙箱权限问题，可运行以下诊断命令：\n\n```bash\nclaude-desktop --doctor\n```\n\n该命令将检测显示服务器、沙箱后端（bubblewrap\u002Fhost）、MCP 配置及缺失的依赖项。\n\n## 安装步骤\n\n请根据你的 Linux 发行版选择对应的安装方式。\n\n### 方案一：Debian \u002F Ubuntu (推荐)\n\n通过添加 APT 仓库实现自动更新：\n\n```bash\n# 1. 添加 GPG 密钥\ncurl -fsSL https:\u002F\u002Faaddrick.github.io\u002Fclaude-desktop-debian\u002FKEY.gpg | sudo gpg --dearmor -o \u002Fusr\u002Fshare\u002Fkeyrings\u002Fclaude-desktop.gpg\n\n# 2. 添加软件源\necho \"deb [signed-by=\u002Fusr\u002Fshare\u002Fkeyrings\u002Fclaude-desktop.gpg arch=amd64,arm64] https:\u002F\u002Faaddrick.github.io\u002Fclaude-desktop-debian stable main\" | sudo tee \u002Fetc\u002Fapt\u002Fsources.list.d\u002Fclaude-desktop.list\n\n# 3. 更新并安装\nsudo apt update\nsudo apt install claude-desktop\n```\n\n### 方案二：Fedora \u002F RHEL (推荐)\n\n通过添加 DNF 仓库实现自动更新：\n\n```bash\n# 1. 添加软件源\nsudo curl -fsSL https:\u002F\u002Faaddrick.github.io\u002Fclaude-desktop-debian\u002Frpm\u002Fclaude-desktop.repo -o \u002Fetc\u002Fyum.repos.d\u002Fclaude-desktop.repo\n\n# 2. 安装\nsudo dnf install claude-desktop\n```\n\n### 方案三：Arch Linux\n\n使用 AUR 助手（如 `yay` 或 `paru`）安装 AppImage 版本：\n\n```bash\n# 使用 yay\nyay -S claude-desktop-appimage\n\n# 或使用 paru\nparu -S claude-desktop-appimage\n```\n\n### 方案四：NixOS\n\n直接通过 Flake 安装：\n\n```bash\n# 基础安装\nnix profile install github:aaddrick\u002Fclaude-desktop-debian\n\n# 包含 MCP 服务器支持 (FHS 环境)\nnix profile install github:aaddrick\u002Fclaude-desktop-debian#claude-desktop-fhs\n```\n\n### 方案五：通用安装 (AppImage\u002F包文件)\n\n访问 [Releases 页面](https:\u002F\u002Fgithub.com\u002Faaddrick\u002Fclaude-desktop-debian\u002Freleases) 下载最新的 `.deb`、`.rpm` 或 `.AppImage` 文件进行手动安装。\n\n## 基本使用\n\n### 启动应用\n安装完成后，直接在终端输入以下命令启动：\n\n```bash\nclaude-desktop\n```\n\n或在应用程序菜单中搜索 \"Claude Desktop\" 点击启动。\n\n### 核心功能\n- **全局快捷键**：默认使用 `Ctrl+Alt+Space` 唤起窗口（支持 X11 和 Wayland）。\n- **系统托盘**：最小化后将在系统托盘显示图标。\n- **MCP 支持**：完整集成 Model Context Protocol。\n\n### 配置文件\nMCP 及相关设置存储在以下位置：\n```\n~\u002F.config\u002FClaude\u002Fclaude_desktop_config.json\n```\n\n### 实验性功能：Cowork 模式\n当前版本默认启用 Cowork 模式，并自动选择最佳隔离后端：\n- **bubblewrap (默认)**：提供命名空间沙箱隔离（家目录只读，仅项目工作目录可写）。需安装 `bwrap`。\n- **host (降级方案)**：无隔离，直接在宿主机运行。仅在了解安全风险时使用。\n\n运行 `claude-desktop --doctor` 可查看当前使用的后端及依赖状态。","一位基于 Ubuntu 的资深后端工程师，日常需要在本地 Linux 环境中高频调用 Claude 进行代码重构与上下文分析，同时依赖 MCP 协议连接本地数据库工具。\n\n### 没有 claude-desktop-debian 时\n- **运行环境割裂**：被迫使用 Wine 模拟或启动沉重的虚拟机来运行 Windows 版客户端，导致系统资源占用高且界面渲染卡顿。\n- **功能集成缺失**：无法使用全局快捷键（Ctrl+Alt+Space）快速唤起助手，每次交互都需手动切换窗口，严重打断编程心流。\n- **高级协议受限**：缺乏原生的 Model Context Protocol (MCP) 支持，难以让 AI 直接读取本地配置文件或安全地调用外部开发工具。\n- **维护成本高昂**：非官方方案更新滞后，每次新版发布都需要手动重新配置环境，且存在潜在的安全隔离风险。\n\n### 使用 claude-desktop-debian 后\n- **原生流畅体验**：通过 APT 仓库一键安装原生 `.deb` 包，应用启动秒开，完美融入 GNOME 或 KDE 桌面环境，资源占用极低。\n- **无感高效交互**：全局热键在 X11 和 Wayland 下均能稳定触发，随时呼出悬浮窗进行代码问答，保持屏幕焦点不离开编辑器。\n- **生态深度打通**：原生支持 MCP 协议，可轻松配置 `claude_desktop_config.json`，让 AI 安全地索引本地项目文件并执行复杂任务。\n- **自动持续迭代**：纳入系统包管理器管理，随 `sudo apt upgrade` 自动获取最新功能与安全补丁，内置的 bubblewrap 沙箱机制进一步保障了主机安全。\n\nclaude-desktop-debian 将原本割裂的 AI 辅助流程转化为 Linux 开发者的原生本能，实现了从“勉强能用”到“无缝融合”的效率飞跃。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Faaddrick_claude-desktop-debian_346158a6.png","aaddrick","Aaddrick","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002Faaddrick_9a435e4c.jpg",null,"Ottawa, Ontario","aaddrick@gmail.com","https:\u002F\u002Fgithub.com\u002Faaddrick",[84,88,92,96],{"name":85,"color":86,"percentage":87},"Shell","#89e051",75.3,{"name":89,"color":90,"percentage":91},"JavaScript","#f1e05a",20.5,{"name":93,"color":94,"percentage":95},"Nix","#7e7eff",2.6,{"name":97,"color":98,"percentage":99},"Python","#3572A5",1.6,3109,357,"2026-04-11T11:25:33","Apache-2.0","Linux","未说明",{"notes":107,"python":105,"dependencies":108},"这是一个非官方构建脚本，旨在将 Windows 版的 Claude Desktop 重新打包以在 Linux 上原生运行。支持 Debian\u002FUbuntu (.deb)、Fedora\u002FRHEL (.rpm)、Arch Linux (AUR) 和 NixOS。默认启用实验性的 'Cowork Mode'，首选 'bubblewrap' 作为沙盒后端（需安装 bwrap），若不可用则回退到无隔离的 'host' 模式。KVM\u002FQEMU 后端代码存在但在 Linux 上目前不可用。配置文件的默认路径为 ~\u002F.config\u002FClaude\u002Fclaude_desktop_config.json。支持全局快捷键 (Ctrl+Alt+Space) 和系统托盘。可使用 'claude-desktop --doctor' 命令诊断环境和依赖问题。",[109,110,111],"bubblewrap (可选，用于沙盒隔离)","X11 或 Wayland (含 XWayland)","systemd (隐含，用于桌面集成)",[15,25],"2026-03-27T02:49:30.150509","2026-04-11T23:23:56.429110",[116,121,126,131,136,141],{"id":117,"question_zh":118,"answer_zh":119,"source_url":120},30118,"Cowork 模式启动失败，提示缺少 qcow2 文件或 VM 镜像未下载怎么办？","该问题通常是因为默认尝试使用 KVM\u002FQEMU 后端但镜像未正确下载或路径配置错误。解决方案是改用 bubblewrap 作为隔离后端，它在 Linux 桌面上启动更快且资源消耗更少。\n\n具体步骤：\n1. 运行 `claude desktop --doctor` 检查当前状态，如果显示 'VM image: not downloaded yet' 且 'Cowork isolation: bubblewrap'，说明环境已就绪但未强制使用。\n2. 如果之前强制使用了 kvm 后端导致失败，建议完全移除 qemu、socat 等相关包。\n3. 确保环境变量未强制指定 kvm 后端，让程序自动回退到 bubblewrap。\n4. 注意：bubblewrap 是 Linux 桌面的更优选择，无需手动复制镜像文件即可瞬间启动。","https:\u002F\u002Fgithub.com\u002Faaddrick\u002Fclaude-desktop-debian\u002Fissues\u002F288",{"id":122,"question_zh":123,"answer_zh":124,"source_url":125},30119,"Google 登录时加载 spinner 无限旋转，无法弹出登录窗口如何解决？","这通常是由浏览器扩展（特别是隐私保护类扩展）拦截了登录请求导致的。\n\n解决方案：\n1. 检查是否安装了 \"Facebook Container\" 或其他类似的容器\u002F隐私扩展。\n2. 将 `claude.ai` 和 `accounts.google.com` 添加到该扩展的允许列表（白名单）中。\n3. 刷新页面或重启应用后再次尝试点击 Google 登录按钮。\n\n注意：即使是在 macOS 或其他系统上出现此症状，原因也往往是相同的扩展干扰问题。","https:\u002F\u002Fgithub.com\u002Faaddrick\u002Fclaude-desktop-debian\u002Fissues\u002F121",{"id":127,"question_zh":128,"answer_zh":129,"source_url":130},30120,"应用程序启动后顶部标题栏缺失（如汉堡菜单、最小化\u002F最大化按钮看不见）怎么办？","这是由于 Electron 窗口框架渲染问题导致的，特别是在 Ubuntu 等 Linux 发行版上。\n\n解决方案：\n1. 该问题已通过引入 @emsi 的窗口修复脚本解决。\n2. 用户需要拉取包含修复补丁的最新版本脚本（参考 https:\u002F\u002Fgithub.com\u002Femsi\u002Fclaude-desktop\u002Ftree\u002Fmain）。\n3. 重新运行安装或更新脚本，确保应用了针对窗口资产（assets）和框架设置的补丁。\n4. 如果仍然缺失部分图标（如关闭、最小化按钮），可能需要等待后续的资产文件补丁更新。","https:\u002F\u002Fgithub.com\u002Faaddrick\u002Fclaude-desktop-debian\u002Fissues\u002F45",{"id":132,"question_zh":133,"answer_zh":134,"source_url":135},30121,"在 Linux Mint (Cinnamon) 上如何隐藏 Electron 应用的顶部菜单栏？","在 Linux Mint 的 Cinnamon 桌面环境下，即使修改了 Electron 启动参数，原生菜单栏（File\u002FEdit\u002FAbout）可能仍然可见。\n\n目前的情况：\n1. 标准的 Electron 隐藏菜单栏标志在该特定桌面环境下可能失效。\n2. 这是一个已知的环境兼容性问题，通常需要针对特定 WM（窗口管理器）进行额外的配置或使用补丁脚本来强制移除菜单栏。\n3. 建议检查项目最新的 frame-fix-wrapper 脚本更新，看是否包含针对 Cinnamon 桌面的特定修复逻辑。","https:\u002F\u002Fgithub.com\u002Faaddrick\u002Fclaude-desktop-debian\u002Fissues\u002F172",{"id":137,"question_zh":138,"answer_zh":139,"source_url":140},30122,"为什么快速入口（Quick Entry）弹窗会被错误识别或导致窗口调整大小闪烁？","旧版本的修复脚本通过判断窗口像素尺寸（如宽\u003C600 或高\u003C400）来检测弹窗，这种方法非常脆弱，容易误判普通小窗口或受缩放影响的窗口。\n\n解决方案已在最新补丁中实施：\n1. 不再依赖魔法数字（像素值），而是检查应用的 `frame: false` 设置或 `titleBarStyle` 属性作为主要信号。\n2. 对于 Wayland 兼容性，将 `setImmediate` 替换为 `setTimeout(fn, 50)`，给合成器足够时间处理调整大小事件，避免无操作或闪烁。\n3. 增加了对已销毁或不可见窗口的过滤，防止在错误的窗口上调用 `flashFrame()` 导致崩溃。","https:\u002F\u002Fgithub.com\u002Faaddrick\u002Fclaude-desktop-debian\u002Fissues\u002F231",{"id":142,"question_zh":143,"answer_zh":144,"source_url":140},30123,"如何在 Debian\u002FUbuntu 上彻底解决 BrowserWindow 拦截失效的问题？","根本原因是 Electron 的模块导出使用了不可配置的 getter (`configurable: false`)，导致直接赋值 `module.BrowserWindow = PatchedClass` 静默失败。\n\n最终解决方案：\n1. 使用基于 Proxy 的拦截技术：让 `require('electron')` 返回一个 Proxy 对象，在属性访问时动态替换 `BrowserWindow` 类，从而绕过只读 getter 限制。\n2. 移除了之前构建脚本中粗暴的 sed 补丁（直接修改源码中的 `frame:false`），因为该方法无法区分主窗口和弹窗。\n3. 运行时通过检测 `minWidth` 属性（主窗口有最小宽度限制，弹窗没有）来准确区分窗口类型并应用相应的修复逻辑。",[146,151,156,161,166,171,176,181,186,191,196,201,206,211,216,221,226,231,236,241],{"id":147,"version":148,"summary_zh":149,"released_at":150},213296,"v1.3.27+claude1.1617.0","## Claude Desktop 更新\n\n此版本将打包的 Claude Desktop 更新至 **1.1617.0**。\n\n### 变更内容\n- 将 Claude Desktop 更新至 1.1617.0 版本\n\n---\n\n## 安装\n\n### APT（Debian\u002FUbuntu）\n\n```bash\n# 第一次使用？添加仓库：\ncurl -fsSL https:\u002F\u002Faaddrick.github.io\u002Fclaude-desktop-debian\u002FKEY.gpg | sudo gpg --dearmor -o \u002Fusr\u002Fshare\u002Fkeyrings\u002Fclaude-desktop.gpg\necho \"deb [signed-by=\u002Fusr\u002Fshare\u002Fkeyrings\u002Fclaude-desktop.gpg arch=amd64,arm64] https:\u002F\u002Faaddrick.github.io\u002Fclaude-desktop-debian stable main\" | sudo tee \u002Fetc\u002Fapt\u002Fsources.list.d\u002Fclaude-desktop.list\n\n# 安装或更新：\nsudo apt update && sudo apt install claude-desktop\n```\n\n### DNF（Fedora\u002FRHEL）\n\n```bash\n# 第一次使用？添加仓库：\nsudo curl -fsSL https:\u002F\u002Faaddrick.github.io\u002Fclaude-desktop-debian\u002Frpm\u002Fclaude-desktop.repo -o \u002Fetc\u002Fyum.repos.d\u002Fclaude-desktop.repo\n\n# 安装或更新：\nsudo dnf install claude-desktop\n```\n\n### AUR（Arch Linux）\n\n```bash\nyay -S claude-desktop-appimage\n```\n\n### 手动下载\n\n从下方资源中下载 `.deb`、`.rpm` 或 `.AppImage` 文件。","2026-04-10T01:45:38",{"id":152,"version":153,"summary_zh":154,"released_at":155},213297,"v1.3.27+claude1.1348.0","## Claude Desktop 更新\n\n此版本将打包的 Claude Desktop 更新至 **1.1348.0**。\n\n### 变更内容\n- 将 Claude Desktop 更新至 1.1348.0 版本\n\n---\n\n## 安装\n\n### APT (Debian\u002FUbuntu)\n\n```bash\n# 首次使用？添加仓库：\ncurl -fsSL https:\u002F\u002Faaddrick.github.io\u002Fclaude-desktop-debian\u002FKEY.gpg | sudo gpg --dearmor -o \u002Fusr\u002Fshare\u002Fkeyrings\u002Fclaude-desktop.gpg\necho \"deb [signed-by=\u002Fusr\u002Fshare\u002Fkeyrings\u002Fclaude-desktop.gpg arch=amd64,arm64] https:\u002F\u002Faaddrick.github.io\u002Fclaude-desktop-debian stable main\" | sudo tee \u002Fetc\u002Fapt\u002Fsources.list.d\u002Fclaude-desktop.list\n\n# 安装或更新：\nsudo apt update && sudo apt install claude-desktop\n```\n\n### DNF (Fedora\u002FRHEL)\n\n```bash\n# 首次使用？添加仓库：\nsudo curl -fsSL https:\u002F\u002Faaddrick.github.io\u002Fclaude-desktop-debian\u002Frpm\u002Fclaude-desktop.repo -o \u002Fetc\u002Fyum.repos.d\u002Fclaude-desktop.repo\n\n# 安装或更新：\nsudo dnf install claude-desktop\n```\n\n### AUR (Arch Linux)\n\n```bash\nyay -S claude-desktop-appimage\n```\n\n### 手动下载\n\n从下方资源中下载 `.deb`、`.rpm` 或 `.AppImage` 文件。","2026-04-09T01:45:41",{"id":157,"version":158,"summary_zh":159,"released_at":160},213298,"v1.3.27+claude1.1062.0","## Claude Desktop 更新\n\n此版本将打包的 Claude Desktop 更新至 **1.1062.0**。\n\n### 变更内容\n- 将 Claude Desktop 更新至 1.1062.0 版本\n\n---\n\n## 安装\n\n### APT（Debian\u002FUbuntu）\n\n```bash\n# 首次使用？添加仓库：\ncurl -fsSL https:\u002F\u002Faaddrick.github.io\u002Fclaude-desktop-debian\u002FKEY.gpg | sudo gpg --dearmor -o \u002Fusr\u002Fshare\u002Fkeyrings\u002Fclaude-desktop.gpg\necho \"deb [signed-by=\u002Fusr\u002Fshare\u002Fkeyrings\u002Fclaude-desktop.gpg arch=amd64,arm64] https:\u002F\u002Faaddrick.github.io\u002Fclaude-desktop-debian stable main\" | sudo tee \u002Fetc\u002Fapt\u002Fsources.list.d\u002Fclaude-desktop.list\n\n# 安装或更新：\nsudo apt update && sudo apt install claude-desktop\n```\n\n### DNF（Fedora\u002FRHEL）\n\n```bash\n# 首次使用？添加仓库：\nsudo curl -fsSL https:\u002F\u002Faaddrick.github.io\u002Fclaude-desktop-debian\u002Frpm\u002Fclaude-desktop.repo -o \u002Fetc\u002Fyum.repos.d\u002Fclaude-desktop.repo\n\n# 安装或更新：\nsudo dnf install claude-desktop\n```\n\n### AUR（Arch Linux）\n\n```bash\nyay -S claude-desktop-appimage\n```\n\n### 手动下载\n\n从下方资源中下载 `.deb`、`.rpm` 或 `.AppImage` 文件。","2026-04-08T01:45:21",{"id":162,"version":163,"summary_zh":164,"released_at":165},213299,"v1.3.27+claude1.569.0","# 包装器更新：v1.3.27+claude1.569.0\n\n此版本仅更新包装器\u002F打包部分——上游 Claude Desktop 版本未作更改。\n\n## 自 v1.3.26+claude1.569.0 以来的变更\n\n- 修复：修正全角破折号字符的 UTF-8 编码 (a035639)\n- 修复：修正文件内容（使用正确的 base64 重新编码）(1a304d4)\n- 修复：解决 cowork 服务中所有双重嵌套的主目录路径问题 (#373) (9b3c8f4)\n- 修复：解决 cowork mountPath 中的双重嵌套主目录路径问题 (#373) (0bcc245)\n\n---\n\n## 安装\n\n### APT（Debian\u002FUbuntu）\n\n```bash\n# 首次使用？添加仓库：\ncurl -fsSL https:\u002F\u002Faaddrick.github.io\u002Fclaude-desktop-debian\u002FKEY.gpg | sudo gpg --dearmor -o \u002Fusr\u002Fshare\u002Fkeyrings\u002Fclaude-desktop.gpg\necho \"deb [signed-by=\u002Fusr\u002Fshare\u002Fkeyrings\u002Fclaude-desktop.gpg arch=amd64,arm64] https:\u002F\u002Faaddrick.github.io\u002Fclaude-desktop-debian stable main\" | sudo tee \u002Fetc\u002Fapt\u002Fsources.list.d\u002Fclaude-desktop.list\n\n# 安装或更新：\nsudo apt update && sudo apt install claude-desktop\n```\n\n### DNF（Fedora\u002FRHEL）\n\n```bash\n# 首次使用？添加仓库：\nsudo curl -fsSL https:\u002F\u002Faaddrick.github.io\u002Fclaude-desktop-debian\u002Frpm\u002Fclaude-desktop.repo -o \u002Fetc\u002Fyum.repos.d\u002Fclaude-desktop.repo\n\n# 安装或更新：\nsudo dnf install claude-desktop\n```\n\n### AUR（Arch Linux）\n\n```bash\nyay -S claude-desktop-appimage\n```\n\n### 手动下载\n\n从下方资源中下载 `.deb`、`.rpm` 或 `.AppImage` 文件。","2026-04-04T13:11:18",{"id":167,"version":168,"summary_zh":169,"released_at":170},213300,"v1.3.26+claude1.569.0","## Claude Desktop 更新\n\n此版本将打包的 Claude Desktop 更新至 **1.569.0**。\n\n### 变更内容\n- 将 Claude Desktop 更新至 1.569.0 版本\n\n---\n\n## 安装\n\n### APT（Debian\u002FUbuntu）\n\n```bash\n# 第一次使用？添加仓库：\ncurl -fsSL https:\u002F\u002Faaddrick.github.io\u002Fclaude-desktop-debian\u002FKEY.gpg | sudo gpg --dearmor -o \u002Fusr\u002Fshare\u002Fkeyrings\u002Fclaude-desktop.gpg\necho \"deb [signed-by=\u002Fusr\u002Fshare\u002Fkeyrings\u002Fclaude-desktop.gpg arch=amd64,arm64] https:\u002F\u002Faaddrick.github.io\u002Fclaude-desktop-debian stable main\" | sudo tee \u002Fetc\u002Fapt\u002Fsources.list.d\u002Fclaude-desktop.list\n\n# 安装或更新：\nsudo apt update && sudo apt install claude-desktop\n```\n\n### DNF（Fedora\u002FRHEL）\n\n```bash\n# 第一次使用？添加仓库：\nsudo curl -fsSL https:\u002F\u002Faaddrick.github.io\u002Fclaude-desktop-debian\u002Frpm\u002Fclaude-desktop.repo -o \u002Fetc\u002Fyum.repos.d\u002Fclaude-desktop.repo\n\n# 安装或更新：\nsudo dnf install claude-desktop\n```\n\n### AUR（Arch Linux）\n\n```bash\nyay -S claude-desktop-appimage\n```\n\n### 手动下载\n\n从下方资源中下载 `.deb`、`.rpm` 或 `.AppImage` 文件。","2026-04-03T02:22:48",{"id":172,"version":173,"summary_zh":174,"released_at":175},213301,"v1.3.26+claude1.2.234","请参阅 [README](https:\u002F\u002Fgithub.com\u002Faaddrick\u002Fclaude-desktop-debian#readme) 以获取安装说明。","2026-04-02T03:58:30",{"id":177,"version":178,"summary_zh":179,"released_at":180},213302,"v1.3.26+claude1.1.9669","## v1.3.25+claude1.1.8629 → v1.3.26+claude1.1.9669\n\n这是 Claude Desktop 的一次重大功能发布。亮点包括用于沙箱化代码执行的完整 Operon 代理\u002F虚拟机基础设施、全新的工件版本控制与存储系统、扩展的 MCP 协议能力、企业级配置增强，以及重新设计的插件生态体系，并支持组织级别的部署与管理。\n\n---\n\n### 代理基础设施与 Operon 虚拟机\n\n- **Operon 代理组装与虚拟机支持**：新增完整的 Operon 代理准备流程（`OperonAssembly`、`OperonBootstrap`），支持通过 Swift 插件集成启动虚拟机；同时引入本地代理模式会话管理器（`LocalAgentModeSessionManager`），配备代理框架运行器和上下文类，可加载技能与工具。\n- **结构化规划工具**：全新 `generate_plan` 多阶段规划工具，专为代理工作流设计。\n- **Git 工作树管理**：为代理操作提供基于会话的 Git 工作树隔离机制。\n- **新增代理模式**：新增计划模式、绕过模式和自动模式。\n- **安全虚拟机特性开关**：新增 `secureVmFeaturesEnabled` 首选项——所有需要虚拟机安全保障的功能现均受该设置控制，并显示用户友好提示，引导用户或其 IT 管理员启用此功能。\n\n### 计算机使用与 Cowork 功能\n\n- **计算机使用并发保护**：防止多个计算机使用会话同时进行。\n- **截图缩放与裁剪工具**：新增具备缩放与裁剪功能的截图工具。\n- **仅限 macOS 的执行器**：计算机使用执行器现仅适用于 macOS 系统。\n- **剪贴板与系统键授权标志**：新增用于剪贴板访问及系统键授权的权限标志。\n- **Cowork 工件功能增强**：支持 Chart.js CDN 渲染工件内容，引入工件版本控制与存储系统，并可导出\u002F导入；同时新增 `CoworkArtifactBridge`，用于从工件 iframe 中调用 MCP 工具。\n- **安全工件协议**：为工件定制 Electron 协议处理器，并强制实施内容安全策略（CSP）。\n- **组织管理员禁用功能**：现在可由组织管理员禁用 Cowork 功能，并向用户显示相应提示信息。\n\n### MCP 协议与插件生态体系\n\n- **完整的 MCP 客户端实现**：新增 MCP 客户端（`DSn`），支持任务处理及列表变更监听。\n- **带输出 Schema 的 MCP 服务器**：实现高级别 MCP 服务器，支持工具输出 Schema。\n- **MCP 进程池**：支持基于 Conda 环境的 MCP 进程池管理。\n- **市场插件同步**：通过远程 API 轮询实现市场插件的同步更新。\n- **插件上传路由**：插件上传现可路由至 operon、本地或账户后端。\n- **`request_host_access` 工具**：新增文件系统工具，内置原生目录选择器，用于授予主机访问权限。\n- **Dispatch MCP 服务器**：用于子会话编排的服务器，支持 `start_task`、`send_message` 等操作。\n- **`server_tool_use` \u002F `mcp_tool_use` 类型支持**：新增工具使用内容块类型。\n- **组织级别插件部署**（`org-plugins`）：新增 `custom-3p: org-plugins` CSS 标记及配套基础设施，以支持企业统一管理的第三方…","2026-03-31T20:50:34",{"id":182,"version":183,"summary_zh":184,"released_at":185},213303,"v1.3.24+claude1.1.8629","# 包装器更新：v1.3.24+claude1.1.8629\n\n本次发布仅更新包装器\u002F打包部分——上游 Claude Desktop 版本未作更改。\n\n## 自 v1.3.23+claude1.1.8629 以来的变更\n\n- 修复：在 cowork 补丁 9 中动态提取压缩变量 (#345) (9afacd5)\n\n---\n\n## 安装\n\n### APT（Debian\u002FUbuntu）\n\n```bash\n# 首次使用？添加仓库：\ncurl -fsSL https:\u002F\u002Faaddrick.github.io\u002Fclaude-desktop-debian\u002FKEY.gpg | sudo gpg --dearmor -o \u002Fusr\u002Fshare\u002Fkeyrings\u002Fclaude-desktop.gpg\necho \"deb [signed-by=\u002Fusr\u002Fshare\u002Fkeyrings\u002Fclaude-desktop.gpg arch=amd64,arm64] https:\u002F\u002Faaddrick.github.io\u002Fclaude-desktop-debian stable main\" | sudo tee \u002Fetc\u002Fapt\u002Fsources.list.d\u002Fclaude-desktop.list\n\n# 安装或更新：\nsudo apt update && sudo apt install claude-desktop\n```\n\n### DNF（Fedora\u002FRHEL）\n\n```bash\n# 首次使用？添加仓库：\nsudo curl -fsSL https:\u002F\u002Faaddrick.github.io\u002Fclaude-desktop-debian\u002Frpm\u002Fclaude-desktop.repo -o \u002Fetc\u002Fyum.repos.d\u002Fclaude-desktop.repo\n\n# 安装或更新：\nsudo dnf install claude-desktop\n```\n\n### AUR（Arch Linux）\n\n```bash\nyay -S claude-desktop-appimage\n```\n\n### 手动下载\n\n从下方资源中下载 `.deb`、`.rpm` 或 `.AppImage` 文件。","2026-03-25T10:31:56",{"id":187,"version":188,"summary_zh":189,"released_at":190},213304,"v1.3.23+claude1.1.8629","## v1.3.23+claude1.1.7714 → v1.3.23+claude1.1.8629\n\n这是 Claude Desktop 应用程序的更新（封装版本仍为 v1.3.23）。主要更改包括对受信任来源的安全性扩展，以及 Zod 库版本的升级，新增了字符串验证方法。\n\n## 受信任来源变更\n\n允许的来源列表新增了两项，并删除了一项。\n\n**新增：**\n- `localhost` — 本地开发环境现在可以通过来源检查。如果你在本地构建 Claude Desktop，这将非常有用。\n- `*.ant.dev` — Anthropic 的内部预发布\u002F预览域名。现在 `ant.dev` 的任何子域名都被视为受信任。\n\n**移除：**\n- `https:\u002F\u002Fion-preview.claude.ai` — 该预发布 URL 已从白名单中移除。\n\n这些更改同时影响主窗口和“查找”功能的来源验证。\n\n## Zod 库更新\n\n捆绑的 Zod 模式验证库已升级到较新版本。实际新增了三个新的字符串格式验证器：\n\n- IPv4 地址验证\n- IPv4 CIDR 块验证\n- IPv6 地址验证\n\n这些对应于 Zod 的 `.ip()` 和 `.cidr()` 字符串模式方法。如果 Claude Desktop 使用 Zod 验证任何网络地址输入，这些路径现在都将进行正确的格式检查。\n\n## deepPartial 对元组的支持\n\nZod 的 `.deepPartial()` 现在可以递归处理元组类型。此前，在进行深度部分化时，元组模式会原样通过。现在，元组中的每个位置项都会被递归处理。这是捆绑库中的一个正确性修复。\n\n---\n\n### 安装\n\n#### APT（Debian\u002FUbuntu - 推荐）\n\n```bash\n# 添加 GPG 密钥\ncurl -fsSL https:\u002F\u002Faaddrick.github.io\u002Fclaude-desktop-debian\u002FKEY.gpg | sudo gpg --dearmor -o \u002Fusr\u002Fshare\u002Fkeyrings\u002Fclaude-desktop.gpg\n\n# 添加仓库\necho \"deb [signed-by=\u002Fusr\u002Fshare\u002Fkeyrings\u002Fclaude-desktop.gpg arch=amd64,arm64] https:\u002F\u002Faaddrick.github.io\u002Fclaude-desktop-debian stable main\" | sudo tee \u002Fetc\u002Fapt\u002Fsources.list.d\u002Fclaude-desktop.list\n\n# 更新并安装\nsudo apt update\nsudo apt install claude-desktop\n```\n\n#### DNF（Fedora\u002FRHEL - 推荐）\n\n```bash\n# 添加仓库\nsudo curl -fsSL https:\u002F\u002Faaddrick.github.io\u002Fclaude-desktop-debian\u002Frpm\u002Fclaude-desktop.repo -o \u002Fetc\u002Fyum.repos.d\u002Fclaude-desktop.repo\n\n# 安装\nsudo dnf install claude-desktop\n```\n\n#### AUR（Arch Linux）\n\n```bash\n# 使用 yay\nyay -S claude-desktop-appimage\n\n# 或使用 paru\nparu -S claude-desktop-appimage\n```\n\n#### 预编译发行版\n\n从 [Releases 页面](https:\u002F\u002Fgithub.com\u002Faaddrick\u002Fclaude-desktop-debian\u002Freleases)下载最新的 `.deb`、`.rpm` 或 `.AppImage` 文件。\n\n---\n\n### 分析成本\n\n**时长:** 159 分 49 秒\n\n| 模型 | 调用次数 | 输入 | 缓存读取 | 缓存写入 | 输出 | 成本 |\n|-------|------:|------:|-----------:|------------:|-------:|-----:|\n| claude-sonnet-4-6 | 1295 | 5,190 | 47,719,971 | 8,348,516 | 1,691,032 | $71.0040 |\n| **总计** | **1295** | **5,190** | **47,719,971** | **8,348,516** | **1,691,032** | **$71.0040** |\n\n*喜欢这个项目吗？[考虑赞助！](https:\u002F\u002Fgithub.com\u002Fsponsors\u002Faaddrick)*\n---\n\n## Wra","2026-03-25T04:25:32",{"id":192,"version":193,"summary_zh":194,"released_at":195},213305,"v1.3.23+claude1.1.7714","# 包装器更新：v1.3.23+claude1.1.7714\n\n此版本仅更新包装器\u002F打包部分——上游 Claude Desktop 版本未作更改。\n\n## 自 v1.3.22+claude1.1.7714 以来的变更\n\n- 样式：现在助手支持 `$*`，因此将 89 字符的 `_info` 行换行（a1a7d55）\n- 样式：将 `--doctor` 输出行换行以适应 80 列限制 (#270)（db188fb）\n- 文档：感谢 cromagnone 确认 bwrap 上的虚拟机下载循环问题（7a5aafe）\n- 文档：感谢 jarrodcolburn 提出 virtiofsd PATH 检测问题（3eb75b7）\n- 修复：在 Linux 上禁用虚拟机文件下载，以防止校验和循环问题 (#337)（a3190c3）\n- 修复：多参数 `log_message` 和 `_info` 调用会丢弃输出 (#325)（9c1b5a1）\n- 文档：感谢 CyPack 对孤立 cowork 守护进程清理的贡献 (#325)（11ec1e1）\n- 重构：将武装配对处理程序整合为可重用的帮助函数（f62b553）\n- 修复：针对相同大小平铺窗口管理器工作区切换进行了防抖动调整 (#323)（062f460）\n- 样式：将调整大小事件注释精简至必要细节（209ccee）\n- 修复：处理平铺窗口管理器工作区切换时的调整大小事件 (#323)（2cfc6a8）\n- 修复：移除上游标签并重新界定分类负责权（a29fc0e）\n- 修复：在分类代理中添加反模式和升级规则（93e1d17）\n- 修复：提高分类调查的准确性和上下文信息（ffd4ef3）\n- 修复：在启动时杀死孤立的 cowork-vm-service 守护进程（ab61db9）\n\n---\n\n## 安装\n\n### APT（Debian\u002FUbuntu）\n\n```bash\n# 首次使用？添加仓库：\ncurl -fsSL https:\u002F\u002Faaddrick.github.io\u002Fclaude-desktop-debian\u002FKEY.gpg | sudo gpg --dearmor -o \u002Fusr\u002Fshare\u002Fkeyrings\u002Fclaude-desktop.gpg\necho \"deb [signed-by=\u002Fusr\u002Fshare\u002Fkeyrings\u002Fclaude-desktop.gpg arch=amd64,arm64] https:\u002F\u002Faaddrick.github.io\u002Fclaude-desktop-debian stable main\" | sudo tee \u002Fetc\u002Fapt\u002Fsources.list.d\u002Fclaude-desktop.list\n\n# 安装或更新：\nsudo apt update && sudo apt install claude-desktop\n```\n\n### DNF（Fedora\u002FRHEL）\n\n```bash\n# 首次使用？添加仓库：\nsudo curl -fsSL https:\u002F\u002Faaddrick.github.io\u002Fclaude-desktop-debian\u002Frpm\u002Fclaude-desktop.repo -o \u002Fetc\u002Fyum.repos.d\u002Fclaude-desktop.repo\n\n# 安装或更新：\nsudo dnf install claude-desktop\n```\n\n### AUR（Arch Linux）\n\n```bash\nyay -S claude-desktop-appimage\n```\n\n### 手动下载\n\n从下方资源中下载 `.deb`、`.rpm` 或 `.AppImage` 文件。","2026-03-23T03:02:59",{"id":197,"version":198,"summary_zh":199,"released_at":200},213306,"v1.3.22+claude1.1.7714","# Wrapper Update: v1.3.22+claude1.1.7714\n\nThis release updates the wrapper\u002Fpackaging only — the upstream Claude Desktop version is unchanged.\n\n## Changes since v1.3.21+claude1.1.7714\n\n- style: simplify VM checksum code in PR #330 (bb1dd02)\n- fix: use correct linux VM checksums in cowork manifest patch (#329) (aa6b87d)\n- fix: add --dangerously-skip-permissions to triage comment generation (bc1074e)\n\n---\n\n## Installation\n\n### APT (Debian\u002FUbuntu)\n\n```bash\n# First time? Add the repo:\ncurl -fsSL https:\u002F\u002Faaddrick.github.io\u002Fclaude-desktop-debian\u002FKEY.gpg | sudo gpg --dearmor -o \u002Fusr\u002Fshare\u002Fkeyrings\u002Fclaude-desktop.gpg\necho \"deb [signed-by=\u002Fusr\u002Fshare\u002Fkeyrings\u002Fclaude-desktop.gpg arch=amd64,arm64] https:\u002F\u002Faaddrick.github.io\u002Fclaude-desktop-debian stable main\" | sudo tee \u002Fetc\u002Fapt\u002Fsources.list.d\u002Fclaude-desktop.list\n\n# Install or update:\nsudo apt update && sudo apt install claude-desktop\n```\n\n### DNF (Fedora\u002FRHEL)\n\n```bash\n# First time? Add the repo:\nsudo curl -fsSL https:\u002F\u002Faaddrick.github.io\u002Fclaude-desktop-debian\u002Frpm\u002Fclaude-desktop.repo -o \u002Fetc\u002Fyum.repos.d\u002Fclaude-desktop.repo\n\n# Install or update:\nsudo dnf install claude-desktop\n```\n\n### AUR (Arch Linux)\n\n```bash\nyay -S claude-desktop-appimage\n```\n\n### Manual Download\n\nDownload `.deb`, `.rpm`, or `.AppImage` from the assets below.\n","2026-03-22T12:53:59",{"id":202,"version":203,"summary_zh":204,"released_at":205},213307,"v1.3.21+claude1.1.7714","# Wrapper Update: v1.3.21+claude1.1.7714\n\nThis release updates the wrapper\u002Fpackaging only — the upstream Claude Desktop version is unchanged.\n\n## Changes since v1.3.19+claude1.1.7714\n\n- fix: address code review findings for --doctor backend display (d499d8d)\n- style: simplify KVM active check in --doctor cowork section (39c9fea)\n- feat: make bubblewrap the default cowork isolation backend (3ada749)\n- docs: update contributor credits for cbonnissent and arauhala (dee729b)\n- docs: add ecrevisseMiroir to contributors for bwrap sandbox isolation (cb770de)\n- fix: bwrap backend mounts at guest paths and uses minimal sandbox root (219ddbe)\n\n---\n\n## Installation\n\n### APT (Debian\u002FUbuntu)\n\n```bash\n# First time? Add the repo:\ncurl -fsSL https:\u002F\u002Faaddrick.github.io\u002Fclaude-desktop-debian\u002FKEY.gpg | sudo gpg --dearmor -o \u002Fusr\u002Fshare\u002Fkeyrings\u002Fclaude-desktop.gpg\necho \"deb [signed-by=\u002Fusr\u002Fshare\u002Fkeyrings\u002Fclaude-desktop.gpg arch=amd64,arm64] https:\u002F\u002Faaddrick.github.io\u002Fclaude-desktop-debian stable main\" | sudo tee \u002Fetc\u002Fapt\u002Fsources.list.d\u002Fclaude-desktop.list\n\n# Install or update:\nsudo apt update && sudo apt install claude-desktop\n```\n\n### DNF (Fedora\u002FRHEL)\n\n```bash\n# First time? Add the repo:\nsudo curl -fsSL https:\u002F\u002Faaddrick.github.io\u002Fclaude-desktop-debian\u002Frpm\u002Fclaude-desktop.repo -o \u002Fetc\u002Fyum.repos.d\u002Fclaude-desktop.repo\n\n# Install or update:\nsudo dnf install claude-desktop\n```\n\n### AUR (Arch Linux)\n\n```bash\nyay -S claude-desktop-appimage\n```\n\n### Manual Download\n\nDownload `.deb`, `.rpm`, or `.AppImage` from the assets below.\n","2026-03-21T22:47:44",{"id":207,"version":208,"summary_zh":209,"released_at":210},213308,"v1.3.19+claude1.1.7714","# Wrapper Update: v1.3.19+claude1.1.7714\n\nThis release updates the wrapper\u002Fpackaging only — the upstream Claude Desktop version is unchanged.\n\n## Changes since v1.3.18+claude1.1.7714\n\n- style: simplify Patch 9 comments and inline variable (62e7dfc)\n- fix: don't trigger Windows VM configure on Linux (#315) (4711b24)\n- fix: skip ELECTRON_FORCE_IS_PACKAGED for NixOS builds (c3cc5a6)\n- docs: update sabiut contributor credit for checksum validation (1e2db5c)\n- fix: echo request id in RPC responses for persistent connections (#312) (b9c3573)\n- refactor: simplify verify_sha256 and checksum calls (382a59c)\n- feat: add SHA-256 checksum validation for downloads (1fc4e83)\n\n---\n\n## Installation\n\n### APT (Debian\u002FUbuntu)\n\n```bash\n# First time? Add the repo:\ncurl -fsSL https:\u002F\u002Faaddrick.github.io\u002Fclaude-desktop-debian\u002FKEY.gpg | sudo gpg --dearmor -o \u002Fusr\u002Fshare\u002Fkeyrings\u002Fclaude-desktop.gpg\necho \"deb [signed-by=\u002Fusr\u002Fshare\u002Fkeyrings\u002Fclaude-desktop.gpg arch=amd64,arm64] https:\u002F\u002Faaddrick.github.io\u002Fclaude-desktop-debian stable main\" | sudo tee \u002Fetc\u002Fapt\u002Fsources.list.d\u002Fclaude-desktop.list\n\n# Install or update:\nsudo apt update && sudo apt install claude-desktop\n```\n\n### DNF (Fedora\u002FRHEL)\n\n```bash\n# First time? Add the repo:\nsudo curl -fsSL https:\u002F\u002Faaddrick.github.io\u002Fclaude-desktop-debian\u002Frpm\u002Fclaude-desktop.repo -o \u002Fetc\u002Fyum.repos.d\u002Fclaude-desktop.repo\n\n# Install or update:\nsudo dnf install claude-desktop\n```\n\n### AUR (Arch Linux)\n\n```bash\nyay -S claude-desktop-appimage\n```\n\n### Manual Download\n\nDownload `.deb`, `.rpm`, or `.AppImage` from the assets below.\n","2026-03-20T15:27:40",{"id":212,"version":213,"summary_zh":214,"released_at":215},213309,"v1.3.18+claude1.1.7714","# Summary Generation Failed\n\nClaude CLI error: \n\n---\n\n### Installation\n\n#### APT (Debian\u002FUbuntu - Recommended)\n\n```bash\n# Add the GPG key\ncurl -fsSL https:\u002F\u002Faaddrick.github.io\u002Fclaude-desktop-debian\u002FKEY.gpg | sudo gpg --dearmor -o \u002Fusr\u002Fshare\u002Fkeyrings\u002Fclaude-desktop.gpg\n\n# Add the repository\necho \"deb [signed-by=\u002Fusr\u002Fshare\u002Fkeyrings\u002Fclaude-desktop.gpg arch=amd64,arm64] https:\u002F\u002Faaddrick.github.io\u002Fclaude-desktop-debian stable main\" | sudo tee \u002Fetc\u002Fapt\u002Fsources.list.d\u002Fclaude-desktop.list\n\n# Update and install\nsudo apt update\nsudo apt install claude-desktop\n```\n\n#### DNF (Fedora\u002FRHEL - Recommended)\n\n```bash\n# Add the repository\nsudo curl -fsSL https:\u002F\u002Faaddrick.github.io\u002Fclaude-desktop-debian\u002Frpm\u002Fclaude-desktop.repo -o \u002Fetc\u002Fyum.repos.d\u002Fclaude-desktop.repo\n\n# Install\nsudo dnf install claude-desktop\n```\n\n#### AUR (Arch Linux)\n\n```bash\n# Using yay\nyay -S claude-desktop-appimage\n\n# Or using paru\nparu -S claude-desktop-appimage\n```\n\n#### Pre-built Releases\n\nDownload the latest `.deb`, `.rpm`, or `.AppImage` from the [Releases page](https:\u002F\u002Fgithub.com\u002Faaddrick\u002Fclaude-desktop-debian\u002Freleases).\n---\n\n## Wrapper\u002FPackaging Changes\n\nThe following commits were made to the build wrapper and packaging between v1.3.18+claude1.1.7464 and v1.3.18+claude1.1.7714:\n\n- Update Claude Desktop download URLs to version 1.1.7714 (5f5e1b5)\n- fix: use security_model=none for virtio-9p unprivileged operation (473b0ba)\n- refactor: rename share constants to reflect both virtiofs and 9p usage (e9a09ad)\n- feat: add virtio-9p fallback when virtiofsd fails in KVM backend (e8a5651)\n","2026-03-20T01:59:17",{"id":217,"version":218,"summary_zh":219,"released_at":220},213310,"v1.3.18+claude1.1.7464","# Wrapper Update: v1.3.18+claude1.1.7464\n\nThis release updates the wrapper\u002Fpackaging only — the upstream Claude Desktop version is unchanged.\n\n## Changes since v1.3.17+claude1.1.7464\n\n- feat: add proper launcher script for NixOS with --doctor and Wayland support (99d91ac)\n- docs: update jarrodcolburn contributor entry for gh-pages bloat fix (645ad92)\n- fix: propagate run_doctor exit code in all launchers (3f7a3c2)\n- fix: clean up CLAUDE_MENU_BAR boolean alias implementation (9b4ac63)\n- style: use template literal instead of concatenation for log message (956eb72)\n- feat: extract smol-bin and plugin shim from Windows installer (a5f16b2)\n- docs: add cbonnissent to contributors for Cowork VM fix (2c62b79)\n- fix: use app-provided bundlePath for VM images in KVM backend (1d7699e)\n- style: clean up log string formatting in KVM installSdk (4bc44ec)\n- fix: harden cowork VM service daemon after #300 merge (932044d)\n- refactor: simplify KVM backend SDK install and virtiofs paths (#288) (5d6f897)\n- fix: send writeStdin as notification instead of request (#288) (10e745a)\n- fix: forward installSdk to guest and resolve guest SDK path (#288) (06a8cd3)\n- fix: correct guest RPC wire protocol (#288) (283e669)\n- fix: correct virtiofs tag and guest mount path (#288) (d96b787)\n- fix: attach session disk and smol-bin drive (#288) (ae92893)\n- fix: use shared memory backend for virtiofs (#288) (fc0d55f)\n- fix: wait for virtiofsd socket before starting QEMU (#288) (0eb5ce3)\n- fix: add ready event to FORWARDED_EVENTS (#288) (af1f2e3)\n- fix: accept boolean aliases for CLAUDE_MENU_BAR env var (e1dbbc2)\n- add doctor processing to rpm launch (cad8415)\n\n## Contributors\n\n- @cbonnissent — reverse-engineered the Cowork VM guest RPC protocol and fixed the KVM startup blocker (#288, #300)\n- @noctuum — `CLAUDE_MENU_BAR` env var with configurable boolean aliases (#299)\n- @joekale-pp — `--doctor` support for the RPM launcher (#295)\n\n---\n\n## Installation\n\n### APT (Debian\u002FUbuntu)\n\n```bash\n# First time? Add the repo:\ncurl -fsSL https:\u002F\u002Faaddrick.github.io\u002Fclaude-desktop-debian\u002FKEY.gpg | sudo gpg --dearmor -o \u002Fusr\u002Fshare\u002Fkeyrings\u002Fclaude-desktop.gpg\necho \"deb [signed-by=\u002Fusr\u002Fshare\u002Fkeyrings\u002Fclaude-desktop.gpg arch=amd64,arm64] https:\u002F\u002Faaddrick.github.io\u002Fclaude-desktop-debian stable main\" | sudo tee \u002Fetc\u002Fapt\u002Fsources.list.d\u002Fclaude-desktop.list\n\n# Install or update:\nsudo apt update && sudo apt install claude-desktop\n```\n\n### DNF (Fedora\u002FRHEL)\n\n```bash\n# First time? Add the repo:\nsudo curl -fsSL https:\u002F\u002Faaddrick.github.io\u002Fclaude-desktop-debian\u002Frpm\u002Fclaude-desktop.repo -o \u002Fetc\u002Fyum.repos.d\u002Fclaude-desktop.repo\n\n# Install or update:\nsudo dnf install claude-desktop\n```\n\n### AUR (Arch Linux)\n\n```bash\nyay -S claude-desktop-appimage\n```\n\n### Manual Download\n\nDownload `.deb`, `.rpm`, or `.AppImage` from the assets below.","2026-03-19T13:12:44",{"id":222,"version":223,"summary_zh":224,"released_at":225},213311,"v1.3.17+claude1.1.7464","## v1.3.17+claude1.1.7203 → v1.3.17+claude1.1.7464\n\nThis build ships several meaningful capability expansions: new browser automation tools, a built-in terminal MCP server, workspace and memory fields on sessions, and a full consolidation away from WebSocket and hybrid transports to SSE-only. There's also a round of security tightening on permission modes and auth error handling.\n\n---\n\n### New Features\n\n**Session fields**\n\nSessions now carry three new fields: `spaceId` (workspace association), `memoryEnabled` (per-session memory toggle), and `systemPromptAppend` (injecting additional system prompt text at session creation). These flow through session creation, serialization, and IPC.\n\n**Browser automation tools**\n\nFour new browser tools were added: `get_page_text`, `tabs_context_mcp`, `tabs_create_mcp`, and `tabs_close_mcp`. The `ComputerUseTcc` IPC interface also gained `listInstalledApps()`, which lets the renderer query the main process for installed applications.\n\n**Terminal MCP server**\n\nA built-in `terminal` MCP server with a `read_terminal` tool is now available on macOS and CCD sessions. You can read terminal output directly through the MCP interface.\n\n**Xcode support**\n\nXcode was added as a supported IDE. `openInEditor` now accepts a line number argument, and Xcode projects open via `shell.openPath`. `getInstalledEditors()` and `openInEditor()` both gained new parameters to support this.\n\n**File system**\n\nA new `browseFolders` (plural) method was added to the FileSystem IPC interface, complementing the existing `browseFolder`. You can now select multiple folders at once.\n\n**`readSessionFile` API**\n\nThe renderer gained a new `readSessionFile(sessionId, path)` IPC call, allowing the renderer to read files associated with a specific session.\n\n**Plugin sources**\n\nGitLab and Bitbucket are now whitelisted as remote plugin sources. GitHub Enterprise support was added to the marketplace. `uv` is now a valid DXT v0.4 server runtime type.\n\n**Dock state events**\n\nA new `onCuDockStateChanged` event listener was added to the WindowState IPC object, exposing dock state change notifications to the renderer.\n\n---\n\n### Transport Changes\n\nWebSocket (`ws`) and hybrid transports were removed. SSE is now the only supported transport. The CSS utility classes for `ws` and `hybrid` transport states were removed across all renderer windows. If you're configuring MCP servers or transport modes, only `sse` and `ccr` remain valid options.\n\nV1 session transport support was also dropped. Any v1 work from the backend is rejected with a telemetry event rather than processed.\n\n---\n\n### Security and Permissions\n\n**Permission mode hardening**\n\n`Bypass` and `Auto` permission modes can now only be set as defaults from user-level settings. Project-level settings that try to set these modes are silently ignored with a warning logged.\n\n**Auth error handling**\n\n`getBootstrapData` now explicitly catches 401\u002F403 responses and returns `{ account: null, _clientAuthFailed: true }` instead of crashing. Session initialization now distinguishes expired sign-in from network errors.\n\n**JavaScript execution guard**\n\nA new guard (`XTt`) blocks arbitrary JavaScript execution in `auto` and `bypassPermissions` modes.\n\n**Computer-use permission model**\n\nThe computer-use system prompt was overhauled from a simple Chrome block to a three-tier model: browsers get read-only access, terminals and IDEs get click-only, and all other apps get full access.\n\n---\n\n### Conversation Compaction\n\nCompaction now supports preserved segments. A `compact_boundary` can carry a `preservedSegment` that keeps a specific conversation thread alive across compaction instead of discarding all pre-boundary history.\n\n---\n\n### i18n\n\nSeveral new UI strings were added across all locales, covering:\n\n- Home-directory folder restriction warnings (with pluralization: \"1 folder was skipped\" \u002F \"N folders were skipped\")\n- \"Learn Spelling\" spell-check action\n- Extension preview states and failure messages\n- Extension org-policy retention notices\n- \"Select All\" and \"Install\" labels\n- Update-check failure messages with error interpolation\n\nOne previously existing string was removed from all locales (key fell between `to40hXUNmk` and `tsxOTfL\u002FOf` alphabetically).\n\n---\n\n### Dependencies\n\n- `@anthropic-ai\u002Fclaude-agent-sdk`: `0.2.76` → `0.2.78`\n- `@anthropic-ai\u002Fclaude-agent-sdk-future`: `0.2.78-dev.20260316` → `0.2.79-dev.20260317`\n- `@typescript\u002Fnative-preview`: `7.0.0-dev.20260127.1` → `7.0.0-dev.20260228.1`\n\n---\n\n### Wrapper\u002FPackaging Changes\n\nThe following commits were made to the build wrapper and packaging between v1.3.17+claude1.1.7203 and v1.3.17+claude1.1.7464:\n\n- Update Claude Desktop download URLs to version 1.1.7464 (3b45c6d)\n\n---\n\n### Installation\n\n#### APT (Debian\u002FUbuntu - Recommended)\n\n```bash\n# Add the GPG key\ncurl -fsSL https:\u002F\u002Faaddrick.github.io\u002Fclaude-desktop-debian\u002FKEY.gpg | sudo gpg --dearmor -o \u002Fusr\u002Fshare\u002Fkeyrings\u002Fclaude-desktop.gpg\n\n# Add the repository\necho \"deb [signed-by=\u002Fu","2026-03-19T02:12:25",{"id":227,"version":228,"summary_zh":229,"released_at":230},213312,"v1.3.17+claude1.1.7203","## v1.3.17+claude1.1.5749 → v1.3.17+claude1.1.7203\n\nThis release ships a significant IPC surface expansion with new Cowork collaboration features, agent-mode infrastructure, and a richer VM management API. The shell environment forwarding got a practical fix for git signing workflows, and the design system went through a token rename refactor across all windows.\n\n---\n\n### New Features\n\n**Git commit signing now works in Claude Desktop.** Two environment variables — `SSH_AUTH_SOCK` and `GPG_TTY` — are now forwarded from your shell into the app's subprocess environment. If you use SSH key signing or GPG signing for git commits, this is the fix you've been waiting for. Previously, Claude's shell environment was missing the socket paths these tools need to prompt for credentials.\n\n**Shell PTY subsystem added to LocalSessions.** A parallel set of PTY methods landed for shell sessions specifically: `startShellPty`, `stopShellPty`, `resizeShellPty`, `writeShellPty`, and `getShellPtyBuffer`. These sit alongside the existing PTY methods (which appear to be for Claude tool execution terminals). Sessions also picked up `clearSession` for resetting state without deleting, and `getGitDiffStats` for fetching line\u002Ffile count summaries separately from the full diff content.\n\n**PR branch state tracking added.** `getPrStateForBranch` is a new LocalSessions method that fetches the current PR state for a given branch, including status, merge state, and checks summary.\n\n**Cowork collaboration APIs landed.** The IPC bridge picked up several new namespaces:\n- `CoworkScheduledTasks` — CRUD for scheduled tasks, with status updates, approved permission management, and Chrome permission clearing\n- `CCDScheduledTasks` — a parallel scheduled task system (separate from Cowork, same method surface)\n- `CoworkMemory` — `readGlobalMemory` and `writeGlobalMemory` for shared memory across sessions\n- `CoworkSpaces` — full space management: create\u002Fread\u002Fupdate\u002Fdelete spaces, folder\u002Fproject\u002Flink associations, file operations, and an `onSpaceEvent` subscription\n\n**Agent mode got new session controls.** `LocalAgentModeSessions` picked up `setChromePermissionMode`, `deleteBridgeAgentMemory`, `abandonBridgeEnvironment`, and `requestFolderTccAccess` (macOS TCC folder access requesting).\n\n**VM management expanded significantly.** `ClaudeVM` now includes VM download, startup\u002Fstatus monitoring, `setYukonSilverConfig`, `deleteAndReinstall`, `checkVirtualMachinePlatform`, `enableVirtualMachinePlatform`, `restartAfterVMPInstall`, and event streams for download progress, status changes, and startup errors. The `apiReachabilityStore` moved from the top-level `ClaudeVM` object into a nested store on `LocalAgentModeSessions.sessionsBridgeStatus`.\n\n**New utility bridges added.** Several IPC modules shipped that weren't in the previous build: `AgentModeFeedback` (open feedback window, report errors to Slack), `Account` (set account details), `Navigation` (subscribe to navigate events), `DeepLink` (handle deep link events), `WindowState` (fullscreen\u002Fvisibility events), `Toast` (show toast events), `FileSystem` (expanded file ops including Google Drive export), `OpenDocuments`, `Auth`, `Resources`, and `ClaudeCode` (status check, git availability check, prepare).\n\n**Launch preview API expanded.** The `Launch` module gained lifecycle methods for the preview subsystem: `showPreview`, `hidePreview`, `destroyPreview`, `refreshPreview`, `setPreviewViewport`, `isAvailable`, `getLogs`, and `stopServer`.\n\n**AutoUpdater and plugin APIs added.** `AutoUpdater` exposes `restartToUpdate`, `checkForUpdates`, and an `updaterStateStore`. `LocalPlugins` covers upload\u002Fdelete\u002Fenable for local plugins with OAuth flow support. `CustomPlugins` adds a marketplace layer: install\u002Fupdate\u002Funinstall plugins, list marketplaces, track install progress, and check for local changes.\n\n**Three new MCP transport types added to CSS.** The transport marker class system now includes `bridge`, `ccr`, and `sse` in addition to the existing `hybrid` and `ws`. This lets the UI visually distinguish additional MCP transport protocols in connection status displays.\n\n---\n\n### Bug Fixes \u002F Improvements\n\n**Shell exit buffering improved.** A 1-second grace timer was added to the shell path worker's exit handling. When a shell subprocess exits, the app now waits a second before tearing down stdout and stderr streams, letting any buffered output flush through first. Error messages from failed shell commands now consistently read from the unified result object.\n\n**Highlighted menu item contrast bumped.** The background color token for `[data-highlighted]` elements stepped from `--bg-200` to `--bg-300`, giving hover\u002Ffocus states on menu items a bit more visual weight.\n\n**Disabled state propagation improved.** Parent containers that wrap `[data-disabled]` children or disabled inputs now inherit `cursor: not-allowed` and `opacity: 0.5`. Previously only the disabled element itself would show disabled styling — now the whol","2026-03-18T02:07:23",{"id":232,"version":233,"summary_zh":234,"released_at":235},213313,"v1.3.17+claude1.1.5749","## v1.3.17+claude1.1.5368 → v1.3.17+claude1.1.5749\r\n\r\nThis release adds computer use capability and a new sessions bridge API, plus some practical fixes for corporate network environments. The IPC bridge picked up several new methods, and localization got a meaningful expansion across all supported languages.\r\n\r\n---\r\n\r\n### New Features\r\n\r\n**Computer use support added.** Two new dependencies landed: `@ant\u002Fcomputer-use-mcp` and `ws@^8.18.0`. The MCP server enables programmatic desktop control (screenshots, mouse, keyboard), and `ws` provides the WebSocket transport layer for it. A new `ComputerUseTcc` IPC API also shipped in the preload bridge, exposing six macOS TCC permission management methods: `getState`, `requestAccessibility`, `requestScreenRecording`, `openSystemSettings`, `getCurrentSessionGrants`, and `revokeGrant`. This is the plumbing Claude needs to interact with your desktop directly.\r\n\r\n**Sessions bridge IPC methods expanded.** `LocalAgentModeSessions` picked up several new calls:\r\n- `respondPluginSearch(e, t)` — respond to a plugin search request\r\n- `kickBridgePoll()` — manually trigger a bridge poll cycle\r\n- `getSessionsBridgeEnabled()` — query whether the sessions bridge is active\r\n- `setSessionsBridgeEnabled(e)` — toggle the sessions bridge on or off\r\n- `respondBridgePermissionPreflight(e, t)` — respond to a bridge permission preflight\r\n- `onOnBridgePermissionPreflight(e)` — event listener for preflight events from the main process\r\n\r\n**`getLocalFileThumbnail` added to FileSystem API.** The `FileSystem` IPC bridge gained a new `getLocalFileThumbnail(e, t, n)` method for fetching thumbnails of local files.\r\n\r\n**Sessions bridge CSS marker class added.** A `[sessions-bridge:attach]` Tailwind arbitrary-property class appears in all renderer windows. The non-standard `sessions-bridge: attach` CSS property acts as a DOM signal — JavaScript or Electron-side code reads it via computed style to trigger session attachment logic.\r\n\r\n---\r\n\r\n### Bug Fixes \u002F Improvements\r\n\r\n**Corporate proxy support improved.** Three SSL\u002FTLS certificate environment variables are now forwarded from the user's shell into the app: `NODE_EXTRA_CA_CERTS`, `SSL_CERT_FILE`, and `SSL_CERT_DIR`. If you're behind a corporate SSL-inspecting proxy, this should fix the TLS certificate errors you were hitting. Previously these were stripped out in the shell path worker allowlist.\r\n\r\n---\r\n\r\n### UI Changes\r\n\r\n**Font smoothing added.** An `.antialiased` CSS utility class landed in all renderer windows (main window, quick window, find-in-page, about). Text using this class renders with subpixel antialiasing on WebKit\u002FBlink and grayscale smoothing on Firefox\u002FmacOS. It's a visual polish change — fonts look crisper, especially on high-DPI displays.\r\n\r\n**`border-t` CSS utility added.** A standard 1px top border class was added across all windows. Previously only the 0.5px variant existed.\r\n\r\n---\r\n\r\n### Localization\r\n\r\nA solid set of new strings landed across all supported languages (de-DE, en-US, es-419, es-ES, fr-FR, hi-IN, id-ID, it-IT, ja-JP, ko-KR, pt-BR, and the pseudo-locales). The new strings cover:\r\n\r\n- Chrome install\u002Frestart lifecycle actions\r\n- MCP configuration reload failure errors\r\n- Skill file errors (not found, too large, failed to open)\r\n- Browser integration permission warnings (\"only grant 'always allow' for sites you trust\")\r\n- Net log recording debug action (30s)\r\n- Org admin controls — a notice that Claude Code for Desktop has been disabled by an administrator\r\n- Config file menu items (app config and developer config, separate entries)\r\n- VM bundle deletion and workspace reinstall flows\r\n- \"From your organization\" label for org-sourced resources\r\n- \"Attach logs\" action label\r\n\r\n---\r\n\r\n### Dependency Updates\r\n\r\n- `claude-agent-sdk`: 0.2.63 → 0.2.64\r\n- `claude-agent-sdk-future` (dev preview): 0.2.64-dev (2026-02-28) → 0.2.72-dev (2026-03-07)\r\n- `conway-client`: dev build from 2026-03-02 → 2026-03-06\r\n- `@ant\u002Fcomputer-use-mcp`: new addition\r\n- `ws@^8.18.0`: new addition\r\n\r\n---\r\n\r\n### Installation\r\n\r\n#### APT (Debian\u002FUbuntu - Recommended)\r\n\r\n```bash\r\n# Add the GPG key\r\ncurl -fsSL https:\u002F\u002Faaddrick.github.io\u002Fclaude-desktop-debian\u002FKEY.gpg | sudo gpg --dearmor -o \u002Fusr\u002Fshare\u002Fkeyrings\u002Fclaude-desktop.gpg\r\n\r\n# Add the repository\r\necho \"deb [signed-by=\u002Fusr\u002Fshare\u002Fkeyrings\u002Fclaude-desktop.gpg arch=amd64,arm64] https:\u002F\u002Faaddrick.github.io\u002Fclaude-desktop-debian stable main\" | sudo tee \u002Fetc\u002Fapt\u002Fsources.list.d\u002Fclaude-desktop.list\r\n\r\n# Update and install\r\nsudo apt update\r\nsudo apt install claude-desktop\r\n```\r\n\r\n#### DNF (Fedora\u002FRHEL - Recommended)\r\n\r\n```bash\r\n# Add the repository\r\nsudo curl -fsSL https:\u002F\u002Faaddrick.github.io\u002Fclaude-desktop-debian\u002Frpm\u002Fclaude-desktop.repo -o \u002Fetc\u002Fyum.repos.d\u002Fclaude-desktop.repo\r\n\r\n# Install\r\nsudo dnf install claude-desktop\r\n```\r\n\r\n#### AUR (Arch Linux)\r\n\r\n```bash\r\n# Using yay\r\nyay -S claude-desktop-appimage\r\n\r\n# Or using paru\r\nparu -S claude-desktop-appimage\r\n```\r\n\r\n#### Pre-built Releases\r\n\r\nDownload the latest `","2026-03-09T03:19:37",{"id":237,"version":238,"summary_zh":239,"released_at":240},213314,"v1.3.17+claude1.1.5368","## v1.3.17+claude1.1.4498 → v1.3.17+claude1.1.5368\n\nThis release adds a new preview environment, expands agent session controls, and ships a handful of new API surfaces. There's also UI polish across menus and some new auto-update repair tooling.\n\n---\n\n### New Features\n\n**`https:\u002F\u002Fion-preview.claude.ai` added as a trusted origin.** All origin allowlists across the main window, quick window, find-in-page, and title bar have been updated to accept this new preview\u002Fstaging environment alongside the existing `claude.com` and `preview.claude.com` entries.\n\n**Government\u002Fcustom deployment detection.** A new `isUsingCustomGovDeployment` flag is now checked at startup. When set, Sentry error reporting is suppressed for that session. This surfaces as `YV()` in the main process init — it's a runtime feature flag for non-standard enterprise deployments.\n\n**Agent mode session controls expanded.** `LocalAgentModeSessions` gained several new IPC methods: `delete`, `deleteBridgeSession`, `resetBridgeSession`, `getBridgeConsent`, `setPermissionMode`, `replaceRemoteMcpServers`, and `replaceEnabledMcpTools`. The `sendMessage` call also expanded from 4 to 5 parameters, and `getTranscript` now takes 2 parameters instead of 1.\n\n**`CCDScheduledTasks` module added.** A second scheduled-tasks namespace (likely \"Claude Computer Desktop Scheduled Tasks\") was added to the IPC bridge, with the same CRUD methods as `CoworkScheduledTasks`. `CoworkScheduledTasks` also picked up a new `clearChromePermissions` method for resetting browser automation permissions.\n\n**`getAutoMemoryDir` added to CoworkSpaces.** You can now query the directory used for auto-generated agent memory files.\n\n**`shareSession` and `getSessionsForScheduledTask` added to LocalSessions.** Along with `replaceRemoteMcpServers` and `replaceEnabledMcpTools` for atomic MCP server\u002Ftool replacement.\n\n**Transport mode selection.** New CSS utility classes `[transport:hybrid]` and `[transport:ws]` appear in the main and find-in-page windows. These are DOM marker classes read by JavaScript to select between connection transport strategies — likely for MCP server connections or real-time backend communication.\n\n---\n\n### Bug Fixes\n\n**Improved stack trace capture.** `Error.stackTraceLimit` is now explicitly set to 20 at startup (up from the V8 default of 10). Error reports and logs will now include twice as many frames.\n\n**Log formatter crash fix.** If the sprintf-style log formatter threw an exception (e.g. mismatched format specifiers or non-serializable values), the entire log entry would be lost. There's now a try\u002Fcatch fallback that reconstructs the message manually — stripping format specifiers, stringifying Error objects to `name: message`, and JSON-stringifying plain objects. Log entries are always produced now.\n\n---\n\n### UI \u002F Localization Changes\n\n**Auto-update ownership repair flow.** New strings in en-US and de-DE for a file-ownership fix dialog: \"Fix required for auto-updates\" title, a \"Fix ownership\" \u002F \"Berechtigungen korrigieren\" button, and an error message explaining what to do if the fix fails. This handles the case where Claude can't self-update due to filesystem ownership issues.\n\n**Context menu expanded.** New entries added: Undo, Select All, Cut, Copy Link, Copy Link Address, Copy Image Address, and Learn Spelling. These were missing from the localization tables previously.\n\n**Developer tools menu.** New strings for Show Dev Tools, Show All Dev Tools, Inspect Element, and Record Net Log (30s) — a debug\u002Fdeveloper menu is now accessible.\n\n**Installation corruption detection.** New string: \"Claude's installation appears to be corrupted. Reinstall Claude from claude.com\u002Fdownload.\"\n\n**Feature restart notification.** New string: \"That feature change requires an app restart to take effect.\"\n\n**`requestSkooch` now takes parameters.** The QuickWindow nudge\u002Freposition action previously took no arguments. It now accepts two positional parameters, so callers can supply direction or position data.\n\n**`deleteRemotePlugin` removed from LocalPlugins.** This method no longer exists on the IPC bridge.\n\n**`overflow-y-scroll` CSS class removed** from About, Quick, and Find-in-Page windows. Any permanently-visible scrollbars driven by that class are gone.\n\n**`.invert` Tailwind utility added** to the About window stylesheet. Elements with `class=\"invert\"` will now render as photographic negatives — used for adapting icons between light and dark themes.\n\n**`data-highlighted` outline styles added** to Quick and Find-in-Page windows. Highlighted menu items now get a 1px inset solid outline in either accent or danger color, improving keyboard navigation visibility.\n\n---\n\n### Dependency Updates\n\n**`tar` pinned to `7.5.7`** (was `^7.4.3`). Locked to an exact version for reproducible installs — likely to pick up a specific fix or avoid a known regression.\n\n---\n\n### Installation\n\n#### APT (Debian\u002FUbuntu - Recommended)\n\n```bash\n# Add the GPG key\ncurl -fsSL https:\u002F\u002Faaddrick.github.io\u002Fclaude-des","2026-03-06T04:49:17",{"id":242,"version":243,"summary_zh":244,"released_at":245},213315,"v1.3.17+claude1.1.4498","# Wrapper Update: v1.3.17+claude1.1.4498\n\nThis release updates the wrapper\u002Fpackaging only — the upstream Claude Desktop version is unchanged.\n\n## Changes since v1.3.16+claude1.1.4498\n\n- chore: remove debug logging from triage workflow (5d42e1c)\n- Revert \"chore: temporarily add triage workflow for testing\" (1cadf80)\n- fix: handle plain text output from investigation step (fd5bc3a)\n- fix: robust JSON parsing and include CLAUDE.md context (55dd4ec)\n- fix: use file-based prompt for comment generation (c1c8223)\n- chore: temporarily add triage workflow for testing (cad0a0b)\n- feat: add workflow_dispatch trigger for testing triage workflow (8dd1977)\n- feat: add automated issue triage workflow (22cbe76)\n- fix: translate VM guest paths for skills\u002Fplugins in cowork mode (d7a4606)\n- chore: update flake.lock (2706698)\n- fix: serialize APT\u002FDNF gh-pages pushes and harden retry logic (4093324)\n- docs: remove redundant NixOS flake reference from Acknowledgments (2742523)\n- chore: fix flake-lock workflow nits and add typedrat to contributors (c964827)\n- feat: add weekly flake.lock update workflow (84dc717)\n- fix: address PR review feedback for Nix flake integration (6a3aae6)\n- fix: bundle tray icons inside asar and correct resourcesPath for Nix (573f052)\n- fix: allow unfree evaluation for flake package outputs (99c9f75)\n- refactor: simplify nix integration and fix node-pty\u002Ftray bugs (9fe293d)\n- fix: copy locale JSON files into Nix package resources (cbc9fd7)\n- feat: add node-pty Nix derivation for terminal support (caa58ca)\n- fix: add real aarch64-linux SRI hash for Nix derivation (55f7b27)\n- docs: add NixOS build instructions to BUILDING.md (f914c17)\n- docs: add NixOS flake notes to CLAUDE.md (fa709ca)\n- docs: add NixOS flake installation instructions to README (d72f791)\n- feat: update CI to bump Nix package on version change (97098e5)\n- chore: generate flake.lock (0bbcf78)\n- chore: add Nix result symlinks to .gitignore (8fce8e5)\n- feat: add FHS-wrapped claude-desktop for MCP server support (233911b)\n- fix: resolve Nix sandbox build issues (daf87a3)\n- feat: add Nix derivation for claude-desktop (ff9fd3d)\n- feat: add flake.nix with flake-parts (d7606aa)\n- feat: add --build nix mode and NixOS detection (bd5a096)\n\n---\n\n## Installation\n\n### APT (Debian\u002FUbuntu)\n\n```bash\n# First time? Add the repo:\ncurl -fsSL https:\u002F\u002Faaddrick.github.io\u002Fclaude-desktop-debian\u002FKEY.gpg | sudo gpg --dearmor -o \u002Fusr\u002Fshare\u002Fkeyrings\u002Fclaude-desktop.gpg\necho \"deb [signed-by=\u002Fusr\u002Fshare\u002Fkeyrings\u002Fclaude-desktop.gpg arch=amd64,arm64] https:\u002F\u002Faaddrick.github.io\u002Fclaude-desktop-debian stable main\" | sudo tee \u002Fetc\u002Fapt\u002Fsources.list.d\u002Fclaude-desktop.list\n\n# Install or update:\nsudo apt update && sudo apt install claude-desktop\n```\n\n### DNF (Fedora\u002FRHEL)\n\n```bash\n# First time? Add the repo:\nsudo curl -fsSL https:\u002F\u002Faaddrick.github.io\u002Fclaude-desktop-debian\u002Frpm\u002Fclaude-desktop.repo -o \u002Fetc\u002Fyum.repos.d\u002Fclaude-desktop.repo\n\n# Install or update:\nsudo dnf install claude-desktop\n```\n\n### AUR (Arch Linux)\n\n```bash\nyay -S claude-desktop-appimage\n```\n\n### Manual Download\n\nDownload `.deb`, `.rpm`, or `.AppImage` from the assets below.\n","2026-03-03T23:51:24"]