乐于分享
好东西不私藏

Claude Code和Codex安装指南:一行命令搞定,小白也能上手

Claude Code和Codex安装指南:一行命令搞定,小白也能上手

关注「苹果黑科技」,获取更多 Mac 使用技巧和 AI 效率工具 🔧

开头大家不要忘记点赞收藏」以免收不到我最新的干货了。

很多人想用 Claude Code 和 Codex 这两个 AI 编程工具,但一搜教程,全是"先装 WSL、再装 Node.js"的老流程,照着做大概率翻车。

2026 年了,门槛早就被磨平了。Windows 一行 PowerShell 指令搞定,Mac 一行终端命令搞定,不需要 WSL,不需要提前装 Node.js。

今天把 Claude Code、Codex、以及国内模型接入方案一起讲清楚。

Claude Code 是 Anthropic 官方出的命令行 AI 编程工具。跟 Cursor 这种 IDE 不一样,它是一个跑在终端里的 Agent——你在哪个项目目录启动它,它就在哪个项目里读文件、改文件、跑命令、写测试。

Codex 是 OpenAI 官方的编程 Agent,有 Windows/Mac 桌面客户端,图形界面,对不碰命令行的人更友好。

两者定位类似,但各有强项:Claude Code 啃复杂代码库更稳,Codex 写前端样式和数据脚本更顺。

使用门槛:

  • • Claude Code:需要 Claude.ai 的 Pro/Max 订阅,或 Anthropic Console 的 API Key,或国内厂商的 Coding Plan
  • • Codex:需要 ChatGPT Plus/Pro 订阅,或 OpenAI API Key,或 OpenAI 兼容的国内中转站
  • • 两者的免费账号都用不了

安装 Claude Code(Windows)

先确认你打开的是 PowerShell,不是 CMD。看终端提示符:PS C:\Users\xxx> 前面有 PS 就是 PowerShell。

推荐:PowerShell 原生安装

一行命令:

irm https://claude.ai/install.ps1 | iex

这个命令会把官方安装脚本拉下来直接执行。不需要管理员权限,不需要提前装 Node.js,所有依赖脚本自己处理。

装完后关掉终端窗口,重新开一个新的(PATH 环境变量要新窗口才刷新),输入:

claude --version

能看到版本号就装好了。再跑一下诊断:

claude doctor

有问题它会直接告诉你。

备选:CMD 安装

如果你打开的是 CMD(提示符是 C:\Users\xxx>,没有 PS),用这条:

curl -fsSL https://claude.ai/install.bat -o %TEMP%\install.bat && %TEMP%\install.bat

PowerShell 和 CMD 的命令不能混用,混用会报错。

备选:WinGet 安装

winget install Anthropic.ClaudeCode

这种方式不会自动更新,手动升级用 winget upgrade Anthropic.ClaudeCode

关于 WSL

很多旧教程要求装 WSL,那是 2025 年上半年还没有原生支持时的方案。现在不用了。

只有两种情况才需要 WSL:你要用 Linux 工具链(Docker 等),或者需要 Claude Code 的沙箱安全特性。普通用户完全可以忽略。

安装 Claude Code(Mac)

Mac 更简单,终端里一行:

curl -fsSL https://claude.ai/install.sh | bash

或者用 Homebrew:

brew install --cask claude-code

装完关掉终端重开,claude --version 验证即可。

安装 Codex(Windows)

Codex 只走 Microsoft Store,没有一键脚本。

推荐:Microsoft Store 安装

开始菜单搜 Microsoft Store,打开后搜 Codex。

⚠️ 国内用户注意: 全局代理状态下 Store 会卡死打不开。这个坑很多人踩。

备选:WinGet 安装

winget install OpenAI.Codex -s msstore

装完在开始菜单找到 Codex 图标打开。第一次启动会比较慢(首次下载初始化运行环境)。

登录界面三个选项:ChatGPT 账号、API Key、OpenAI 兼容中转站。根据你的情况选。

切换中文

菜单栏 File → Settings → General → Language for the app UI,选 Chinese (China)。

如果切完没变中文,重启一次 Codex 让它拉语言包

安装 Codex(Mac)

App Store 搜 Codex,发布者认准 OpenAI,直接装。

或者下官方 DMG:Apple Silicon 版 / Intel 版,去 developers.openai.com/codex/app 下载。

配置文件在 ~/.codex/,改法跟 Windows 一致。

国内模型接入方案

这是国内用户最实用的部分。Claude Code 和 Codex 都能接国内模型,价格更低、速度更快。

看到这里大家给个「点赞」和「收藏」和不过分吧 

Claude Code 接国内厂商

智谱、Kimi、DeepSeek 都做了 Anthropic 协议的官方兼容,国内直连。

推荐用 cc-switch 管理。 cc-switch 是一个开源桌面应用,把"来回改配置文件"变成了图形化操作,点几下就完事。

GitHub 地址:github.com/farion1231/cc-switch

安装 cc-switch:

  • • Windows:GitHub Releases 下 .msi 双击安装,或 .zip 绿色版解压即用
  • • Mac:brew install --cask cc-switch

打开 cc-switch,添加供应商,三家主流厂商选一家:

智谱 GLM: 去智谱开放平台注册,开通 Coding Plan,拿 API Key。cc-switch 里添加供应商,预设选"智谱",填 Key,保存,启用。

Kimi K2.7 Code: 去 platform.kimi.ai 拿 Key。建议先设每日预算上限,Agent 工具会自动多轮重试,没上限可能爆账单。

DeepSeek: 去 platform.deepseek.com 拿 Key,充值最低 1 元起。价格比较低,适合预算敏感的用户。

三家都加进去,按需切换,这就是 cc-switch 的核心价值。

Codex 接国内中转站

改两个文件,都在 C:\Users\{用户名}\.codex\ 目录下(Mac 在 ~/.codex/):

auth.json: 把 value 换成中转站给你的 Key。

config.toml: 关键是三个名字必须一致——model_provider(顶层)、[model_providers.xxx] 里的 xxx、以及里面的 name 字段。不一致启动就报错。

base_url 末尾要加 /v1,这是 OpenAI 协议的标准路径。

保存后重启 Codex。注意:叉掉窗口不等于退出,Codex 默认最小化到系统托盘。要右键托盘图标 → Quit,再从开始菜单重新打开。

常见问题速查

claude : The term 'claude' is not recognizedPATH 没刷新,重启终端。还不行的话手动加 PATH。

安装命令报红 / curl 失败 / 403国内网络问题。WinGet 安装走微软源,或走官方脚本。

图片粘贴 Ctrl+V 不行Windows 原生版已知问题。绕过:试试 Alt+V,或把截图存成文件拖到窗口里。

cc-switch 切换后插件没了去编辑供应商 → 通用配置面板,点"从当前供应商提取",把通用数据提到通用配置里。

Microsoft Store 打不开控制面板重置 Store 应用,或 PowerShell 跑 wsreset.exe 清缓存。

装完之后

Claude Code 和 Codex 都支持 Git 集成、MCP 插件、Skills 扩展。建议装个 Git for Windows:

winget install Git.Git

装好不用配,Claude Code 下次启动会自动检测到。

到这里,两个工具都跑起来了。日常使用走国内厂商接入。

最后大家不要忘记点赞收藏」以免收不到我最新的干货了。

关注「苹果黑科技」,不错过每一篇实用干货。


💬 你在安装过程中踩过什么坑?或者有更好的接入方案?评论区分享一下。