安装指南

WinCode 支持 Windows、macOS、Linux 三个平台。本文介绍各平台的安装方式与系统要求。

当前版本

• 版本号：3.0.1
• 发布日期：2026-07-06

下载地址

不确定 macOS 芯片类型？点击左上角  →「关于本机」，芯片显示 Apple M... 为 Apple Silicon，Intel 则为 Intel 版。

系统要求

Windows 安装

1. 点击上方表格下载链接，获取 Win-Code_3.0.1_x64-setup.exe
2. 双击运行安装向导，选择安装语言（简体中文 / English）
3. 选择安装路径，默认 C:\Program Files\Win-Code
4. 安装模式为「为本机所有用户安装」(perMachine)，需要管理员权限
5. 安装完成后自动启动 WinCode

安装向导会提示：
- 语言选择 → 简体中文
- 安装路径 → 默认即可
- 完成 → 启动 WinCode

macOS 安装

1. 根据芯片类型下载对应的 DMG：
   • Apple Silicon → Win-Code-3.0.1-aarch64.dmg
   • Intel → Win-Code-3.0.1-x86_64.dmg
2. 打开 DMG，将 WinCode 拖入 Applications 文件夹
3. 首次打开时，若系统提示"无法验证开发者"，前往 系统设置 > 隐私与安全性 点击「仍要打开」
4. 应用启动后会自动最大化窗口

⚠️ 重点提示：清除 macOS 隔离属性（xattr）

从内网下载的 DMG 安装包会被 macOS 自动打上 com.apple.quarantine 隔离标记（Gatekeeper 机制），即使拖入 Applications 后仍可能被系统拦截、提示"已损坏"或"无法打开"。

推荐做法：打开 DMG 之前，先在终端对 DMG 文件本身清除隔离标记：

# 替换为实际下载路径
xattr -d com.apple.quarantine ~/Downloads/Win-Code-3.0.1-aarch64.dmg
xattr -d com.apple.quarantine ~/Downloads/Win-Code-3.0.1-x86_64.dmg

如果已经拖入 Applications 仍被拦截，对应用本体再执行一次：

sudo xattr -rd com.apple.quarantine /Applications/Win-Code.app

💡 参数说明：

• -d：删除指定属性；-r：递归处理（针对 .app 目录）
• 执行后再次双击启动即可，无需重启电脑
• 此操作仅影响本应用，不会降低系统整体安全性

Linux 安装

AppImage（推荐）

chmod +x Win-Code_x.x.x_amd64.AppImage
./Win-Code_x.x.x_amd64.AppImage

AppImage 无需安装，直接运行。

DEB 包（Debian / Ubuntu）

sudo dpkg -i win-code_x.x.x_amd64.deb
sudo apt-get install -f  # 修复依赖

安装后在应用菜单中找到 WinCode 即可启动。

首次启动注意

首次启动时，WinCode 会自动下载并准备运行环境（Node.js 和 Claude Code Sidecar），这个过程需要网络连接。详见 首次启动与 Sidecar 准备。

如果公司网络需要代理，请确保系统代理设置正确，应用会自动使用系统代理。

自动更新

WinCode 内置了自动更新机制。应用启动后会检查内部更新服务器，当有新版本时，标题栏会出现更新提示，点击即可下载并安装。更新采用增量方式，下载体积较小。

相关文档

• 首次启动与 Sidecar 准备
• 更新日志
• 什么是 WinCode