从0开始，在国内用上Claude Code的终极保姆教程来了。 * { margin: 0; padding: 0; outline: 0; } body { font-family: “PingFang SC”, system-ui, -apple-system, BlinkMacSystemFont, “Helvetica Neue”, “Hiragino Sans GB”, “Microsoft YaHei UI”, “Microsoft YaHei”, Arial, sans-serif; line-height: 1.6; } .__page_content__ { max-width: 667px; margin: 0 auto; padding: 20px; text-size-adjust: 100%; color: rgba(0, 0, 0, 0.9); padding-bottom: 64px; } .title { user-select: text; font-size: 22px; line-height: 1.4; margin-bottom: 14px; font-weight: 500; } .__meta__ { color: rgba(0, 0, 0, 0.3); font-size: 15px; line-height: 20px; hyphens: auto; word-break: break-word; margin-bottom: 50px; } .__meta__ .nick_name { color: 576B95; } .__meta__ .copyright { color: rgba(0, 0, 0, 0.3); background-color: rgba(0, 0, 0, 0.05); padding: 0 4px; margin: 0 10px 10px 0; } blockquote.source { padding: 10px; margin: 30px 0; border-left: 5px solid ccc; color: #333; font-style: italic; word-wrap: break-word; } blockquote.source a { cursor: pointer; text-decoration: underline; } .item_show_type_0 > section { margin-top: 0; margin-bottom: 24px; } a { color: 576B95; text-decoration: none; cursor: default; } .text_content { margin-bottom: 50px; user-select: text; font-size: 17px; white-space: pre-wrap; word-wrap: break-word; line-height: 28px; hyphens: auto; } .picture_content .picture_item { margin-bottom: 30px; } .picture_content .picture_item .picture_item_label { text-align: center; } img { max-width: 100%; } .pay_subscribe_notice { margin: 30px 0; padding: 20px; background: fffbe6; border: 1px solid ffe58f; border-radius: 8px; } .pay_subscribe_badge { display: inline-block; padding: 4px 12px; background: faad14; color: fff; border-radius: 4px; font-size: 14px; font-weight: 500; margin-bottom: 12px; } .pay_subscribe_desc { font-size: 15px; line-height: 1.8; color: rgba(0, 0, 0, 0.7); margin-bottom: 12px; } .pay_subscribe_hint { font-size: 13px; color: rgba(0, 0, 0, 0.4); } .__bottom-bar__ { display: flex; justify-content: space-between; align-items: center; position: fixed; bottom: 0; left: 0; right: 0; height: 64px; padding: 8px 20px; background: white; box-sizing: border-box; border-top: 1px solid rgba(0, 0, 0, 0.2); } .__bottom-bar__ .left { display: flex; align-items: center; font-size: 15px; white-space: nowrap; } .__bottom-bar__ .right { display: flex; } .__bottom-bar__ .sns_opr_btn { display: flex; align-items: center; user-select: none; background: transparent; border: 0; color: rgba(0, 0, 0, 0.9); font-size: 14px; } .__bottom-bar__ .sns_opr_btn:not(:last-child) { margin-right: 16px; } .__bottom-bar__ .sns_opr_btn > img { margin-right: 4px; }
从0开始，在国内用上Claude Code的终极保姆教程来了。
原创 数字生命卡兹克 数字生命卡兹克 2026-04-20 10:08 山东
最近很多朋友都在问我，能不能出一期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/ccswitch
在终端粘贴，回车运行。
等他装好就成了。
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应该有的东西。
大家只需要在关于我里面，写上自己的内容，其他基本都是可以直接复用的。
## 关于我
一共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
数字生命卡兹克
 阅读 赞  分享 ‘%3E %3Cg transform=‘translate(0 -2.349)‘%3E %3Cpath d=‘M0 2.349h24v24H0z’/%3E %3Cpath fill=‘%23576B95’ d=‘M16.45 7.68c-.954 0-1.94.362-2.77 1.113l-1.676 1.676-1.853-1.838a3.787 3.787 0 0 0-2.63-.971 3.785 3.785 0 0 0-2.596 1.112 3.786 3.786 0 0 0-1.113 2.687c0 .97.368 1.938 1.105 2.679l7.082 6.527 7.226-6.678a3.787 3.787 0 0 0 .962-2.618 3.785 3.785 0 0 0-1.112-2.597A3.687 3.687 0 0 0 16.45 7.68zm3.473.243a4.985 4.985 0 0 1 1.464 3.418 4.98 4.98 0 0 1-1.29 3.47l-.017.02-7.47 6.903a.9.9 0 0 1-1.22 0l-7.305-6.73-.008-.01a4.986 4.986 0 0 1-1.465-3.535c0-1.279.488-2.56 1.465-3.536A4.985 4.985 0 0 1 7.494 6.46c1.24-.029 2.49.4 3.472 1.29l.01.01L12 8.774l.851-.85.01-.01c1.046-.951 2.322-1.434 3.59-1.434 1.273 0 2.52.49 3.472 1.442z’/%3E %3C/g%3E %3C/g%3E %3C/g%3E%3C/svg%3E) 推荐 ’ fill=‘%23000’ fill-opacity=’.9’/%3E%3C/svg%3E) 留言