Claude Code入门实战：安装配置与防封号完整指南

Claude Code 已经成为不少国内程序员日常工作中的主力编程工具。据这位 B 站 UP 主观察，除少数老旧或小型公司外，多数团队已在推进 AI 编程（vibe coding），有的要求 50% 代码由 AI 实现，有的甚至提到 90% 乃至更高的比例。本文基于其公开课内容，梳理 Claude Code 从安装到基础使用的完整流程，重点讲清楚如何规避账号封禁风险。

编程 Agent 没有绝对好坏，选顺手的即可

目前程序员用得较多的编程 Agent 主要有 Claude Code、Codex、Cursor 等，此外亚马逊的组件、阿里千问的组件也都能用。UP 主个人体验下来的看法是：这类工具本质上都是编程 Agent，没有绝对的好坏之分，关键看你用起来是否顺手。

如果公司没有特别高的约束要求，他的建议是优先使用 Claude Code 或 Codex。上个月出现的 DeepSeek^广告 Harness 也值得尝试。整体来看，当下使用 Claude Code 的人相对更多，因此本次教程以它为主。

课程覆盖的核心内容包括：安装与集成、权限模式与内置命令、MCP、Skills、Subagent（Submit），以及 CLAUDE.md 配置文件的合理利用。UP 主特别指出，很多同学在使用 Claude Code 时只停留在「用自然语言对话」的基础阶段，这样效果并不理想，应该更好地利用工具本身提供的组件来提升效率和生成质量。

安装：为什么推荐 NPM 方式

安装前，UP 主强烈建议每个人都去看一遍官网文档——官网有中文版，讲解清晰。官方提供了多种安装方式，Windows 用户可以在 PowerShell 或 CMD 中执行对应命令。

但问题在于网络环境。由于国内网络限制，通过 PowerShell 或 CMD 直接安装的成功率并不稳定：运营商限制少的可能成功，限制多的则很难装上。UP 主不推荐折腾各种 API 配置、环境变量的替代方案，认为太麻烦。

他推荐的最佳方式是通过 NPM 安装，这也是官网「高级选项」里明确提到的方式。只要配置好 VPN（科学上网），这种方式基本不会失败，他给公司同事和很多学员都装过，至今没遇到过问题。

使用 NPM 安装有两个前置条件：

• Node.js：要求 22 以上版本，直接从官网下载最新版（目前是 24 版本）即可。
• Git：同样从官网下载安装。

这两个都是傻瓜式安装，下载安装包后一路「下一步」即可，C 盘满的话可以更换安装目录。

安装完成后，可以新建一个目录，在该目录打开 CMD，输入 claude --version 验证。如果能正常输出版本号，说明安装成功。首次运行 claude 时，会依次要求你信任当前文件夹、选择配色样式、选择登录方式。

NPM（Node Package Manager）是 Node.js 自带的包管理工具，Claude Code 本质上是一个发布在 npm 公共仓库的命令行软件包。通过 npm install -g @anthropic-ai/claude-code 这类命令，NPM 会从 registry.npmjs.org 下载并全局安装该工具。相比 PowerShell 的 winget 或直接下载二进制文件，NPM 方式的优势在于：依赖版本管理更规范、更新更方便（一条命令即可升级），且 NPM 源在配合 VPN 的前提下连通性更稳定。Node.js 要求 22 以上版本，主要是因为 Claude Code 内部使用了较新的 JavaScript 运行时特性（如原生 fetch API、ESM 模块支持等），旧版本 Node.js 会导致运行报错。

核心技巧：用 CC Switch 绕过账号登录，规避封号

这是整期内容最关键的一点。UP 主明确指出：如果直接用官方登录方式，账号很可能被封——他自己此前就被封过很多次。哪怕在环境变量里配置 API Key 的方式，他也试过一次，结果同样被封。

解决办法是使用一个叫 CC Switch 的开源工具。它现在已经做成了网站，早期是 GitHub 上的开源项目。核心思路是：通过 CC Switch 完成配置后，重新运行 claude 就会跳过官方登录步骤。既然不涉及账号登录，也就不存在账号被封的问题。

配置步骤并不复杂：

• 从官网或 GitHub Release 下载对应系统的安装包（Windows 选 .msi，点击 show all 查看全部版本）
• 双击安装后打开软件
• 点击「+」号，选择模型供应商（如 DeepSeek、智谱等）
• 填入对应的 API Key，点击保存

软件内置了大量主流模型供应商，界面里也能看到 Claude Code、Codex、OpenCode 等不同配置端口，用哪个就选哪个。如果列表里没有你要的供应商，可以选「自定义配置」，填入 API Key、官网链接和请求地址即可，第三方中转站也完全支持。

