Claude Code 安装与权限模式实战指南

Claude Code 是 Anthropic 推出的代理编码工具，能读取代码库、编辑文件、运行命令并与开发工具集成。它本质上是一个垂直领域的智能体，专注编程场景。对程序员而言，这类工具的使用频率正越来越高。本文基于 B 站 UP 主的实战分享，梳理从安装、避坑到模型切换的完整路径。

安装前必须搞清楚的几件事

学习新工具时，优先看官网是最稳妥的做法。Claude Code 官网支持简体中文，文档完整度较高。但官网推荐的安装命令在国内网络环境下经常报权限错误，直接照做大概率失败。

UP 主给出的替代方案是改用 npm 安装：npm install -g @anthropic-ai/claude-code。这一方式成功率明显更高，作者曾帮多位非程序员同事安装，基本没有失败案例。安装前需要准备三样东西：Git 工具、Node.js 环境（安装时改一下目录即可），以及开启科学上网工具。

需要强调的是，npm 安装过程中只有下载环节需要网络代理，后续配置和使用并不依赖。

npm 与全局安装：npm（Node Package Manager）是 Node.js 自带的包管理器，-g 参数表示全局安装，会把包的可执行文件放入系统的全局路径（如 /usr/local/bin 或 Windows 的用户目录下的 AppData），使得在任意目录下都能直接调用 claude 命令。官网安装脚本通常需要写入系统级目录，在缺少管理员权限或网络受限时容易报 EACCES/EPERM 错误；npm 全局安装的写入位置更可控，失败率因此更低。安装前可用 node -v、npm -v 检查环境是否就绪。

科学上网与代理的作用范围：npm 下载包时走的是 registry（默认 registry.npmjs.org），国内访问可能超时。可以通过设置 npm config set proxy 与 npm config set https-proxy，或使用镜像源临时解决。代理只在下载阶段生效，后续 Claude Code 与模型 API 通信走的是另一条链路。

装完别急着登录：CC Switch 的作用

这是整篇分享里最关键的避坑点。安装完成后，输入 claude --version 验证版本号即可确认安装成功，但不要紧接着执行登录。官网提供的账户登录方式（Claude 订阅或 Console 账户）在国内使用存在封号风险，且封禁时间点不可预期。

正确的做法是先安装 CC Switch。这是一个开源的小工具，提供 Windows 安装包，无需科学上网即可下载使用。它的核心功能是帮你切换模型供应商——打开后可以看到不同 agent 的配置入口，点击加号选择模型供应商，填入 API Key 即可添加并启用。

配置好 CC Switch 后再回到命令行登录 Claude Code，账号基本不会被封。作者本人长期使用这一方式，从未遇到封号问题。

CC Switch 到底改了什么

CC Switch 并不神秘，它修改的就是本地配置文件。在用户目录下的 .claude 文件夹中有一个 settings.json，原本需要手动编辑参数来切换模型。对初学者来说手改配置容易出错，CC Switch 只是把这个过程可视化了。

它不会增加 token 消耗，也不做任何额外修改，本质是一个配置适配器。

settings.json 与配置优先级：Claude Code 的配置分为用户级（~/.claude/settings.json）和项目级（项目根目录下的 .claude/settings.json），项目级通常覆盖用户级设置。供应商切换的关键参数一般包括 env 中的 ANTHROPIC_BASE_URL（API 端点）与 ANTHROPIC_AUTH_TOKEN（或 API Key），以及 model 字段指定默认模型。CC Switch 通过界面写入这些字段，避免手改 JSON 时出现逗号、引号或字段名拼写错误。理解这一点后，即使不用 CC Switch，也可以手动维护多套配置并在需要时切换。

模型选择：不必迷信排行

一个常见误解是“用 Claude Code 就必须用 Claude 模型”。实际上，只要模型提供商提供可请求的 API 接口，就可以接入。DeepSeek^广告、Kimi、GPT 等都可以自由切换。UP 主提到 DeepSeek 新版本能力很强，实际使用体验也不错，Kimi 等国内模型同样能满足需求。

作者的观点值得参考：日常工作中模型主要承担写代码、梳理文档、分析需求三类任务，一般模型都能胜任，不必刻意追求排行榜上的极限能力——那种压测环境下的表现，实际工作中很少触及。习惯用哪个就用哪个。

需要区分两个概念：Claude 是大语言模型，Claude Code 是构建在其之上的编程 agent。使用 Claude Code 时接入其他模型完全可行，这也是 CC Switch 存在的意义。至于 Claude Code 和 Codex 之间的选择，两者都是 agent 工具，没有强制性，按熟悉程度和需要来即可。

API 兼容层与 Anthropic 协议：Claude Code 默认使用 Anthropic 的 Messages API 协议。要接入 DeepSeek、Kimi 等第三方模型，通常需要供应商提供兼容 Anthropic 协议的端点，或通过网关/代理做协议转换（例如把 Anthropic 格式的请求映射为 OpenAI Chat Completions 格式）。这也是 CC Switch 中填写 base_url 的原因——它指向的并非模型本身，而是兼容层服务。接入时需确认该端点是否支持工具调用（tool use）与流式输出，这两项是 Claude Code 读取文件、执行命令的基础能力，缺失会导致 agent 无法正常工作。

权限模式与后续学习路径

原始素材标题提到了权限模式、MCP 与 Skills、Hooks、CLAUDE.md 等内容，但正文主要聚焦在安装与模型切换环节，对这些进阶主题未展开说明。从工具定位推断，权限模式关系到 agent 执行命令时的授权边界，CLAUDE.md 则用于向 agent 注入项目级上下文，MCP 和 Skills 扩展其外部能力——这些是掌握 Claude Code 的关键，建议查阅官方文档补齐。

安装环节按上述路径操作，成功率很高。若仍遇到问题，可寻求社区或讲师协助排查。

CLAUDE.md 与上下文注入：CLAUDE.md 是放在项目根目录（或用户目录）的 Markdown 文件，Claude Code 启动时会自动读取并作为系统提示的一部分，用来声明项目技术栈、编码规范、常用命令和禁止事项。它的价值在于把“每次都要重复交代的背景”固化下来，减少重复提示并提升输出一致性。与之配合的还有 .claude/ 下的命令与配置目录。

权限模式（Permission Modes）：Claude Code 在执行写文件、运行 shell 命令等有副作用的操作前会请求授权，常见模式包括每次询问、自动接受编辑、以及更宽松的放行模式。生产仓库中建议保持较严格的询问模式，或通过 allow/deny 列表精细控制可执行的命令白名单，避免 agent 误删文件或执行危险命令。