最近不少朋友问能不能出一期Claude Code的小白教程。他们也想用上这个号称最牛的Agent产品。
但一搜教程，全是让你开魔法、用国外信用卡、搞实名认证的——门槛高得吓人。其实很多人没搞清楚，Agent产品通常是框架+模型的组合。Claude的模型在国内确实难搞，但Claude Code这个框架本身是开放的，你可以给它接任何模型，包括国产的。
所以今天这篇，就是为国内环境量身定制的Claude Code从零入门教程。Mac和Windows都有，有魔法和没魔法的方案也分开说。下面的安装流程，是我们团队在不同电脑上反复测试、删掉重装好几轮才敲定的最稳路径。
只希望你跟着走，都能用上这个顶级的AI编程框架。
一、Claude Code是什么？为什么选它？
Claude Code是Anthropic推出的命令行AI编程助手。它不像网页聊天框，而是直接跑在你的终端里，能读取整个项目、修改代码、运行命令、跟开发工具深度集成。
简单说，它像个能直接操作你代码库的AI同事。
为什么推荐它？三个原因：
- 框架本身足够强：上下文理解、文件操作、工具调用这些底层能力，Claude Code是目前做得最扎实的。
- 模型可替换：你用不了Claude官方模型，没关系。接上GLM-5.1、MiniMax M2.7这些国产模型，效果依然能打。
- 没有封号风险：不用国外手机号、不用Visa卡，甚至可以不挂代理。完全本地化的部署路径。
能一步到位，就别在二流工具上浪费时间。
二、安装Claude Code（Mac & Windows）
1. macOS安装
有魔法的情况（最简单）：
打开终端，粘贴下面命令：
curl -fsSL https://claude.ai/install.sh | bash
等它跑完，如果提示要把 ~/.local/bin 加到PATH，就按它给的命令执行一下。最后验证：
claude --version
看到版本号就成功了。
没魔法的情况（用Homebrew）：
先装Homebrew（如果已有可跳过）：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
装完后，把Homebrew加到PATH（终端会提示你复制哪些命令，照着做就行）。
接着装Claude Code：
brew install --cask claude-code@latest
安装可能有点慢，耐心等。完成后同样用 claude --version 验证。
2. Windows安装
Windows必须先装Git，因为Claude Code底层用Git Bash执行命令。
装Git（如果已有可跳过）：
用WinGet（Windows官方包管理器）装：
winget install Git.Git
有魔法的情况：
在终端（PowerShell或CMD）运行：
powershell
irm https://claude.ai/install.ps1 | iex
没魔法的情况：
winget install Anthropic.ClaudeCode
装完后，必须配置PATH，否则系统找不到 claude 命令。
Claude Code的可执行文件默认在 C:\Users\你的用户名\.local\bin。把这个路径加到系统环境变量的Path里（具体操作：系统属性 → 高级 → 环境变量 → 编辑Path → 新建）。
加完重启终端，再运行 claude --version 验证。
三、接入小豆包中转API大模型
框架装好了，还得给它接个“脑子”。这里推荐用cc-switch，一个图形化工具，能让你在Claude Code里一键切换不同模型。
1. 安装cc-switch
macOS：
brew tap farion1231/ccswitch brew install --cask cc-switch
Windows：
直接去 GitHub Releases 下载安装包，双击安装。
2. 配置GLM-5.1
打开cc-switch，点击右上角加号，选择“自定义配置”。
需要填的就两项：
- URL：小豆包官方url
- API Key：去令牌页申请
- 模型配置：选自己希望接入的模型
其他选项工具会自动填充，点“添加”就行。
配置好后，在cc-switch里选中这个配置，点“启用”。
3. 解决常见报错
如果你遇到 400 thinking type should be enabled or disabled 错误，是因为新版Claude Code默认发送的 adaptive 思考类型，第三方API不支持。
解决办法：在Claude Code里运行 /config 打开设置，在“环境变量”里添加：
{ "claude_code_disable_adaptive_thinking": "1" }
保存后重启Claude Code即可。
四、启动与基本使用
1. 第一次启动
在终端输入：
claude
第一次会有些初始化设置：
- 选颜色主题（以后可用
/theme改） - 安全提示（仔细读，这是保护你代码的）
- 确认当前目录是否可信（选“是”）
然后你就进入Claude Code的对话界面了。
2. 针对项目启动
建议不要在根目录直接启动，而是针对具体项目文件夹启动，这样上下文更干净，AI也更专注。
cd /你的项目路径 claude
更推荐用这个命令启动，省去频繁点“允许”：
claude --dangerously-skip-permissions
（注意：这跳过了权限提示，只在你完全信任的目录下用）
3. 切换模型
在cc-switch里配置好多个模型后，在Claude Code里用 /model 命令就能实时切换。
五、最佳实践：让你的Claude Code更顺手
1. 写CLAUDE.md（最重要的一步）
CLAUDE.md是Claude Code的“宪法”，告诉它你的编码习惯、项目规则、安全红线。
全局CLAUDE.md（~/.claude/CLAUDE.md）：适用于所有会话，放跨项目的通用规则。
项目CLAUDE.md（项目根目录/CLAUDE.md）：针对当前项目的特殊约定。
一个简洁的全局CLAUDE.md模板：
## 关于我 [你的身份/职业]。我用Claude Code做[用途1]和[用途2]。 ## 思维原则 所有决策从问题本质出发，不因“惯例如此”照搬。 回到问题本身：要解决什么？最直接的路径是什么？ 不要谄媚。不要夸我的想法好、不要说“这是个很好的问题”。 给我真实判断，方案有问题直接指出来。 ## 约束先行 无论开发项目还是知识管理项目，第一步永远是建规则。 新项目先写CLAUDE.md，新目录先定结构约定。 没有规范的工作空间不动手。 ## 沟通方式 - 默认中文，代码、命令、变量名用英文 - 结论先行，再给理由 - 遇到模糊需求，先给最合理的方案，再问要不要调整 ## 自主边界（红线，必须先问我） 以下操作即使在auto-accept模式下也必须停下来问我： - 删除文件、目录或git历史 - 修改.env、密钥、token、CI/CD配置 - 数据库schema变更或数据迁移 - git push、git rebase、git reset --hard、强制推送 - 安装新的全局依赖或修改系统配置 - 公开发布（npm publish、部署到生产、发文章等）
核心原则：CLAUDE.md不是越长越好，超过80行Claude就开始遗漏内容，最多别超过100行。只放它迷糊的那些边界规则。
2. 配置权限
刚装好时，Claude Code每次执行命令都要你确认，很烦。用 /permissions 命令，把你信任的工具（比如 npm run lint、git commit）加入允许列表，以后就不会再问了。
对于需要高度隔离的场景，可以用 /sandbox 开启沙箱模式。
3. 使用MCP服务器
Claude Code支持Model Context Protocol，能连外部工具：
# 连接Playwright（浏览器自动化） claude mcp add playwright npx @playwright/mcp@latest # 连接Sentry（错误监控） claude mcp add --transport http sentry https://mcp.sentry.dev/mcp
连上后，你就能让Claude直接查Sentry错误、用Playwright做自动化测试了。
4. 创建Skills
Skills是Claude Code的“技能包”，把常用工作流固化下来。
在 .claude/skills/ 下新建目录，里面放 SKILL.md：
--- name: fix-issue description: 修复GitHub issue的标准流程 --- 1. 用 `gh issue view` 获取issue详情 2. 理解问题 3. 搜索相关代码文件 4. 实现修复 5. 写测试验证 6. 确保代码通过lint和类型检查 7. 写清晰的commit信息 8. 推送并创建PR
以后遇到issue，直接运行 /fix-issue 1234 就行。
六、避坑指南
- Windows提示“bash不是内部命令”：重新安装Git for Windows，安装时务必选择“Use Git from the command line”。
- 环境变量设置了但没生效：Windows要用
setx设置，设置后必须重启终端。macOS/Linux写进~/.zshrc或~/.bashrc后记得source。 - 返回401 Unauthorized：检查cc-switch里的API Key格式，确保目标平台支持Bearer Token认证。
- 终端频繁断连：可能是网关超时，在cc-switch配置里调高
timeout到120秒，开启keep_alive。 - 代码块不闭合/格式错乱：在CLAUDE.md里强化格式约束，或换用qwen-coder、deepseek-coder等针对代码优化的模型。
七、写在最后
Claude Code是我目前最推荐的AI编程工具，没有之一。
它可能不是最简单的，但绝对是上限最高的。一旦跑通安装、接上模型、定好规范，你会发现很多原本需要几小时的工作，现在几分钟就能搞定。
这套方案的核心优势就三个字：可控性。你不用依赖任何不稳定服务，所有组件都在自己手里。模型效果不好？换一个。框架更新了？自己决定升不升。
这才是AI时代开发者该有的姿势——不是被动等喂饭，而是主动搭建自己的生产力基础设施。
希望这篇保姆教程，能帮你顺利上车。做出你自己的作品。
