本文提供从零开始的Claude Code安装教程，适用于Mac和Windows系统。无需魔法、无需外国手机号或Visa卡，支持接入国产模型（如GLM-5.1）。包含有/无魔法环境下的安装方式、模型配置、CLAUDE.md规范等完整步骤，适合希望使用顶级Agent框架的国内开发者。
Tags:
最近很多朋友都在问我，能不能出一期Claude Code的小白教程。
他们也想用上这个世界上最牛逼的Agent产品。
而且其实很多人不太知道，Agent产品一般是Agent框架+模型组成的，Claude的模型国内确实会封，会非常的难搞，我也没有任何办法教大家弄。
但Claude Code不会被封，也不会用不了，因为这玩意其实就是个Agent框架，搭配任何模型都可以使用。
虽然Anthropics确实很狗，天天封号，又搞实名认证，但我依然不得不承认，这个世界上目前最好的Agent框架，还是Claude Code。
所以我常年说，能一步到位就一步到位，我当然知道现在比如什么OpenClaw、Hermers Agent等等非常火，但是我还是依然会建议你使用Claude Code，即使用不了Claude的原生模型，你搭配个国产模型，效果也依然很好。
而且也不用担心封号，不需要外国手机号，visa卡，甚至都可以不上魔法。
所以今天，就来一篇Claude Code的从0入门全面新手教程，并且尽可能让所有的朋友，都可以用上，Windows和Mac，有魔法没魔法的操作，我都准备了，大家按需看对应的部分就行。
下面的安装流程，是我一整个周末，跟我们小伙伴一起，折腾了五六台电脑反复安装卸载试出来的。
比如有些场景，像没有魔法，其实还有其他安装方式，像npm，又或者直接curl国内镜像源，这些办法其实也能用，但我在不同电脑上测试的时候并不够稳定。
所以最后，我选了在我看来最简单，并且在极度原始的电脑上测试也不容易翻车的方式。
只希望大家跟着文章，都能顺利地用上世界上最牛逼的Agent框架。
我会把每一步都给大家说得尽量详细清楚，可能会有些啰嗦，大家别介意。
好了，我们直接开始。
一. Claude Code 安装
1. Mac
先来看Mac，Windows同学可以直接跳过Mac这一趴去下面找Windows的教程。
我们先在App中找到终端打开。
我们先来安装一下今天的主角，Claude Code。
这里我给自己的电脑新建了一个全新的macOS账号，基本等同于空电脑，方便演示。
先聊有魔法的情况。
命令就一句话。
curl -fsSL https://claude.ai/install.sh | bash我们在终端粘贴这条命令后，按下回车。
等一会，就能看到安装成功。
虽然装好了，但这里有可能他也会给出一个提示。
意思是说，Claude Code已经装好了，但Claude Code的安装位置~/.local/bin还没加到你的PATH环境变量里，所以你直接敲claude可能找不到这个命令。
还说要解决这个问题，请执行下面那条命令巴拉巴拉。
看不懂也没关系，我们就按他说的，把他给出的那一长串echo命令复制到终端里，回车跑一下。
然后输入claude --version，有版本号输出，就表示安装成功了。
有魔法的情况非常简单，但是我也知道，很多同学是没有魔法的。
所以，如果没有魔法的话，我们可以通过homebrew安装。
Homebrew是macOS上最流行的命令行包管理器，作用是让你用一条命令就能安装、更新、卸载各种软件和开发工具。
这里我借了一台我们经纪小伙伴的新电脑，没有魔法，环境非常干净。
我们先来装一下brew，看着可能会有点复杂，但是其实你跟着做，特别简单。
把下面这行命令粘贴到命令行，回车运行。
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"看到提示之后，我们直接回车。
然后他就会跑啊跑啊。
耐心等待几分钟，等他跑完，出现安装成功就装好了。
下一步，我们需要把homebrew加到路径变量里面去，这样我们在终端使用homebrew的时候他才能找到命令。
把这几行命令粘贴到终端里跑一遍。
这样，我们就可以使用homebrew来管理Mac包了。
接着，用下面这行命令来装Claude code，这里因为公众号编辑器会自动改一些格式，直接复制粘贴会报错。辛苦大家手敲一下，或者发给claude让他改了，再粘贴到终端。
brew install --cask claude-code@latest这里的安装速度有点慢，大家可以先去抹灰鱼，忙完了回来看。
等安装成功出现，我们在终端输入claude，就能看到小螃蟹了。
但是这里，会显示用不了，可以先不管，一会我们会教大家怎么接上模型。
mac说完了，然后在单独说一下Windows，会稍微有一点点不一样，安装好的Mac同学可以直接跳过这一趴。
2. 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也会有一波飞跃，推荐大家可以蹲一下。
然后GLM5.1这块，智谱官方有提供一句话命令来安装，特别简单。
npx @z_ai/coding-helper但这里，为了方便大家也能接入其他模型并且随意切换，所以，我们教大家一个更通用的方法，也就是，用CC Switch。
还是分Mac和Windows。
1. Mac
在Mac上，他的安装就两行命令，第二行命令同样因为格式原因，直接复制粘贴会报错。辛苦大家手敲一下，或者发给claude让他改了，再粘贴到终端。
brew tap farion1231/ccswitchbrew install --cask cc-switch
在终端粘贴，回车运行。
等他装好就成了。
2. Windows
Windows的话，推荐直接去下面的链接下载安装包。
https://github.com/farion1231/cc-switch/releases
如果你进不去github，那我也给大家准备好了本地安装包，你对着公众号后台回复cc就会自动给你发下载链接了。
下载后双击运行，然后可以一路next到底，就安装好了。
后面的操作Mac和Windows一样，就不分开说了。
装好后，我们打开他。
一进去能看到，这玩意其实不仅适用于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.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.md写得太长，后半段的内容它会直接忽略掉。
具体的红线数字是这样的，超过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文件夹下，经常coding的都是一些可能一次性的、或者我实验性质的乱七八糟的东西，其实都非常的小，所以我真的懒得每次都在my下新建一个文件夹。
所以我现在常用的做法，就是直接cd到my文件夹启动，然后愉快的开始说出我自己的需求帮助我coding，那有了这个CLAUDE.md文件之后，他就会自己判断这是不是一个新产品，如果是的话，那就直接帮我新建一个文件夹开始做，这样整个文件管理，就会变得井井有条了。
而这个文件其实也完全不用你自己写，你就直接打开那个文件夹，然后和Claude Code聊就行，你直接把你的需求，和你在意的事情，和他探讨，让他给你写一份就OK了。
我自己这几天也在好好跟我的Claude Code制定各种规范，整理我之前遗留下来的各种屎山。
那如果你的电脑上现在还什么都没有的话，那就更方便了。
这也是我一直强调约束先行、规范先行的原因之一。
约束定好了，那就真的可以开始玩起来了。
而skills，plugins，常用命令、功能这些。
我这里就不展开了，我也写过了很多相关的文章，感兴趣的小伙伴可以直接去对应着搜索关键词就行。
写在最后
终于把这篇拖了很久很久的保姆级Claude Code教程写完了。
Claude Code，就是我推荐你的当前AI版本的毕业工具。
你根本无需使用各种乱七八糟的那些Agent，用好Claude Code，你就真的能感受到，什么是最牛逼的Agent了。
希望大家都能愉快创造。
做出这个时代。
属于你自己的作品。
以上，既然看到这里了，如果觉得不错，随手点个赞、在看、转发三连吧，如果想第一时间收到推送，也可以给我个星标⭐～谢谢你看我的文章，我们，下次再见。
>/ 作者：卡兹克，tashi
>/ 投稿或爆料，请联系邮箱：wzglyay@virxact.com
