Claude Code 保姆级实战教程：从安装到权限模式，避开封号坑

Claude Code 正在成为国内程序员日常开发中绕不开的 AI 编程智能体。但很多新手卡在第一步——安装失败、登录被封、权限弹窗不断。这篇教程基于一线讲师的实战演示，把安装、配置、权限模式这几个关键环节拆开讲清楚，帮你少走弯路。

为什么是 Claude Code？

据 B 站马氏兵教育连老师的公开课分析，目前国内大部分公司都在推进 Web Coding，有的要求 50% 代码由 AI 完成，激进一点的甚至达到 90% 到 100%。在 Claude Code、Codex、Cursor、Trae 这几个主流工具中，连老师的个人体验是：如果没有公司层面的强制约束，优先推荐 Claude Code 或 Codex。

这些工具本质上是编程 Agent，没有绝对的好坏，挑顺手的用即可。但 Claude Code 目前的采用面更广，也因此成为教学的首选对象。

安装：为什么推荐 npm 而不是官方脚本

官网提供了 PowerShell 和 CMD 两种安装命令，但连老师明确指出，由于网络环境限制，这两种方式的成功率并不高。他不建议新手去网上抄那些配置 API Key、改环境变量的偏方，"太麻烦"。

更稳妥的路径是走 npm 安装——官网高级设置里其实就写了这条命令。使用前需要两个前置条件：

• Node.js 22 以上版本（目前最新为 24），从官网下载安装包一路下一步即可
• Git，同样是傻瓜式安装

安装过程中必须开启科学上网工具，这是绕不开的前提。连老师提到自己给公司同事装过很多次，走 npm 这条路基本没出过错。

npm（Node Package Manager）是 Node.js 自带的包管理器，也是全球最大的开源软件注册表。Claude Code 通过 npm 分发，意味着安装时只需运行类似 npm install -g @anthropic-ai/claude-code 的命令，npm 就会从注册表拉取包及其依赖，并自动完成版本管理和全局命令注册。相比官方 PowerShell/CMD 脚本直接下载二进制或调用系统组件，npm 路径不依赖特定系统的脚本执行策略，也更容易在失败后重试或回滚。-g 参数表示全局安装，安装后的 claude 命令可在任意目录下调用。

需要注意的是，npm 安装本身仍会访问境外注册表，因此科学上网是前置条件；如果网络不稳定，也可以临时改用国内镜像源（如 npm config set registry https://registry.npmmirror.com），但镜像同步可能有延迟，装不到最新版本。

登录与防封：CC Switch 是关键

首次运行 claude 命令时，会依次让你信任文件夹、选择主题样式、选择登录方式。问题就出在登录这一步——直接使用官方账号登录，被封号的风险很高。连老师坦言自己"之前也被封了很多次"。

解决方案是 CC Switch 这个开源工具。它原本是 GitHub 上的一个项目，现在做成了网站，提供 Windows 的 MSI 安装包。安装后打开，界面里可以针对 Claude Code、Codex 等不同工具分别配置 API Key。

具体操作是：点加号，选择模型供应商（如 DeepSeek^广告），填入自己的 API Key，保存即可。市面上通用的模型供应商基本都覆盖了，找不到的可以用"自定义配置"，填入第三方中转站的 API Key 和请求地址同样能用。配置完成后再启动 Claude Code，登录步骤会被跳过，没有账户自然就不存在封号问题。连老师表示用这种方式"最起码几个月时间没有被封过"。

一个容易踩的坑：CC Switch 里不同工具是分开配置的，在 Codex 里配了 DeepSeek，不代表 Claude Code 能用，切换工具时要记得对应切换配置。

关于科学上网工具，连老师给了一个务实建议：不要买一年期会员，风控变化快，按月买更安全，哪怕单价贵一点。

API Key 是调用大模型服务的凭证，本质上是一串由服务商签发的密钥，请求时放在 HTTP 头（如 Authorization: Bearer <key>）里，服务端据此识别调用者并计费。Claude Code 默认走 Anthropic 官方账号的 OAuth 登录，而通过 API Key 方式接入时，客户端直接把请求发给 Key 对应的服务商（如 DeepSeek 或第三方中转站），Anthropic 侧不参与鉴权，因此不存在“官方封号”的问题。这也是 CC Switch 能绕过登录的根本原理。

“中转站”则是第三方搭建的代理服务，它们持有上游官方或多家的 Key，再按 token 转售给用户，通常兼容 OpenAI/Anthropic 的接口格式。使用中转站的好处是无需自己处理海外支付和注册，代价是稳定性、隐私和合规性由第三方承担，敏感代码不建议走不明来源的中转。

自然语言不是万能药

装好之后，大多数人的第一反应是直接说"帮我开发一个贪吃蛇小游戏"。新版 Claude Code 会追问一些技术选型问题，老版本则直接开写。连老师的评价很直接：这种纯自然语言的提示词"效果一定是非常差的"，token 消耗和时间成本都高。

他用贪吃蛇做了演示，确实能跑起来——这体现了所谓"技术平权"，零基础的人一句话就能做出小工具。但他同时泼了冷水：自己玩没问题，想做成商用产品、想赚钱，没有技术储备做出来的东西 bug 一堆，代码质量堪忧，而且演示中完全没有做 code review。

权限模式：控制 AI 的手脚

生成过程中不断弹出的确认窗口，对应的是 Claude Code 的权限模式。用 Shift+Tab 可以切换，常见的有几种：默认模式每一步都要人工确认，accept 模式自动接受编辑，plan 模式只做规划不动手，auto 模式则放开更多权限。

这背后是 human-in-the-loop 的设计思路——AI 动手之前先让人把关。理解每种模式的边界，才能根据自己的场景在效率和安全之间找到平衡点。连老师后续还会展开讲 MCP、Skills、Subagent 以及 CLAUDE.md 文件的用法，这些才是把 Claude Code 用出效率的关键组件，仅靠自然语言对话远远不够。

对于国内开发者来说，把安装和防封这两步走稳，后面的学习曲线会平缓很多。工具本身只是 Agent，真正拉开差距的是你怎么组织提示词、怎么配置上下文、怎么设计权限边界。

human-in-the-loop（人在回路中）是 AI 系统设计里的一种交互范式：模型不直接执行有副作用的操作，而是先输出计划或工具调用请求，由人确认后再落地。在 Claude Code 中，读写文件、执行 shell 命令都属于有副作用的动作，权限模式就是在调节这条回路闭合的紧密程度——默认模式下几乎每个动作都要人点确认，accept 模式对文件编辑自动放行，plan 模式只生成方案不执行，auto 模式则把更多决策交给模型。

这种设计源于对 Agent 风险的权衡：权限放得越开，效率越高，但一次误判就可能删文件或跑错命令；收得越紧越安全，却会频繁打断心流。实践中常见的做法是在只读探索、写测试等低风险环节用 accept，在涉及数据库、部署、删除操作时退回默认模式，把人的注意力留给真正不可逆的步骤。