Claude Code 国内使用完全指南：无需魔法，从零安装到接入国产模型全流程
近期很多朋友都在询问能否推出一期 Claude Code 的小白教程，大家都渴望体验这个全球顶尖的 Agent 产品。
事实上，许多人并不了解 Agent 产品通常由 Agent 框架与模型两部分构成。Claude 的原生模型在国内确实容易受到限制，处理起来非常棘手，我目前也无法提供相关的指导。
不过，Claude Code 本身并不会被封禁或无法使用，因为它本质上是一个 Agent 框架，可以搭配任意模型工作。
尽管 Anthropic 的策略相当严格，频繁封号且推行实名认证，但不得不说，当今最优秀的 Agent 框架依旧是 Claude Code。
所以我一直主张，既然选择就一步到位。我知道像 OpenClaw、Hermers Agent 等工具最近很火爆，但我依然会建议你使用 Claude Code。即使无法调用 Claude 的原生模型，搭配国产模型，效果照样出色。
而且完全不必担忧封号，无需境外手机号或 Visa 信用卡，甚至不需要借助任何特殊的网络环境。
于是，今天我就来撰写一篇 Claude Code 从零入门的全面新手教程，力求让几乎所有朋友都能顺利上手。无论是 Windows 还是 Mac，有没有特殊网络条件，我都准备了相应方案，大家根据自己的情况按需查阅即可。
接下来的安装流程，是我和团队成员花了一个周末，在五六台电脑上反复安装、卸载验证出来的。对于没有特殊网络环境的情况，本来还有其他安装途径，例如 npm 或者直接 curl 国内镜像源，这些方法虽然理论可行，但我在不同设备上测试时稳定性并不理想。最终，我选择了在我看来最简单、并且在极度干净的电脑上也不易出错的方案。
只希望各位跟着文章操作，都能顺畅地用上全球最强大的 Agent 框架。我会尽可能把每一步都讲得细致清晰，可能略显啰嗦，还请见谅。
好了，我们直接开始。
第一步：安装 Claude Code
Mac 系统安装
先来看 Mac，Windows 用户可以跳过这部分直接去后面找 Windows 教程。
我们先在应用程序中找到“终端”并打开。
接下来安装今天的主角——Claude Code。为了演示，我特意在我的电脑上新建了一个全新的 macOS 账户，基本等同于一台空白电脑。
先说拥有特殊网络环境的情况。
安装命令只有一行：
curl -fsSL https://claude.ai/install.sh | bash
在终端中粘贴这条命令，然后按下回车。
等待片刻，就能看到安装成功的提示。
虽然安装好了，但有时可能会弹出这样一个提示：
大意是，Claude Code 已经安装就位，但安装路径 ~/.local/bin 尚未添加到你的 PATH 环境变量中，所以直接输入 claude 可能会找不到命令。提示还说明如何解决，请执行下方给出的那条命令。
看不懂也没关系，我们就照它说的，把那一长串 echo 命令复制进终端，回车执行。
然后输入 claude --version，如果有版本号输出，就表明安装成功了。
有网络环境的情况非常简单，但我清楚许多人并不具备这样的条件。
因此，如果没有特殊网络环境，我们可以通过 Homebrew 来安装。
Homebrew 是 macOS 上最流行的命令行包管理器，可以让你用一条命令就安装、更新或卸载各种软件和开发工具。
这里我借用了一台同事的新电脑，没有任何特殊网络环境，系统非常干净。
我们首先安装 Homebrew，过程看着也许略显复杂，但跟着做其实特别简单。
把下面这行命令粘贴到终端，回车运行。
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
看到提示后，直接按回车。
接着它就会开始运行。耐心等待几分钟，当出现安装成功的字样时，就装好了。
下一步，我们需要将 Homebrew 添加到路径变量中，这样在终端使用 brew 命令时才能被找到。
把图中这几行命令粘贴到终端并执行。
这样，我们就可以用 Homebrew 来管理 Mac 上的软件包了。
接下来，用下面这行命令来安装 Claude Code。注意，由于公众号编辑器可能会自动修改部分格式，直接复制粘贴可能会报错，麻烦大家手动输入，或者发给 AI 助手让它调整后再粘贴到终端。
brew install --cask claude-code@latest
此处安装速度稍慢，大家可以先去摸鱼，忙完再回来查看。
等安装成功出现后，在终端输入 claude，就能看见可爱的小螃蟹图标了。
但这里会显示暂时无法使用，可以先放一放，稍后我们会教大家如何接入模型。
Mac 部分说完，接下来单独讲一下 Windows，操作会稍有不同，已经装好的 Mac 用户可以跳过这部分。
Windows 系统安装
再来看 Windows 平台。我特意找了一台刚重置过的 Windows 电脑来演示一遍。
由于 Claude Code 在 Windows 内部依赖 Git Bash 执行命令，因此想在 Windows 上使用 Claude Code，必须先安装 Git。
所以第一步，先把 Git 装上。已经装好的朋友可以跳过这节。
我们使用 WinGet——Windows 官方的包管理器，可以理解为 Windows 版的 Homebrew。
在任务栏搜索“终端”并打开。
将下方的命令粘贴到终端，安装时不使用特殊网络环境速度反而会更快。
winget install Git.Git
执行完毕就会显示安装成功。
Git 装好之后，照例先说有特殊网络环境的情况。
这种情况下，我们还是采用官方原生的安装命令。
把命令粘贴到终端：
irm https://claude.ai/install.ps1 | iex
稍等片刻即可完成安装。
非常简便。
如果没有特殊网络环境，则需借助 WinGet 来安装。
在终端中运行这行命令：
winget install Anthropic.ClaudeCode
等待安装成功后，同样输入 claude，即可看到安装成功的界面。
至此，理论上在终端里输入 claude 就能进入 Claude Code 页面了。但是，我们现在只装好了框架，还没给它装上“大脑”，所以暂时还无法工作。
接下来，我们就需要把它的“大脑”接上去。
第二步：接入模型
如果已经拥有 Claude 账号，直接登录即可，这里不再展开。毕竟如果你已经有 Claude 账号，大概也不会来看这篇保姆级教程了……
为了让国内所有朋友都能体验，我以国产模型 GLM-5.1 为例进行演示。GLM-5.1 是我目前体验中认为国内效果最好、最接近 Claude Opus 4.6 感受的模型。
当然，如果你没有抢到他们的 coding plan，使用 MiniMax M2.7 和 K2.5 也都相当不错。K2.6 code 似乎也即将推出，感觉 kimi 也会迎来一波跨越，大家可以关注一下。
对于 GLM-5.1，智谱官方提供了一键式安装命令，非常简单：
npx @z_ai/coding-helper
不过，为了方便大家未来也能接入其他模型并随意切换，这里我教一个更通用的方法：使用 CC Switch。
同样分为 Mac 和 Windows 两种情形。
Mac 下安装 CC Switch
在 Mac 上，安装只需要两行命令。注意第二行同样可能因编辑器格式问题直接复制会报错，建议手动输入或请 AI 帮忙修改再粘贴。
brew tap farion1231/ccswitch
brew install --cask cc-switch
在终端中粘贴并回车运行。
等待安装完成即可。
Windows 下安装 CC Switch
Windows 用户推荐直接前往下方链接下载安装包：
https://github.com/farion1231/cc-switch/releases
如果无法访问 GitHub，我也准备了本地安装包，在公众号后台回复“cc”即可自动获取下载链接。
下载后双击运行，一路“下一步”就能安装完毕。
后续的操作 Mac 和 Windows 一致，不再分开说明。
装好后，我们打开 CC Switch。进入界面就能看到，这个工具不仅适用于 Claude Code，Codex、小龙虾等同样可以使用。
由于我们尚未进行配置，目前只有 Claude 官方的模型配置。在 Claude 那一栏下方，点击右上角的加号，新增模型配置。
然后选择想要使用的模型，以 GLM 国内版为例。
接下来只需填写两部分信息：API key（如果不知道什么是 API Key，可以直接咨询你手头任何可用的 AI，它们会帮你解决）以及模型配置，其余参数工具会自动填充。
填写完毕后，点击右下角的“添加”。
系统就会切换到我们刚刚配置好的模型。
到这一步，Claude Code 的安装和 GLM-5.1 的接入就全部完成了。
第三步：启动 Claude Code
我们回到终端，输入 claude，按下回车。
就能正常启动 Claude Code 了。
首次使用会经历一系列初始化设置。
比如颜色模式，模式下方还有代码预览，大家根据个人喜好选择，按回车确认。以后想修改，在 Claude Code 内运行 /theme 即可。
接着是安全提示。
主要有两点：一是 Claude 可能会出错，它生成的代码或要执行的命令，你都需要过目后再放行；二是只在你信任的代码库中使用 Claude Code，以防范提示词注入攻击。我们直接回车进入下一步。
系统会询问是否采用 Claude Code 的终端设置。
这里推荐直接使用默认的终端设置，它实际上会帮你启用两个功能：一个是用快捷键实现在终端里换行，另一个是 Visual bell（视觉提示），即 Claude 完成任务或需要你确认时，终端窗口的页面会闪烁、Dock 图标会弹跳一下，对你进行提醒。
最后一步，是与你确认当前所在目录是否可以信任。
选择“是”，然后回车。
我们终于来到了接入 GLM-5.1 后的 Claude Code 对话界面。
往后若想切换模型，只需在 CC Switch 中配置好，然后在 Claude Code 内使用 /model 命令即可切换。
至此，全部安装接入操作均已完成。后续使用时，直接在终端输入 claude 就行。
这里强烈推荐搭配下面这行命令，尤其是在开发场景中，否则频繁点击各种“allow”会让你怀疑人生。
claude --dangerously-skip-permissions
另外，在启动时，考虑到上下文设计和专注度，我们需要针对特定文件夹启动，而不是直接在根目录下启动 Claude Code。
举个例子，我自己的目录做了分类：文稿文件夹用于知识创作。
还有一个 code 文件夹，下面存放着我开发的各种产品。
在命令行中针对一个特定目录启动 Claude Code 非常简单，用 cd 命令即可，Mac 与 Windows 操作一致。
例如，我想进入“知识库”文件夹进行创作。打开终端，输入 cd，务必记得加一个空格，然后把目标文件夹直接拖进去。
按下回车，就进入了该文件夹。然后再执行启动命令启动 Claude Code。
这样，Claude Code 就只会在这个文件夹范围内工作，并默认读取其中的所有文件。
这样做上下文污染更小，注意力更集中，换言之，它会更聪明。
第四步：编写 CLAUDE.md
学会启动之后，其实你就可以开始正式对话，随意让它干活了。但在深度使用前，有一个很重要的规范习惯，我觉得很有必要让你预先设置好，以免重蹈我走过的弯路——那就是先定好你的 CLAUDE.md 文件。在我看来，这甚至是学会启动 Claude Code 之后第一件该做的事。
在给出具体写法之前，我还是先聊聊 CLAUDE.md 究竟是什么。
它不仅仅是一个文件，而是一个自上而下、分层穿透的约束体系，正如我此前用过的一张图所示。
刚安装完毕，我们应该先管理两个层面：全局 CLAUDE.md 和项目 CLAUDE.md。
全局 CLAUDE.md 放置在用户主目录的 Claude Code 根目录下，即 ~/.claude/CLAUDE.md。
无论你打开 Claude Code 时进入哪个项目，它都会被自动加载并遵守，这是顶层规范。它能解决“你是谁”、“你做事的原则”、“你希望他以什么方式与你协作”这类问题。
项目级 CLAUDE.md 则放在每个项目的根目录下，路径为 项目目录/CLAUDE.md。
它只有在你打开该项目时才会被加载，负责解决这个具体项目该如何推进、有哪些特殊约定等问题。
我们首先来看全局 CLAUDE.md，这也是第一个要确定的东西。但到底该往 CLAUDE.md 里写什么、怎么写、写多长、放在哪，很多人其实并不清楚。对于非开发者，我也分享一下我的心得。
关于长度，CLAUDE.md 并非越长越好，反而务必追求精简。如果写得太长，后半部分的内容 Claude 很可能会直接忽略。具体的红线是：超过 80 行，Claude 开始遗漏部分内容；无论如何，绝对不能超过 200 行。
之前的一篇文章中，我曾分享过自己的全局 CLAUDE.md 文件内容。在此基础上，我又进行了迭代，为大家准备了一份模板，涵盖了我认为一份优秀全局 CLAUDE.md 应该具备的要素。大家只需在“关于我”部分填上自己的内容，其余基本可以直接套用。
## 关于我[你的名字 / 身份 / 职业背景，非程序员的话一定要写出来]。我用 Claude Code 做 [具体用途 1] 和 [具体用途 2]。
## 思维原则所有决策从问题本质出发，不因「惯例如此」照搬。回到问题本身：要解决什么？最直接的路径是什么？从零设计会怎么做？不要谄媚。不要夸我的想法好、不要说「这是个很好的问题」、不要开头加「当然可以」。给我真实判断，方案有问题直接指出来。发现更好的做法直接说，不用等我问。
## 约束先行无论开发项目还是知识管理项目，第一步永远是建规则：新项目先写 CLAUDE.md，新目录先定结构约定（什么放哪、怎么命名、何时清理）。没有规范的工作空间不动手。已有规范的项目，严格遵守其 CLAUDE.md 中的约定。需要调整规范时先改文档、再改实践，不要反过来。
## 沟通方式- 默认中文，代码、命令、变量名用英文- 结论先行，再给理由，不要先铺垫背景- 遇到模糊需求，先给最合理的方案，再问要不要调整- 不要问「你确定要这样吗」，除非命中下方红线
## 自主边界（红线，必须先问我）以下操作即使在 auto-accept 模式下也必须停下来问我：- 删除文件、目录或 git 历史- 修改 .env、密钥、token、CI/CD 配置- 数据库 schema 变更或数据迁移- git push、git rebase、git reset --hard、强制推送- 安装新的全局依赖或修改系统配置- 公开发布（npm publish、部署到生产、发文章等）
## 通用工程纪律- 改完主动跑验证（具体命令见各项目 CLAUDE.md），不要只改不验- 不要为了让代码跑起来注释掉报错或加绕过标记，找根本原因- 密钥、token、密码不进代码、不进 commit、不进日志- 大改动前先在 Plan Mode 出方案，我确认后再动手
全文只有 30 多行，分为六个部分，这些部分都有一个共同点：跨项目通用。
全局的 CLAUDE.md 定好之后，顶层的规范就有了。至于下一层，项目 CLAUDE.md，我以自己为例来说明。
我主要用 Claude Code 进行开发和知识管理。比如在我的 code/my 目录下就有一个 CLAUDE.md，它的作用在于：my 文件夹下常常存放着一些一次性的、实验性质的零碎代码，体积都很小，所以我实在懒得每次都新建一个子文件夹。
我现在的常用做法是，直接 cd 到 my 文件夹启动，然后愉快地提需求让它帮我 coding。有了这个 CLAUDE.md 文件后，它就会自行判断这是不是一个新产品，如果是，就直接帮我新建一个文件夹开始工作，这样整个文件管理就变得井井有条了。
而这个文件其实完全不用你自己动笔，直接打开对应文件夹，然后和 Claude Code 聊天就行。把你的需求、你在意的事项与它探讨，让它给你生成一份 CLAUDE.md 便大功告成。
我本人这几天也在认真地与我的 Claude Code 一起制定各种规范，整理过往遗留的“屎山”。如果你的电脑目前还什么都没有，那就更方便了。这也是我一直强调“约束先行、规范先行”的原因之一。
约束定好之后，就真的可以愉快地玩起来了。至于 skills、plugins、常用命令等内容，这里就不再展开，我已经写过许多相关文章，感兴趣的朋友可以直接搜索关键词查看。
终于写完了这篇拖了很久的 Claude Code 保姆级教程。
Claude Code，就是我推荐给你的当前 AI 时代的毕业级工具。你无需再去折腾各种五花八门的 Agent，只要用好 Claude Code，就能真正体会到什么是最强大的 Agent。
希望大家都能愉悦地创造，做出属于这个时代、属于自己的作品。