🖥️ Claude / Codex 桌面版安装指南

下载完不知道怎么装？先选对系统，再跟着下面走就好～ 命令行安装看 AI 编程。

📦 先选安装包

软件	Windows	Mac	去哪里下
Claude 桌面版	.msix	.dmg，通用版，M 芯片和 Intel 都能装	Claude 网盘
Codex 桌面版	.msix	.dmg，仅限 M 芯片	Codex 网盘

Codex 文件夹里还有 Windows 命令行版 zip。想装桌面版就选 .msix，别拿错啦。

安装包来自开源镜像项目 Wangnov/claude-app-mirror 和 Wangnov/codex-app-mirror，每天自动更新到最新版。

版本号怎么不一样？

Windows 和 Mac 来自不同官方上游，版本号不完全一致是正常的。

🪟 Windows：.msix 怎么装？

Windows 10 / 11 都按这几步来：

1. 双击下载的 .msix 文件。
2. 弹出「应用安装程序」后，点「安装」。
3. 装好后，在开始菜单里找 Claude 或 Codex。

双击没反应，或提示找不到应用安装程序？去 Microsoft Store 搜索并安装「应用安装程序（App Installer）」，再双击一次。

也可以打开 PowerShell 安装，把路径换成自己的文件：

Add-AppxPackage -Path "下载的文件.msix"

🍎 Mac：装好却打不开？

先确认下载的包适合自己的芯片。M 芯片和 Intel 别下错，Codex 的 Mac 包是 M 芯片专用。

提示	怎么办
「无法验证开发者」	在「访达」里右键 App，选「打开」；或到「系统设置 → 隐私与安全性」点「仍要打开」
「已损坏」	在终端执行下面的命令，再打开 App

xattr -cr /Applications/应用名.app

把「应用名」换成实际名称。

只对信任的安装包操作

上面的命令只对你信任的安装包使用，别对来路不明的 App 照抄。

🔑 登录账号，还是接 API？

Claude 桌面版

用 Claude 账号登录。

想用 Maru Code 中转？可以用 CC Switch 管理 Claude Desktop 的供应商。打开 CC Switch，找「Claude Desktop」供应商页。

Codex 桌面版

可以用 ChatGPT 账号登录，也可以接 API：

1. 按 Maru Code 接入教程，在用户级 config.toml 写入 openai_base_url。
2. 完全退出并重开 Codex。
3. 在界面里填自己的 Key。

用 API Key 时选 Codex 模式

「Work 模式」要求官方账号，用 API Key 时可能报账号认证错误。切到 Codex 模式，再新建对话就好。

🩹 Codex 桌面版常见坑

一直卡在 Reconnecting

多半是网络。打开上网工具后重试。

Windows 找不到命令行 / CODEX_CLI_PATH 失效

先在 Codex 设置里点「修复」。仍不行，再打开 PowerShell 找 codex.exe：

Get-ChildItem "$env:LOCALAPPDATA" -Recurse -Filter codex.exe -ErrorAction SilentlyContinue | Select-Object -ExpandProperty FullName

把找到的完整路径填进下面命令，再执行：

[Environment]::SetEnvironmentVariable("CODEX_CLI_PATH", "上面找到的完整路径", "User")

设置完完全退出并重开 Codex。

菜单里没有新模型

在用户级 config.toml 把 model 改成新模型名。命令行也可以指定：

codex --model 模型名

把「模型名」换成想用的新模型名。桌面版跟进新模型通常比命令行慢一点。

更新后反而出问题

可以先回退到上一个版本。网盘只留最新版，旧版去对应镜像项目的 GitHub Releases 找：

Claude 旧版 Codex 旧版

🎮 桌面版 vs 命令行，选哪个？

对比	桌面版	命令行
上手难度	点界面操作，更直观	要打开终端、输入命令
适合谁	想先装好、用界面聊天和操作的新手	习惯终端、想用命令操作的人
能不能接 API	可以，Claude 用 CC Switch 管理供应商；Codex 按上文配置	可以，配置看 Maru Code 教程

想用命令行？安装步骤在 AI 编程。遇到其他红字，先看报错速查，慢慢来～

🔗 下载与求助入口

网盘 Claude 网盘 Codex Claude 镜像 GitHub Codex 镜像 GitHub CC Switch 报错速查