部署指南
本部分介绍如何在不同平台安装和启动 Claude Code、Codex CLI、Codex Desktop、OpenCode。内容仅覆盖本地安装、版本检查和首次启动，不包含服务接入与模型配置。
平台支持总览
| 工具 | Windows | macOS | Linux |
|---|---|---|---|
| Claude Code | 支持原生安装，也支持 WSL | 支持 | 支持 |
| Codex CLI | 支持 PowerShell 原生安装，也支持 WSL2 | 支持 | 支持 |
| Codex Desktop | 支持 | 支持 | 暂无 Linux 桌面版 |
| OpenCode | 推荐 WSL，也支持 Chocolatey、Scoop、npm 等方式 | 支持 | 支持 |
安装前准备
CLI 工具通常需要一个可用的终端环境。建议提前安装 Git，并在需要使用 npm 安装方式时先完成 Node.js 环境安装。
选择工具
常见问题
提示找不到命令
请先关闭并重新打开终端，然后再次运行版本检查命令。如果仍然失败，检查安装目录是否已经加入 PATH，或重新执行对应平台的安装命令。
Windows 安装脚本无法执行
请确认当前使用的是 PowerShell 还是 CMD，并复制对应命令。PowerShell 如果提示脚本策略限制，可以使用对应工具文档中的 ExecutionPolicy ByPass 安装命令，或在确认风险后调整本机策略。
不确定应该选择 CLI 还是桌面版
偏好终端、需要轻量快速启动时，优先选择 Claude Code、Codex CLI 或 OpenCode。需要同时管理多个任务线程、查看图形化差异和使用桌面工作流时，优先选择 Codex Desktop。