国内使用Claude Code的保姆级教程：从安装到配置模型

最近很多朋友都在问我，能不能出一期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。 brew install --caskclaude- code 这里的安装速度有点慢，大家可以先去抹灰鱼，忙完了回来看。 等安装成功出现，我们在终端输入claude，就能看到小螃蟹了。 但是这里，会显示用不了，可以先不管，一会我们会教大家怎么接上模型。 mac说完了，然后在单独说一下Windows，会稍微有一点点不一样，安装好的Mac同学可以直接跳过这一趴。 2. Windows 再来看Windows。 我这里拿了一台刚刷机过的Windows来装了一遍。 因为Claude Code在Windows上内部是用Git Bash来执行命令的，所以要想在Windows上用Claude Code，必须先把Git安装上。 所以第一步，我们先把Git装上。 已经装好的朋友可以跳过这一趴。 用WinGet来装，这个东西是Windows官方的包管理器，可以理解成Windows版本的Homebrew。 我们在任务栏搜索终端打开。 粘贴下面的命令到终端，这里安装的时候不开魔法速度会快很多。 wingetinstall Git.Git 跑完就会显示成功安装了。 Git装好了之后，老规矩，我们先说有魔法的情况。 有魔法的朋友，我们还是用他官方的原生安装命令。 粘贴命令到终端。 irmhttps://claude.ai/install.ps1 | iex 等一会就安装好了。 非常便捷。 如果没魔法的话，我们就得使用WinGet来安装。 在终端中运行这行命令。 wingetinstall 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上，他的安装就两行命令。 brew tap farion1231/ccswitchbrew install --caskcc- 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，常用命令、功能这些。