2026 Windows 上装 Claude Code 和 Codex，真正容易踩的坑不是命令：是把旧教程、官方能力和第三方中转混成了一条线

Windows 用户过去装 Claude Code 确实比 Mac 麻烦。

但这种教程最容易出现一种危险：产品已经升级了，文章却把某个阶段的安装方式写成永久事实。

源素材试图修正旧教程，方向是对的，但重新对照 2026-08 当前官方文档后，里面仍然混合了三种东西：

• OpenAI Codex 官方 Windows App；
• Anthropic Claude Code 官方 Windows 支持；
• cc-switch / 中转 / 国内模型等社区兼容层。

如果不把三条链分开，教程很快又会过时。

一、Codex：Windows App 已经是官方事实

OpenAI 在 2026 年 2 月推出 Codex App，3 月 4 日更新为 Windows 正式可用。

所以“Windows 用户必须 npm/WSL 才能用 Codex App”已经不成立。

Windows App 的稳定原则是：

官方安装来源 → OpenAI 账号 → 项目权限 → Sandbox/Computer Use → Review

而不是复制某条第三方安装命令。

还有一个值得记住的教训：2026 年 7 月，OpenAI 开发者社区出现过 WinGet 命令可能匹配到同名第三方 QR Reader 的反馈。

这说明安装命令也要验证 Publisher。

不要因为命令来自教程就闭眼回车。

二、Claude Code：源文“完全不需要 Git/Node/WSL”写得太满

Anthropic 当前官方 Setup 文档仍明确：

Windows 10+ 支持：

• WSL 1/2；
• 或 native Windows + Git for Windows。

主安装流程仍展示 npm 安装，并把 Windows native 场景和 Git Bash 关系写得很清楚。

这和源文“一行 PowerShell 原生安装、不需要 Git、不需要 Node、普通用户完全忽略 WSL”的绝对表述并不完全一致。

官方文档可能继续演进，所以正确写法不是争论哪条命令永远正确，而是做：

Install Surface Matrix

记录： Product / OS / Official Install / Prerequisite / Shell / Update / Sandbox / Verified Date。

这样下个月 installer 变了，方法仍能更新。

三、安装成功不等于认证可用

Claude Code 官方使用仍受账户计划、Console/API、支持地区、网络和企业供应商路径影响。

源文有一句“国内用户地区天然不满足，用国内厂商就绕开”。

这不能原样保留。

如果服务有 Supported Countries / Regions，不能把“改上游模型/改 base URL”自动理解成获得了原服务在不支持地区的使用资格。

技术能连上，和合同/地区允许，是两层。

四、第三方模型接入：Gateway 与“官方支持任意模型”不同

Anthropic 官方确实提供 LLM Gateway 文档。

它支持通过代理层做认证集中管理、预算、日志和路由。

但官方对 LiteLLM 这类第三方 gateway 也写得很清楚：Anthropic 不维护、不审计其安全或功能。

而且官方文档核心仍是 Claude 模型通过不同基础设施/代理访问。

因此 cc-switch 能否把 DeepSeek / Kimi / GLM 请求转换进去，属于社区兼容事实。

不是：

> Anthropic 官方支持 DeepSeek 作为 Claude Code 模型。

这两个句子必须分开。

五、Provider Routing Contract

任何“把 X 模型接进 Y Agent”的教程，都先画链路：

Client → Local Config → Gateway/Proxy → Protocol Translation → Upstream Provider → Model → Tool Calls → Response Translation → Client

然后每层记录：

Maintainer / Auth / Secret / Logging / Compatibility / Failure / Update / Fallback。

这样 404、工具调用失真、模型列表异常时，用户才能定位，而不是重装。

六、Secret Gate 比安装命令更重要

源文里 API Key、base URL、中转站很多。

真正成熟的教程必须回答：

• Key 是谁的？
• Key 存在哪？
• 中转能不能看到请求？
• 会不会记录源代码？
• 能不能轮换？
• 失窃怎么撤销？
• 中转商倒闭怎么迁移？

一个便宜的模型入口，如果把整个私有代码库发送给不透明的中转层，成本可能远高于省下的 token。

七、Windows 新手最稳的顺序

Codex

• 确认 OpenAI 官方 Windows App 页面和 Publisher；
• 安装；
• 登录自己的账号；
• 用测试项目；
• 保持默认安全边界；
• 再扩展 Skills / Computer Use。

Claude Code

• 打开当前官方 Setup；
• 确认 Windows 当前支持路径；
• 准备官方要求的 Git/WSL/Node/installer 条件；
• 运行当前诊断；
• 通过官方账户、Console 或官方企业平台认证；
• 用测试仓库；
• 再考虑第三方 gateway。

这个顺序没有“一键安装”爽，但不会把官方和第三方混成一团。

八、Mac 也不是“天然没有风险”

Mac 安装顺，不代表：

• Key 更安全；
• gateway 更可信；
• full access 更合理；
• third-party route 更官方。

平台差异主要是安装和 sandbox surface。

安全原则不变。

九、什么时候不应该上第三方模型

如果任务涉及：

• 公司私有代码；
• 客户数据；
• 生产密钥；
• 财务系统；
• 未公开产品；

优先使用你能审计合同、数据保留和安全边界的官方/企业路径。

第三方 gateway 更适合：

• 低风险实验；
• 自有无敏感代码；
• 明确可回滚；
• 已理解日志/数据去向。

十、这条素材真正沉淀什么

不是“Windows 安装保姆教程”。

而是：

AI Coding Install & Provider Contract

字段：

Product / Surface / OS / Official Install / Publisher / Prerequisites / Auth / Region / Provider / Gateway / Secret / Sandbox / Data Path / Fallback / Verified Date。

它直接增强 Codex / Claude Capability Drift Monitor。

最后

AI 编程工具变化太快。

最危险的教程不是“旧”，而是：

> 把某个时间点的成功配置，写成没有日期、没有边界、没有维护者的永久真理。

命令会变。

官方、社区、权限、数据和失败边界，必须一直分开。