★ 前言
5岁小朋友都能看懂的Claude Code/Codex 安装部署指南 Windows 装 Claude Code 和 Codex 没那么难——2026年的门槛已经被磨平，一条命令搞定，小白也能用。
@ai_suxiaole
5岁小朋友都能看懂的Claude Code/Codex 安装部署指南
Window装 Claude Code 比 Mac 难得多 2026 年起，门槛已经被磨平 一行命令搞定，小白也能上手 读完你也能用上最先进AI工具
前阵子有个不写代码的朋友想装 Claude Code，他用的是 Windows，自己跟着网上的教程一路折腾 WSL、Node.js，弄了一晚上还是没跑起来，最后放弃了
Claude Code 这东西对非技术人员来说门槛还真不低
，一般人按着网上的教程多半装不上。
网上现有的教程大多还是今年年初写的，里面那一套 "必须 WSL + Node.js" 的流程
Claude Code 在 2025 年下半年已经支持 Windows 原生安装
，一行 PowerShell 命令就能搞定，根本不需要 WSL。
Codex 这边今年初 OpenAI 出了桌面客户端。Windows 用户在 Microsoft Store 装一个 App 就能用，不用再走 npm 那一套了。
1 一、Claude Code 是什么
简单介绍一下 Claude Code —— Anthropic 官方的 AI 编程工具，支持 Windows/Mac/Linux 原生安装。
Mac 用户的简版流程（苹果电脑装起来更省事，可以一起看）
简单介绍一下 Claude Code
Claude Code 是 Anthropic 官方出的命令行 AI 编程工具。
跟 Cursor 这种 IDE 不一样，它就是一个跑在终端里的 Agent，你在哪个项目目录启动它，它就在哪个项目里读文件、改文件、跑命令、写测试。
：PowerShell、CMD、Git Bash 都行
：可以自己规划、自己执行、自己纠错
支持 Skills、MCP、子 Agent
：把工作流封成一个个能力调用
原生支持 Windows / Mac / Linux
：以前 Windows 用户必须 WSL，现在不用了
要用 Claude Code，你需要下面任意一种账户：
的 Pro / Max / Team / Enterprise 订阅
Anthropic Console 账号（API Key 计费）
国内大模型厂商的 Coding Plan
（智谱 GLM、Kimi、DeepSeek 等，后面会讲）
账号是用不了 Claude Code 的。
2 二、Claude Code Windows 原生安装
三种安装方式：PowerShell 原生安装（推荐）、WinGet、npm。一条命令搞定，不需要 WSL。
国内用户最稳的路径其实是第三种，
智谱、Kimi、DeepSeek 这几家都做了 Anthropic 协议的原生兼容，国内直连不用梯子，价格比官方便宜，速度也快。
安装应用（Windows 原生）
先看一下你的电脑能不能装：
国内用户【地区】这条天然不满足，但走国内厂商接入就绕开了这个限制，后面会讲。
，最快最省心，而且会自动后台更新。
方式 A：PowerShell 原生安装（推荐）
先确认你打开的是 PowerShell，不是 CMD。
判断方法：看终端提示符是不是 PS C:\Users\xxx>，前面有 PS 两个字母就是 PowerShell。
irm 是 Invoke-RestMethod 的缩写，把官方安装脚本拉下来直接执行。，也不需要你提前装 Node.js，所有依赖脚本自己处理。
装完后你会看到提示重启终端。
方式 B：CMD 原生安装
如果你打开的是 CMD（提示符是 C:\Users\xxx>，没有 PS），用这条命令：
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmdPowerShell 和 CMD 的命令
，混用会报【'irm' is not recognized】或者【'&&' is not a valid statement separator】这种错。
不知道自己是哪个 Shell 的话，看提示符开头就行。
方式 C：WinGet 安装
WinGet 是 Windows 自带的包管理器，Windows 11 默认有，Windows 10 需要更新到比较新的版本。
winget install Anthropicwinget upgrade Anthropic方式 D：npm 安装（不推荐）
如果你已经装了 Node.js 18+，想用 npm 装也行：
npm installg @anthropic-ai/claude-code
但这个方式问题最多：依赖 Node 环境、不会自动更新、有 PATH 问题。
除非你有特殊需求，不然没必要走这条路。
升级的话记住别用 npm update -g，要用：
npm installg @anthropic-ai/claude-code@latest
很多旧教程要求装 WSL，那是 2025 年上半年还没有原生支持时的方案。
现在不用 WSL 了，直接原生装就行。
只有这两种情况你才需要 WSL：
你要用 Linux 工具链（Docker、特定的命令行工具）
你需要 Claude Code 的沙箱安全特性（Native Windows 还不支持沙箱）
普通用户完全可以忽略 WSL。
关于 Git（可选但推荐）
很多人会问：我又不会用 Git，是不是也要装？
装 Claude Code 和 cc-switch 都不需要 Git。
不过 Claude Code
之后，跟 Git 有一层弱关系，装了体验会好一截：
官方推荐装 Git for Windows
装也很简单，一行 WinGet 搞定：
winget install Gitgit-scm.com
装好之后什么都不用配，Claude Code 下次启动会自动检测到。
提示：如果你 Git for Windows 装在了非默认路径，需要在 %USERPROFILE%\.claude\settings.json 里手动指：
"CLAUDE_CODE_GIT_BASH_PATH"
"C:\\Program Files\\Git\\bin\\bash.exe"
先把当前终端窗口关了再开一个新的
PATH 环境变量是新开的窗口才会刷新，原来的窗口里 claude 这个命令找不到。
新开 PowerShell 后输入：
能看到版本号就装好了。
接着跑一下诊断，强烈建议：
claude doctor这条命令会检查你的安装类型、版本、PATH、依赖项，有问题它会直接告诉你。
诊断没问题就可以登录了：
第一次跑会自动弹浏览器，让你 OAuth 授权登录。
的 Pro / Max 订阅用户，直接登录就完事，不用管 API Key。
如果你是 Console 账号用 API Key 计费，登录时选 API Key 那一项，把 Key 粘进去就行。
如果你打算走国内厂商的接入
3 三、cc-switch：一键切换 API 供应商
接入国内大模型（GLM、Kimi、DeepSeek），告别手动改 JSON 配置文件，一键切换多家供应商。
（智谱、Kimi、DeepSeek），这一步可以先跳过，等下一章用 cc-switch 配好之后直接切过去。
装好之后，常见的几个坑
坑 1：`claude : The term 'claude' is not recognized`
PATH 没刷新，重启终端能解决。
如果重启了还不行，手动加一下 PATH：
[Environment]
::SetEnvironmentVariable
:USERPROFILE\.local\bin"
[EnvironmentVariableTarget]
:USERPROFILE\.local\bin"
坑 2：安装命令报红，curl 失败 / 403
挂上代理（全局模式）再执行安装命令。
，可以走 WinGet 安装（微软源国内能通）：
winget install Anthropic装完工具本身之后，配国内厂商的 API，使用阶段全程不需要梯子。
坑 3：图片粘贴 Ctrl+V 不行
这是 Windows 原生版的一个已知问题（截至 2026-02 还存在）。
直接拖到 Claude Code 窗口里
在提示词里写文件路径：请看这张图: C:\Users\xxx\screenshot.png
用 cc-switch 接管 API
装完 Claude Code，如果你有官方账号，已经能用了。
但如果你有下面任意一个需求，就需要再装个 cc-switch：
你想用国内模型厂商接入（智谱 / Kimi / DeepSeek），不想手改配置文件
你想同时挂多家厂商，按需切换（白天用智谱，晚上用 Kimi）
你既有 Claude 官方账号，又用着国内模型
你还要顺手管 Codex、Gemini CLI 这些其他工具
你想要系统托盘里一键切（不用打开任何应用）
farion1231/cc-switch
）是国内开发者做的开源桌面应用，到 2026 年 6 月已经迭代到 v3.16.4，GitHub Stars 10w+，国内用 Claude Code 的人基本都装它。
你今天想用智谱 GLM，得手动改 ~/.claude/settings.json 里的 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN，存盘，重启终端。
明天想试试 Kimi，再改一次。
后天 DeepSeek 出了新版本想对比一下，又改一次。
每改一次就要担心 JSON 格式有没有错、有没有把别的配置删了。
cc-switch 就是把这套来回改 JSON 的流程变成了图形化、点几下就完事的事。
而且它不只管 Claude Code，把 Codex、Gemini CLI、OpenCode、Hermes、Claude Desktop、OpenClaw 七个工具都管了。后面讲完 Codex 安装，你也可以拿 cc-switch 来管 Codex 的多个供应商。
安装 cc-switch
GitHub Releases 页面
Windows 用户看到两个包：
普通用户下 .msi 双击安装就行。
公司电脑没安装权限的、或者不想留卸载残留的，下 .zip 解压到任意目录运行。
Windows 用户首次打开 .msi 可能弹【Windows 已保护你的电脑】，因为开发者没买 EV 签名证书，点【更多信息】→【仍要运行】就行。
打开 cc-switch，你会看到主界面分上下两块：上面是工具选项卡（Claude Code、Codex、Gemini CLI 等），下面是该工具的供应商列表。
首次启动它会自动读取你已有的 `~/.claude/settings.json`，作为【默认供应商】存起来。
这样你原来的配置不会丢，装完就能用。
要加新的供应商，点右上角【添加供应商】。
弹窗里你会看到几个关键字段：
：随便起，自己看得懂就行（比如【智谱 GLM】）
：内置 50+ 服务商预设，国内主流厂商基本都有现成的，挑你的服务商，剩下的字段它自动填好
：厂商给你的接入地址（如果没用预设，自己填）
API Key / Auth Token
4 四、推荐供应商：GLM / Kimi / DeepSeek
三家国内供应商的注册、获取 API Key、cc-switch 配置全流程。
：厂商的 Key，这里有个选择题。
如果你厂商文档里给的环境变量名是 ANTHROPIC_API_KEY，那这里选【API Key】。
如果给的是 ANTHROPIC_AUTH_TOKEN，选【Auth】。
这是新手最容易踩的坑。
国内主流厂商（智谱、Kimi、DeepSeek）官方都用 ANTHROPIC_AUTH_TOKEN，这里
统一选 Auth 就对了
如果你的厂商还要求填模型名称（比如对 Haiku / Sonnet / Opus 做了别名映射），展开【更多】把模型名填进去就行。
填完点【保存】，回到主界面，新供应商就在列表里了。
切换有两种方式，挑你喜欢的。
供应商列表里点你要切的那个，点【启用】。
Claude Code 不用重启终端就立即生效
，这是它的特性，cc-switch 用了【热切换】机制。
其他工具（Codex、Gemini CLI 这些）切换后需要重启 CLI 才能生效。
cc-switch 在右下角系统托盘有图标。
右键托盘图标，会展开当前应用的所有供应商，鼠标一点就切了，
如果你之前登录过 Claude 官方账号，又切到国内厂商了，想再切回官方：
在 cc-switch 里添加一个【Claude 官方登录】的预设供应商（预设里有现成的）
在终端跑一次 claude logout，再跑 claude 重新走 OAuth 登录
之后你就能在官方账号和国内厂商之间随便切了
Codex 用户还可以在多个官方账号之间切（多个 Plus 或 Team 账号），同一个原理。
cc-switch 默认会
把你的 MCP、Skills、Hooks 这些通用配置统一管理
，切换供应商时不会丢。
但如果你某次发现切完供应商插件没了，去【编辑供应商】→【通用配置面板】，点【从当前供应商提取】，把通用数据提到【通用配置】里。
5 五、cc-switch 附加功能
MCP 管理、Skills 安装、用量统计、云同步、一键配置导入等实用功能。
之后新建供应商时勾选【写入通用配置】（默认是勾的），切过去插件就还在。
完整走一遍：接入国内模型厂商
挑国内三家主流厂商各走一遍，你照着选一家就能用。
Anthropic 协议的官方兼容
，不是第三方中转，直接对接厂商自己的 API，国内直连不用梯子。
选项 A：智谱 GLM Coding Plan
智谱的 GLM-4.7 是目前国产编程模型里第一梯队的，有专门的 Coding Plan 套餐。
第一步：开通套餐拿 Key
进入【个人编程套餐】→【套餐概览】，选一个套餐订阅（个人版从一杯奶茶钱起步）。
订阅完后在套餐页面新建一个 API Key，复制好。
团队版套餐用户要在【团队编程套餐 → 我的套餐】里拿团队专用 Key，跟个人 Key 不通用。
第二步：在 cc-switch 添加
打开 cc-switch → Claude Code 选项卡 → 【添加供应商】。
供应商列表点【智谱 GLM】→【启用】，立刻生效。
PowerShell 里跑 claude，进入后随便问一句，能回上来就接通了。
智谱 Coding Plan 套餐用量上限内不额外计费，超出按 token 算。我自己日常就挂着这个。
选项 B：Kimi K2.7 Code（Moonshot）
Kimi 最新的 K2.7 Code 是编程专用模型，相较前代 K2.6 推理 token 消耗少了约 30%，按 token 算下来更省。
6 六、Codex Windows 安装
OpenAI 的 Codex 客户端，Microsoft Store 直接安装，图形界面更友好。
platform.kimi.ai/console/api-keys
，注册登录后创建一个 API Key。
强烈建议先去【Project Settings】设置每日预算上限。Agent 类工具会自动多轮重试，没设上限可能某天爆账单。
第二步：在 cc-switch 添加
保存，启用，走一句话验证。
选项 C：DeepSeek
DeepSeek 是国内官方直连里价格比较低的一家，适合对预算敏感的用户。
platform.deepseek.com/api_keys
，注册后创建 API Key，充值最低 1 元起。
第二步：在 cc-switch 添加
DeepSeek 把不同档位的模型映射到 Claude 的 Sonnet / Opus / Haiku，这点要注意。简单任务它自动走 Flash 模型省钱。
三家都加进 cc-switch
这就是 cc-switch 比手改 settings.json 强的地方：切换成本降到接近零，你才会真的去用对的模型。
顺手讲讲 cc-switch 的几个隐藏好东西
用着用着你会发现 cc-switch 比单纯的【API 切换器】做得多得多，下面这些功能我自己都在用：
Claude Code 的 MCP 配置在 ~/.claude.json 里，Codex 在 ~/.codex/config.toml 里，Gemini CLI 在它自己的目录里。
每次新加一个 MCP Server 要改三个地方，烦得要命。
cc-switch 左侧【MCP】面板里加一次，勾选要同步到哪些工具，它自动写到对应的配置文件里。
哪个工具不想同步就取消勾选，灵活。
Skills 一键安装
Claude Code 的 Skills 机制是今年下半年新出的，但安装一个 Skills 要 git clone、检查依赖、放到指定目录，对小白不友好。
cc-switch 左侧【Skills】面板里直接填 GitHub 仓库地址，点安装就装好了，也支持本地 ZIP 文件。
装完会自动用软链的方式连到 ~/.claude/skills/，删除时也不会污染原仓库。
跨供应商统计你花了多少钱、用了多少 token、哪天用得最猛。
智谱按套餐、Kimi 按 token、DeepSeek 按 token，三家混着用很容易看不清钱花在哪。
现在底部一栏实时显示当前供应商的余额和今日消耗，超阈值会提醒。
Dropbox / OneDrive / iCloud / 坚果云 / 自建 WebDAV 都支持。
把 ~/.cc-switch/ 目录扔到同步盘里，公司电脑和家里电脑配置自动同步。
Deep Link 一键导入
厂商页面如果做了 ccswitch:// 链接，点一下浏览器会弹【打开 cc-switch】，配置直接灌进来，连 Key 都不用复制。
每次切换或修改配置，cc-switch 都会往 ~/.cc-switch/backups/ 里存一份快照，轮换保留最近 10 份。
哪天手抖删错了，直接从备份恢复，不用从头配。
数据全存在 ~/.cc-switch/cc-switch.db（SQLite），删了软件配置也不丢。卸载 cc-switch 不会动 ~/.claude/settings.json，原来的配置照常工作，删它不会破坏你别的东西。
装个 Codex 桌面客户端
讲完 Claude Code，顺手把 Codex 桌面客户端也装上。
为啥要装这个？两个理由：
7 七、Codex 接入国内中转站
修改 auth.json 和 config.toml，让 Codex 走 OpenAI 协议的国内中转站。
Codex 是 OpenAI 官方的编程 Agent
，跟 Claude Code 是同一个生态位的东西，对比着用能找到各自的强项（我自己的经验是 Codex 写 Python 数据脚本和前端样式比较顺，Claude Code 啃复杂代码库更稳）
Codex 有 Windows 原生桌面 App
，图形界面，对完全不碰命令行的小白比 Claude Code 还要友好一截
订阅要求和 Claude Code 类似：
ChatGPT Plus / Pro / Business / Edu / Enterprise
都自带 Codex 使用额度
OpenAI 平台 API Key
（按 token 计费）
OpenAI 兼容协议的国内中转站
（跟 Claude Code 接国内厂商一个思路，下面会讲怎么配）
ChatGPT 免费账号用不了 Codex。
Codex 跟 Claude Code 不一样，它 Windows 版
只走 Microsoft Store 这一个渠道
，没有 PowerShell 一键脚本可用。
方式 A：Microsoft Store 图形界面（推荐）
开始菜单搜【Microsoft Store】，打开后在顶部搜索 Codex。
国内用户重要提醒：打开 Microsoft Store 前
，全局代理状态下 Store 会卡死打不开或者一直转圈。这个坑挺多人踩。
方式 B：WinGet 命令行
如果你已经习惯命令行，PowerShell 里跑一行：
winget install Codex-s msstore 是指定走微软商店的源，跟方式 A 是同一个包，只是不用打开 Store 界面。
developers.openai.com/codex/app
，点 Download for Windows，浏览器会跳到 Microsoft Store 然后让你装，本质上还是方式 A。
国内有些朋友反馈 Microsoft Store 怎么都打不开，可以尝试控制面板里把 Store 应用重置一下，或者在 PowerShell 里跑 wsreset.exe 清缓存再试。
装完在开始菜单找到 Codex 图标，双击打开。
第一次启动可能会比较慢（首次会下载和初始化运行环境），等一下。
打开之后进入登录界面，三个选项：
走国内中转站的，选第三个
。它会弹个输入框让你填 API Key，
这一步你随便填一串字符就行
8 八、cc-switch 管理 Codex 多供应商
cc-switch 同样支持 Codex 的多供应商切换。
填完点 Continue。
（Engineer / PM / HR 等），随便选一个就行，主要是给 OpenAI 做使用统计的，不影响功能。
再下一步会问要不要打开
Sandbox（沙箱模式）
，建议点 Set up 开启，这样 Codex 帮你跑命令时不会乱动你电脑里项目目录之外的文件。
默认是英文界面，菜单栏
File → Settings → General → Language for the app UI
，下拉里选 Chinese (China)，点保存。
，这个情况不少人遇到。原因是中文语言包是按需联网拉的。
9 九、Windows 端常见排障
网络不通、Store 打不开、安装命令报错等常见问题的解决方案。
挂上梯子重启 Codex
，让它把语言包补全，之后梯子可以关掉，界面会保持中文。
我自己第一次切也没成功，挂了梯子重启一次，界面就自己变中文了，玄学但好使。
配置 API（走 OpenAI 兼容中转站）
如果你登录用的是 ChatGPT 账号或者官方 API Key，这一步可以跳过，已经能用了。
（OpenAI 协议兼容），需要手动改两个文件。
配置文件在 C:\Users\{你的用户名}\.codex\ 目录下，里面会有两个文件：
记事本或者 Notepad++ 打开就能改。
第一步：改 `auth.json`
打开后大致是这样的结构：
"OPENAI_API_KEY"
"sk-xxxxxxx"
把 value 换成你中转站给你的 Key，保存（Ctrl+S）。
第二步：改 `config.toml`
这里是关键，看清楚里面的名字必须三处一致：
model_provider
model_reasoning_effort
model_providers.myrelay
"https://你的中转站地址/v1"
"responses"
10 十、Mac 安装简要
Mac 用户的快速安装指南，Homebrew 一行搞定，Apple Silicon 原生支持。
model_provider（顶层）、[model_providers.xxx] 里的 xxx、以及里面的 name 字段，
，不一致启动就报错。这是音频教程里强调过的最大坑
model：你想默认用的模型名，OpenAI 自家是 gpt-5.5、gpt-5.4 这种，中转站可能有自己的别名，照中转站文档抄
model_reasoning_effort：思考深度，可选 low / medium / high，high 推理更深但更慢更贵
base_url：中转站的 URL，
，别忘了。这是 OpenAI 协议的标准路径，少一截就 404
wire_api：协议类型，OpenAI 官方和大多数中转站用 responses
关掉 Codex 重启一遍
重启不是叉掉窗口就行。Codex 默认是最小化到系统托盘的，叉掉窗口它还在后台跑。
正确做法：右下角托盘图标右键 → Quit / 退出
，然后再从开始菜单打开，配置才会重新加载。
重新打开 Codex，左下角能切模型，
主输入框给它发个【你好】，能正常回复就说明全套配通了。
权限模式建议：日常用【自动批准非危险操作】就行；如果你信得过 Codex 想让它放开手脚，可以开【完全访问】，但前提是 Sandbox 已经把项目目录限制住了。
Codex 是【项目导向】的，你需要告诉它在哪个文件夹里干活。
Add new project
或者按 Ctrl + O，选你的代码目录就行。
加进去后选一个项目进入，左上角确认
是亮着的（意思是【在本地跑】而不是【云端跑】），就可以开始跟 Codex 聊了。
如果你的项目在 WSL 里，可以在文件浏览器地址栏输入 \\wsl$\ 然后挑你的 Linux 发行版和目录。
装几个常用开发工具（可选）
Codex 跟 Claude Code 一样，本机有 Git、Node、Python 这些工具会用得更顺。一行 winget 全装上：
winget installwinget installwinget installwinget installGitHub CLI 装完跑一次 gh auth login 授权一下，Codex 里就能直接做 PR / Issue 操作了。
用 cc-switch 管 Codex 的多个供应商
如果你装了 cc-switch（前面那章讲过），它本身就支持 Codex 这个工具。
打开 cc-switch，顶部 Tab 切到
，下面就是 Codex 的供应商列表。点【添加供应商】，配置方式跟 Claude Code 完全一样，预设里也有常见的 OpenAI 中转站。
11 十一、卸载与清理
完全卸载 Claude Code、Codex、cc-switch 的文件路径和方法。
切换之后跟 Claude Code 有个区别：
Codex 必须重启 App 才能生效
（不是热切换）。cc-switch 里所有非 Claude Code 工具都是这个待遇。
记得重启走【系统托盘 → 退出】，别只关窗口。
下面这些情况国内用户基本都会遇到，提前讲清楚。
Claude Code 安装阶段：网络问题
claude.ai/install.ps1
这个域名国内直连大概率失败，症状是：
PowerShell 报 The remote name could not be resolved
或者 curl: (7) Failed to connect
解决方案按推荐度排序：
1. 用 WinGet 安装（不挂梯子的首选）
WinGet 走的是微软的源，国内能直连：
winget install Anthropic12 写在最后
2026 年，安装门槛已经被压到极低。一条 PowerShell + 一个 Store 安装，就够了。
2. 挂代理走官方脚本
（不是规则模式），再执行官方安装命令。
下载完成后代理可以关掉了，
后续使用国内厂商接入完全不用梯子
3. 走 npm 镜像
如果有 Node.js 环境，可以走 npm 淘宝镜像：
registry https:
npm install
g @anthropic-ai/claude-code
registry https:
Codex 安装阶段：Microsoft Store 问题
Codex 只能从 Microsoft Store 装，所以国内最常遇到的坑是 Store 本身打不开或者下载失败。
如果你 Microsoft Store 怎么折腾都装不上，可以去找【离线安装包】（厂商的 MSIX 文件），但这种渠道质量参差不齐，
优先建议把 Store 修好再装