配置完成后重新运行 claude，登录步骤会被自动跳过。UP 主表示，用这种方式已经好几个月没被封过。如果你之前已经用官方方式安装并登录过 Claude Code，也可以重新用 CC Switch 配置，把登录环节跳过去。

需要注意的是，Codex 同样建议配合 CC Switch 使用，但 Codex 在软件里区分不同工具，切换工具时要记得同步切换配置，否则会出现「配了 DeepSeek 但 Codex 用不了」的情况。此外，DeepSeek Harness 目前不需要借助 CC Switch，直接按配置项设置即可。

关于科学上网工具，UP 主给了一个实用建议：由于当前风控较严，不建议购买一年期会员，除非确认服务足够稳定；否则宁可稍贵一点，按月购买更稳妥。

从技术原理看，Claude Code 官方登录依赖 Anthropic 账号体系，而在国内 IP 环境下频繁使用往往触发风控，导致账号被标记或封禁。CC Switch 的本质是一个本地代理层：它拦截 Claude Code 发出的 API 请求，将其转发至用户自行配置的第三方模型供应商（如 DeepSeek、智谱 GLM 等），因此整个流程完全绕开了 Anthropic 的账号验证体系。这类「API 中转」模式在国内 AI 开发者圈子中相当普遍——模型供应商提供兼容 OpenAI 格式的接口，客户端工具无需感知底层模型的变化，只需替换 Base URL 和 API Key 即可。值得注意的是，使用第三方模型意味着实际推理能力取决于所选供应商，与官方 Claude 3.5/3.7 系列可能存在差距，选择时需结合任务复杂度和成本综合权衡。

自然语言对话只是起点，效果其实很差

配置好模型后，很多人第一件事就是让它「介绍一下你自己」，或者直接说「帮我开发一个贪吃蛇小游戏」。这种纯自然语言的沟通方式，本质就是 Prompt 提示词。

UP 主强调，这种简单提示词的效果非常差：它不会做任何技术选型，也没有框定实现范围，既消耗更多 token，又拉长生成时间。他在演示中让 Claude Code 生成贪吃蛇小游戏，新版本已经会主动追问用什么方式实现（比如最简单的 HTML）、包含哪些功能玩法，而老版本则是直接闷头实现。

这背后是一个重要的价值——技术平权。想做一个基础的小功能，一句话就能生成，不需要学编程、学语法。但他也明确提醒：自己玩小工具没问题，一旦要投入商业环境、真正拿来赚钱，只靠一句话是远远不够的。开发能商用的大型平台仍需要技术储备，否则实现代码质量差、bug 多，而且演示中的代码没有经过任何 code review 就直接跑，实际生产中这些环节都不能省。

权限模式：控制人工介入的频率

在生成过程中，Claude Code 会不断弹窗要求确认操作——如果你了解大模型技术，这就是所谓的 Human in the loop（人工介入）。每次都要回车确认确实繁琐。

解决方式是权限模式。界面最下方可以看到当前模式，按 Shift + Tab 可以在几种模式间切换，常见的包括 menu mode、accept edits、plan mode、auto mode 等。Claude Code 在执行用户指令时需要获取认可，因此提供了这四种权限模式，各自控制的权限范围完全不同，可以根据实际需要选择——如果不想被频繁打断，就切换到自动化程度更高的模式。

「Human in the loop（人工介入）」是 AI Agent 系统设计中的核心安全机制。编程 Agent 在执行任务时会进行文件读写、命令行调用、网络请求等高风险操作，如果完全自动化运行而不加干预，一旦模型产生幻觉或理解偏差，可能导致文件被误删、错误代码被提交、数据库被改写等难以回滚的后果。因此大多数 Agent 框架默认要求人工在关键节点确认，这就是频繁弹窗的根本原因。Plan mode（计划模式）是一种折中方案：Agent 先列出完整执行计划供用户审核，确认无误后再一次性放行所有步骤，兼顾了效率与安全。Auto mode 则适合在受控环境（如独立测试项目）中使用，不建议在生产代码库中直接启用。

小结

对国内用户而言，Claude Code 上手的两个关键门槛是安装成功率和账号封禁风险。UP 主给出的方案清晰：用 NPM 方式安装（前置装好 Node.js 22+ 和 Git，并开启科学上网），用 CC Switch 绕过官方登录来规避封号。在使用层面，则要从简单的自然语言对话，逐步过渡到善用权限模式、MCP、Skills、CLAUDE.md 等组件，才能真正把效率和生成质量提上来。他也务实地提醒：国内模型能力已足以满足日常工作需求，没必要为体验国外模型而冒封号的麻烦。