近来, 好多朋友都在询问我，可不可以推出一期Claude Code的新手指南教程。
(资料图)
他们也想用上这个世界上最牛逼的Agent产品。
并且实际上好多人并不怎么清楚, Agent产品通常是由Agent框架以及模型构成的, Claude的模型在国内确实会被封禁，会变得极其难以处理, 我也压根没有任何法子能教大家去搞定。
Claude Code不会被封禁开云app在线入口,开云真人官方下载，也不会出现无法使用的情况, 这是由于它实际上是一个Agent框架, 它能够与任何模型搭配起来进行使用。
尽管Anthropics着实很让人恼火, 天天进行封号操作，还弄实名认证开云真人app官网登录app，然而我仍旧不得不去承认，现在世界上存在的Agent框架, 却是Claude Code。
所以，我常年都在讲，要是能够一步做到位呢哪怕就一下做到位，我当然是晓得如今像什么OpenClaw、Hermers Agent等等这些可火可火了但是，我依旧还是会去建议你去使用Claude Code，就算是没办法用到Claude的原生模型, 你搭配上一款国产的模型，那效果也照样会很不错的。
不用担忧被封号，无需外国手机号, 不用visa卡, 甚至连魔法都不用上。
因此今日, 要来一篇Claude Code的自零起步全方位新手教程, 而且尽可能使所有朋友，均可使用，针对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安装。
在macOS上, Homebrew是命令行包管理器，其作用在于，能让你通过一条命令, 去安装各类软件, 去更新各类软件，去卸载各类软件, 还能安装各类开发工具，更新此类开发工具，卸载此类开发工具。
这里，我借了一台新电脑, 是我们经纪小伙伴的，没有魔法, 环境十分干净。
我们首先来进行brew的安装操作，看上去也许会有这样一种感觉，那就是显得有些复杂，然而实际上呢，只要你依照步骤去做, 它会是极端简单的。
把下面这行命令粘贴到命令行，回车运行。
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
看到提示之后，我们直接回车。
然后他就会跑啊跑啊。
耐心等待几分钟，等他跑完，出现安装成功就装好了。
下一步, 我们要将homebrew添加至路径变量之中, 如此一来, 当我们于终端运用homebrew时, 它方可寻得命令。
把这几行命令粘贴到终端里跑一遍。
这样，我们就可以使用homebrew来管理Mac包了。
随后，使用下面这一行命令去安装Claude code，在此处由于公众号编辑器会自动更改一些格式, 直接进行复制粘贴会出现报错状况。麻烦大家手动敲一下，又或者发送给claude让其修改之后, 再粘贴至终端。
使用brew, 来实行安装, 要选择cask, 针对claude-code，版本是最新的那个版本。
这里的安装速度有点慢，大家可以先去抹灰鱼，忙完了回来看。
等安装成功呈现出来, 我们于终端键入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限定为https，claude.ai的install.ps1链接获取，iex执行，通过管道符连接, 最终执行操作。
等一会就安装好了。
非常便捷。
如果没魔法的话，我们就得使用WinGet来安装。
在终端中运行这行命令。
通过winget来安装, 安装的是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这个操作, 接着，运行brew 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 Code。
我自己就分了一下目录，文稿是我拿来做知识创作了。
此外存在一个code文件夹，其下方放置的皆是经由我独立开发的各式各样的产品。
面向一个命令行，于命令行里启动Claude Code，这也尤为简便。
就是cd命令，这块Mac和Windows是一样的。
比如我要进入知识库这个文件夹进行创作。
那便开启终端，键入cd, 而后务必记着按一下空格世界杯2026直播平台，接着将你的文件夹, 径直拖入其中。
按下回车，就算是进入这个文件夹了。
然后这个时候再用命令启动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交流即可，你把自身的需求, 以及自己所在意的事情，跟它探讨一番，让它给你撰写一份便可以了。
这几天, 我自己也在认真地跟我的 Claude Code 制定各类规范, 把我之前遗留下来的那些杂乱无章像屎山一样的东西进行整理。
那如果你的电脑上现在还什么都没有的话，那就更方便了。
这也是我一直强调约束先行、规范先行的原因之一。
约束定好了，那就真的可以开始玩起来了。
而skills，plugins，常用命令、功能这些。
就此我这里不再予以展开, 我先前也撰写过诸多与之相关的文章, 对于那些感兴趣的小伙伴而言，可直接依照去对应着所要搜索的关键词就可以了。
写在最后
终究是把那篇拖延了极为漫长时间的, 拥有保姆级别的Claude Code教程给撰写完成了。
我向你推荐的当前AI版本的毕业工具, 是Claude Code。
你完全没必要动用各类纷繁复杂、杂乱无章的那些Agent，将Claude Code运用得恰到好处，你事实上就能够切实体会到，何为最为厉害的Agent了。
希望大家都能愉快创造。
做出这个时代。
属于你自己的作品。
标签： ClaudeCode 小白教程 Agent框架 模型接入 开发工具
还木有评论哦，快来抢沙发吧~