Claude Code是Anthropic推出的终端AI编程助手，你只要用自然语言描述需求，它能自主读取项目文件、修改代码、执行命令——不是那种只会补全一行代码的插件，是真的能干活的AI搭档。这篇教程把安装、国内模型配置、第一个项目实战全流程走一遍，不绕弯子。 国内用Claude Code的三道坎，先说清楚
很多人装到一半放弃，不是不会用，是被这几个问题卡住了。
账号门槛：Claude Code默认登录Anthropic官方账号，需要海外手机号和海外信用卡，国内用户直接劝退。就算搞到账号，API按美元计费，稍微用力一点一个月几百块起步。
封号风险：走拼车、共享API Key这种路子，Anthropic的异常流量检测非常灵，IP频繁变动、多人共用一个Key，轻则限流重则封号。写代码写到一半断连，那种体验懂的都懂。
网络问题：安装时要从npm拉包，启动时要连Anthropic服务器校验，国内网络直连不稳，卡在验证这步的人不在少数。
这三个问题，后面会用CC Switch一次性绕开。
Claude Code安装+国内配置全攻略
第一步：安装Claude Code
2026年Claude Code已经支持原生安装方式，不再强依赖npm，但npm安装路径仍然受支持，需要Node.js 18+。
推荐方式——官方脚本（需要网络畅通）
Mac/Linux/WSL：
Windows PowerShell：
备选方式——npm安装（国内网络更稳）
先装Node.js，去nodejs.org下载LTS版本，装完验证：
版本号18以上就行，然后安装Claude Code：
国内npm慢的话加镜像源：
⚠️ npm上存在一个叫claude-code的非官方仿冒包，正确包名是@anthropic-ai/claude-code，带@anthropic-ai/前缀，千万别装错。 装完验证：
看到版本号，安装成功。
常见报错处理
- Windows报ExecutionPolicy错误：先执行 Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
- 安装后执行不了claude命令：没有自动加入环境变量，手动把claude可执行文件路径添加到PATH。
第二步：用CC Switch配置国产模型
这是国内用户绕开账号和封号风险的核心操作。
CC Switch的原理很简单：在本地起一个中转服务，把Claude Code发出的请求"翻译"给你指定的模型，不管是DeepSeek、Kimi、GLM，只要是兼容OpenAI格式的API都能接。 你的请求路径变成：你 → Claude Code → CC Switch中转 → 国产模型API → 返回结果
完全不需要Claude海外账号，没有封号风险，用国内直连网络速度也快得多。
安装CC Switch
根据系统选版本：Windows选.exe，Mac M系列选darwin-arm64，Intel Mac选darwin-amd64。
配置DeepSeek（以此为例）
打开CC Switch，点"添加供应商"，填入：
| |
|---|
| |
| |
| platform.deepseek.com申请，新用户有免费额度 |
| |
⚠️ 操作CC Switch一定要在打开Claude Code之前完成，否则它默认让你登录Anthropic账号。已经进入Claude Code里再去切，会切不动，这一步很多新手翻车。
API地址格式要注意，不要多或少一个/v1，格式错了后面调用直接404。
添加完成后CC Switch主界面显示绿色"运行中"，就配好了。
也可以直接改配置文件
在用户目录下找到.claude文件夹，编辑settings.json：
这种方式更适合只用单一模型的场景，省去CC Switch的安装步骤。
第三步：跑通第一个项目
环境配好了，直接做一个能用的东西验证一下。
进入你想放项目的目录，启动Claude Code：
看到>光标出现，粘贴这段prompt：
Claude Code会自动分析需求、列出要创建的文件、逐步写代码。写完让你确认，直接回复yes，然后在文件管理器里找到pomodoro.html，双击用浏览器打开验证效果。
这就是Claude Code的基本工作流：你说需求，它写代码，你验收。
权限模式简单说一下
Claude Code有三种模式，Shift+Tab循环切换：
- Plan mode（计划模式）：先给计划等你确认，不直接动手，适合新手
- Accept Edits：改文件不再问你，跑命令还是会问
刚上手建议用默认模式，熟了再放开权限。
用起来之后的几个要注意的点
上下文管理：用久了Claude Code会变慢、质量下降，这是上下文窗口被塞满了。完成一个任务后输入/compact主动压缩，或者/clear直接清空重开。看到上下文用量超过60%，就该压缩了。
后悔药要提前备好：Claude Code改文件有不确定性，做到满意的节点就让它帮你git commit存档一次。有一次它把数据库迁移脚本改崩了，回滚了半天才恢复，重要操作之前一定要先git commit。 出了问题输入/rewind可以回滚Claude Code自己编辑的文件，但它执行过的终端命令（安装包、下载文件）撤不了，Git才是真正靠谱的安全网。
模型切换：日常代码修改、bug修复用Sonnet够用，价格是Opus的五分之一；复杂架构设计再切Opus。会话中输入/model可以随时切换。
Claude Code真正的门槛不是学它怎么用，而是把环境搭起来。账号绕不过去就用CC Switch接国产模型，网络直连国内API稳得多，成本也低一个数量级。把这套流程跑通，比刷再多"AI编程太强了"的视频都实在。
AI 速览
