玩了一个多月的Claude Code，我越来越觉得这玩意儿不是“又一款AI插件”，而是直接把我干活的方式重写了。从一开始只会让它写个冒泡排序，到现在敢让它直接在我的Node项目里增删文件、跑测试、改配置，中间踩过的坑能写一屏。这篇是“Claude Code学习”系列的第三篇，重点把“基础使用”这部分讲透：怎么装、怎么登录、怎么跟VSCode配合，以及真正上手后要优先搞清楚的那些命令和套路。如果你是刚听说AI编程、正打算把Claude Code装进自己工作流的开发者，这篇应该能帮你少走很多弯路。
1. 先搞清楚Claude Code是什么：它和“AI聊天框”有本质区别
1.1 一句话定位：跑在终端里的AI编程智能体
Claude Code是Anthropic官方推出的命令行AI编程工具，核心形态是在终端里启动一个交互式会话，AI能直接读取你的项目文件、修改代码、执行Shell命令、创建提交、运行测试。注意，它不是“你问它答”的聊天机器人，而是“你给它目标，它自己规划并执行”的智能体。
我习惯把它理解成一个“带手带脚的新同事”：你告诉它需求，它会自己翻代码、定位问题、改文件、跑验证，干完还跟你汇报。整个过程发生在你的电脑上，代码不出本地，唯一的网络请求是调用模型接口。这一点对很多公司有吸引力——代码不用上传到第三方云端，隐私上和传统IDE插件有很大区别。
从“Claude Code是什么”这个角度出发，它适合三类人：一是重度命令行用户，天天在终端里跑git和构建工具；二是需要批量处理代码重构、跨文件修改的开发者；三是想探索下一代AI编程工作流的人，比如通过CLAUDE.md给AI建立“长期记忆”的玩法，这在其他工具里很难体验。
1.2 和Cursor、Copilot比，赢在哪输在哪
很多朋友会拿Claude Code和Cursor、GitHub Copilot对比，我的结论很直接：侧重点不同。
| 对比维度 | Claude Code | Cursor | GitHub Copilot |
|---|---|---|---|
| 主要形态 | 终端交互，全命令行 | 独立IDE，图形界面 | IDE插件，行内补全 |
| 工作方式 | Agent自主规划并执行 | Agent能力强但偏向编辑器内操作 | 以补全和对话为主 |
| 代码读取范围 | 整个项目目录，可自定义忽略 | 编辑器打开的文件+索引 | 当前文件+仓库上下文 |
| 执行能力 | 能直接跑命令、改文件、git操作 | 能改文件，但执行外部命令受限 | 基本不能执行命令 |
| 学习成本 | 中高，需要记命令 | 低，界面直观 | 最低，装上就能用 |
| 长上下文/大仓库 | 强，支持百万级Token上下文 | 中上 | 中 |
我的实际感受是：Cursor适合“边看边改”的交互方式，Copilot适合“写着写着要补全”的流程度场景，而Claude Code最强的场景是“丢一个任务给它，让它独立完成一整条链路”——比如“把项目里所有回调函数改成async/await，跑通全部测试，更新相关文档”，这种任务在Claude Code里的完成度远高于前两者。
代价也很明显：心智负担重。它不是一个帮你“出主意”的助手，而是一个需要你“下指令、看结果、复盘问题”的下属。你如果没有明确的任务边界和验收标准，它会自己发挥，然后你把时间花在纠错上。
1.3 核心边界：它擅长什么，不擅长什么
用下来的经验是，Claude Code在处理有明确规则、可验证结果的任务上非常强：代码迁移、测试补全、跨文件重构、按规范生成模块、解读报错并修复。它不擅长的是“没有反馈信号的自由创作”——比如“帮我设计一个漂亮的界面”，它给出的东西往往平庸；还有“凭感觉判断好坏”的任务，也容易翻车。
所以我的建议是：给它的任务越可验证越好。你能写清楚“做完之后跑什么命令算通过”，它就很少让你失望。这一点会贯穿整个系列，后面几篇还会反复提。
2. 安装、认证与VSCode集成：把环境一次配好
2.1 前置条件：Node.js版本与系统要求
Claude Code本质上是一个npm包，所以第一依赖是Node.js。官方要求Node 18及以上，我建议直接装最新的LTS版本，Node 20或22都行，低版本有些新特性会报错。装之前先检查一下你自己的环境。
node -v npm -v如果提示找不到node，说明还没装。Ubuntu下可以用NodeSource源，也可以直接用nvm管理：
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash nvm install --ltsWindows上推荐先去Node官网下安装包，或者用winget装：winget install OpenJS.NodeJS.LTS。装完记得重启终端，确保node和npm都进PATH了。
2.2 npm全局安装与版本管理
环境就绪后，Claude Code的安装比想象中简单，一条命令：
npm install -g @anthropic-ai/claude-code装完验证一下版本：
claude --version正常会输出版本号，比如我最早装的时候是1.x，现在已经迭代到2.x了。注意这个版本号非常重要——Claude Code的迭代速度极快，一周能发好几个小版本，很多奇怪的bug其实是“版本太旧导致的”，先升级再排错往往更有效。
升级也很简单：
claude update看到提示“Welcome to Claude Code v2.1.278”这种就是更新成功了。如果你的版本太老导致连接不上服务，claude update是第一步要做的。
卸载同样干脆：
npm uninstall -g @anthropic-ai/claude-code但是卸载后残留的配置文件依然存在，主要存在~/.claude目录下（Windows对应C:\Users\用户名\.claude），里面记录了你的认证信息、历史会话、自定义配置。如果要“彻底卸载”，记得把这个目录一起清理掉。
2.3 认证登录与一个绕不开的话题：网络可达性
装完第一次运行，直接在当前项目目录敲claude，会进入首次认证流程。官方支持两种方式：一是用Anthropic账号登录，走OAuth流程，浏览器授权后回填token；二是用API Key，启动时加入ANTHROPIC_API_KEY环境变量即可。
这里有个很多新用户都会撞上的提示：note: claude code might not be available in your country. check supported countries...。翻译过来就是：当前网络环境未被官方列入支持范围。这并不代表你的账号有问题，也不是安装失败，而是服务方在区域层面做了限制。
我处理这类问题时，原则很简单：只通过官方认可的方式解决。具体路径是：确认你所在区域的网络环境在不在Anthropic官方支持列表里；如果不在，你能做的是等待官方调整支持范围，或者改用官方明确支持的接入渠道。除此之外，网络上流传的各种“绕过”操作我不建议碰，稳定性差不说，还可能导致账号风险。我更推荐的做法是：先检查自己是不是公司内网限制导致误判，换个网络环境（比如手机热点）再试一次，有时候只是本地网络策略问题。
如果你的网络环境本身没问题，认证完后会话就能正常跑起来。第一次进去它会问你“这个项目是干什么的”，回答得越详细，它后面的行为越靠谱。这个环节不要偷懒，值得写两三句话，告诉它项目类型、技术栈、当前进展。
2.4 VSCode集成：两种用法都要会
Claude Code的VSCode集成分两种形态，一个是官方扩展“Claude Code”，一个是直接在VSCode的集成终端里跑命令行版本。
先说我推荐的组合方式：在VSCode里打开项目，用快捷键Ctrl+唤出集成终端，然后敲claude`。这样既有VSCode的文件树、diff视图，又有Claude Code的终端交互体验，AI改完代码你能直接在编辑器里看diff、continue会话，非常顺滑。
如果更喜欢图形化，也可以装官方VSCode扩展，搜索“Claude Code”即可。它会提供一个侧边栏面板，把会话、文件操作、命令执行都图形化展示出来。实话说，面板模式对新手更友好，因为不用记斜杠命令，点按钮就行。
另外官方还有桌面版（Claude Code Desktop），适合不想碰命令行的用户。下载入口在官网，安装后交互方式和命令行几乎一样，只是包了一层本地GUI。就我个人的体验来说，主力还是终端+VSCode的组合，桌面版更适合当作“大屏监视器”来用。
3. 基础使用实操：从第一个对话到独立跑任务
3.1 启动方式和你的第一个“Hello任务”
在任意项目目录下执行claude，它会自动扫描当前目录结构，读取项目相关配置文件，把上下文带起来。启动后你会进入一个交互式shell，提示符变成>。
我建议新手第一个任务别上来就重构，而是从“帮我梳理一下这个项目的结构和入口文件”开始。这个任务不涉及写代码，但能让你观察它怎么读文件、怎么组织回复，同时也能验证它有没有正确理解项目。我实测下来，任务描述越具体效果越好。
比如你可以这样写：
帮我梳理一下当前项目的目录结构，说明每个主要模块的职责，并用markdown格式输出，重点标出入口文件和配置文件。
它会真的遍历目录、打开几个关键文件、最后给出结构化总结。这一步走通，说明安装、认证、上下文都没问题，接下来就可以尝试让它改代码了。
3.2 权限模型：先学会让AI“问一下”再动手
Claude Code默认不是“横冲直撞”的模式。当它要执行危险操作——比如运行npm install、执行git push、修改某些配置文件——会先弹出询问，让你选Allow、Always allow、Deny。这个设计非常像手机上的App权限弹窗，本质是给你的项目上了一道保险。
但是有个坑我必须提：很多人图省事，一上来就用--dangerously-skip-permissions启动，结果AI把不该动的文件也改了，回滚时哭都没地方哭。我的习惯是，前几次使用一律用默认权限模式，让每个关键操作过一遍“审批”；等熟悉了它的行为模式，再针对特定工具放开权限。
如果想精确控制哪些命令可以免确认，可以用启动参数指定。比如：
claude --allowedTools "Bash(npm run test):*" "Read(./src/**)"这个语法的意思是：允许它运行npm run test这类测试命令，允许读取src目录下的文件，其余操作照常询问。这种细粒度控制在真实项目里特别实用，既能让它快速干活，又不至于失去控制。
3.3 高频命令和斜杠指令：把工具玩明白
Claude Code的会话里，所有功能都围绕斜杠命令展开。下面这几个是我每天都在用的，新手记熟它们基本够用：
| 斜杠命令 | 作用 | 我的使用场景 |
|---|---|---|
/help | 查看帮助文档 | 记不清某个参数时随手查 |
/clear | 清空当前对话上下文 | 跑偏了重新来，比另开会话快 |
/compact | 压缩上下文，保留核心信息 | 对话超长、上下文快满的时候 |
/model | 查看或切换模型 | 需要换Sonnet/Opus时 |
/status | 查看当前会话状态、token使用量 | 排查“为什么越来越慢” |
/cost | 查看本次会话费用 | 控制成本，尤其是长任务 |
/config | 打开配置文件 | 管理权限和快捷键 |
/clear和/compact的逻辑差别很关键。/clear是彻底清空记忆，AI会忘了之前聊过什么；/compact不一样，它会保留“当前目标”“已完成事项”等核心信息，只把冗余的细节压掉。长会话卡顿时，/compact是比/clear温和得多的解决方案。我一般先/compact，不行再/clear。
3.4 CLAUDE.md：把团队规范变成AI的“入职手册”
如果说Claude Code里只有一个东西值得提前写好，那就是CLAUDE.md。它相当于是放在项目根目录下的一份“给AI看的工作手册”，每次会话启动时Claude Code会自动读取它，并把它作为长期行为准则。
推荐在CLAUDE.md里写这些内容：
- 项目简介：这个项目是干什么的，目标用户是谁。
- 技术栈：语言、框架、包管理器、Node版本。
- 构建与测试命令：
npm run build、npm test的具体含义，CI跑的是哪几条。 - 代码风格要求：命名规范、组件写法、注释语言用中文还是英文。
- 目录结构与约定：新代码应该放哪里，哪些目录不要动。
举个例子，我的一个项目里写了这么一段：
# 项目规范 - 包管理器：pnpm，禁止使用npm安装依赖 - 测试：所有新功能必须附带单元测试，运行`pnpm test`通过才算完成 - 目录：业务逻辑放src/services，页面组件放src/components - 代码风格：TypeScript，禁用any，函数式写法优先写完之后，你再让AI新增功能，它会下意识遵守这些约定，产出质量和团队协作体验完全不一样。这就相当于给AI吃了一颗“定心丸”，让它少走弯路。全局级的记忆文件在~/.claude/CLAUDE.md，适合写个人偏好；项目级的在根目录，适合写这个项目特有的规则。
4. 高级配置：接入DeepSeek等第三方模型与环境变量解析
4.1 原理：为什么Claude Code能接第三方模型
Claude Code和模型服务之间的通信走的是Anthropic的API协议。所谓“接口兼容”的意思是，只要某个服务提供兼容Anthropic API格式的端点，Claude Code就可以通过环境变量把请求地址改过去，不需要改代码。
关键环境变量就两个：
| 环境变量 | 作用 | 示例 |
|---|---|---|
ANTHROPIC_BASE_URL | 覆盖API请求地址 | https://api.deepseek.com/anthropic |
ANTHROPIC_AUTH_TOKEN | 覆盖认证Token | sk-xxxxxx |
额外还有一个ANTHROPIC_MODEL，用来覆盖默认模型名。你会发现，Claude Code本质上变成了一个“AI编程客户端”，模型本身可以换成任何兼容的端点。这也是“Claude Code接入DeepSeek”这类需求火爆的原因——很多人手里的DeepSeek API比Claude的API便宜得多，在日常编码需求上完全够用。
4.2 实操配置：把DeepSeek接进Claude Code
DeepSeek官方提供了Anthropic兼容端点，地址是https://api.deepseek.com/anthropic，模型名是deepseek-chat。以Linux/macOS为例，配置过程长这样：
export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic export ANTHROPIC_AUTH_TOKEN=sk-你的DeepSeek密钥 export ANTHROPIC_MODEL=deepseek-chat claude注意，如果你的项目里之前已经配置过Claude官方的API Key，最好先把它从环境变量里清掉，避免冲突。还有一个细节：ANTHROPIC_AUTH_TOKEN和ANTHROPIC_API_KEY是两个不同的变量，第三方端点通常读前者，官方API Key模式下读后者，搞混了会出现401鉴权失败。
配置完成后，启动Claude Code，随便问一句“你当前用的是什么模型”，如果回复来自DeepSeek，说明已经接上了。我用过一段时间的deepseek-chat做日常编码，体验上在简单任务、代码生成、中文问答场景非常顺手，但在复杂重构、多文件协同修改上，指令遵循能力和Claude原生模型还是有差距，偶尔会在“改A文件忘记改B文件”这种问题上翻车。所以我的建议是：普通项目用DeepSeek省钱，核心项目还是切回Claude模型求稳。
4.3 模型切换工具与思考等级调整
社区里比较活跃的辅助工具有ccswitch、opencode-go等，它们本质上是在帮你快速切换多个API端点和模型配置，省得每次手动改环境变量。比如ccswitch就支持在一份配置文件里同时维护“官方Claude”“DeepSeek”等几套环境变量组合，用的时候一键切换。
还有一个小众但有意思的配置叫“思考等级”。很多人问xhigh怎么调，这其实是Claude模型Extended Thinking（扩展思考）的档位设置。简单说，它让模型在输出答案前先进行更长时间的推理，适合复杂的算法问题、并发排查、重构方案设计这种“重思考”任务；但对简单增删改查，开高思考档位只会增加延迟和费用，没必要。我实测下来的感受是，思考等级对“破案类”任务帮助最大——比如“这个bug为什么只在生产环境出现”，而对“照着接口文档写个CRUD”基本无感。
4.4 关于ENABLE_PROMPT_CACHING_1H这个配置有没有用
社区里一直有人在问ENABLE_PROMPT_CACHING_1H=1到底有没有用。我的实测结论是：有用，但要看场景。这个变量开启的是提示缓存，如果你在一次会话里反复发送大量相似上下文（比如每轮对话都带着整个项目的CLAUDE.md），缓存命中后后续请求的延迟和费用都会明显下降。
但在单次独立任务里，几乎感知不到差别。所以我自己的做法是：开着，反正不亏；但别指望它解决所有性能问题。真正影响速度的大头是上下文长度和模型本身，/compact才是立竿见影的操作。
5. 常见问题与排查技巧实录
5.1 “unable to connect to Anthropic”到底怎么排查
这个问题在热词榜上居高不下，但我观察到的现象是，一半以上的人根本没到“网络限制”这一步，而是环境配错了。
排查顺序很重要。第一，先确认API Key或登录态是否有效，我建议直接看认证信息，重新claude登录一次往往能解决。第二，检查网络连通性，最简单的办法是浏览器打开Anthropic的官网，能打开说明基础网络没问题，然后换一个网络环境再试，比如从办公室WiFi切到手机热点，排除本地网络策略的问题。第三，检查启动日志，用claude --debug跑一次，看它到底在连哪个地址、通没通、返回什么状态码。第四，升级到最新版本，客户端太老导致的协议不匹配也会报这种错。
我遇到过最离谱的一次，是系统时间不对，导致TLS证书校验失败，报错信息长得和网络不通一模一样。折腾半天最后发现是服务器时间差了8分钟。这类“非典型”问题只能靠日志排查，所以遇到连接问题先别急着怀疑网络环境，从日志、版本、时间、密钥四个维度逐个排除。
5.2 “Unsupported country/region”提示该怎么理解
这个提示在前面2.3已经提过，这里再深入说一层。它在官方层面的含义是：当前网络出口地址不属于服务方支持的区域。遇到这个提示，我的建议是理性看待：不要试图用灰产或绕过方式强行访问，风险不值得。正确的路径只有几条：确认你的网络环境是不是公司或酒店这类受限出口导致的误判，尝试官方明确支持的入口，以及等待服务方调整支持范围。
另外提醒一句：这类提示和你的账号本身没有关系，不代表账号被封了，也不代表API Key失效。你在被误伤后正常订阅服务，后续用合规渠道恢复访问时通常不受影响。
5.3 会话越来越慢还能不能救：上下文管理与缓存
用久了你会发现，同一个会话聊到后面越来越卡，回复质量也开始下降。这是上下文接近上限的典型症状。解决思路就三步：先用/status看一下当前上下文占用比例，明显偏高就直接/compact压缩，压缩后还不行就/clear重开并补充新的任务诉求。
我在一个大型代码库上实测过Claude Code支持百万级Token上下文的效果，第一次让它通读一个微服务模块并输出架构分析，结果超出预期。但副作用是上下文越长，单次响应耗时越久，费用也越高。所以我现在养成了“一个任务一个会话”的习惯，任务完成就/clear，不恋战。长上下文能力是“备而不用”的底牌，不是每轮对话都要拉满的配置。
5.4 卸载不干净和Skills安装问题
不少人在卸载Claude Code后发现磁盘空间没回来多少，原因是~/.claude目录还在。里面主要是历史会话、日志和本地缓存。想彻底清理就删掉整个目录，但注意，如果你后续要重装，认证信息也会一起没掉，需要重新登录。
另一个热门话题是“Claude Code手动安装GitHub上的Skills”。Skills是Claude Code的扩展技能机制，类似插件。安装方式很直接：把技能文件夹放到~/.claude/skills/（全局）或项目根目录.claude/skills/（仅当前项目）下。每个技能对应一个文件夹，里面至少有一个SKILL.md文件，文件头部用YAML元信息描述技能名称、描述、适用场景。装好后，新开的会话会自动看到并加载这些技能，旧会话里可以用/clear刷新一下。我试过手动装一个“自动写迁移脚本”的技能，效果还行，但坦白讲，目前Skills生态还很早期，自己写比到处找现成的更有性价比。
写到最后，说几句心里话
这一篇从安装讲到了第三方模型接入和踩坑排查，把Claude Code的基础使用逻辑基本串起来了。回头看我的学习路径，最核心的转变就一句话：别把Claude Code当搜索引擎，把它当新同事。你越清楚地告诉它项目背景、约束条件和验收标准，它给你的结果就越接近“直接用”；你越把它当自动回答机用，它越容易一本正经地胡说。
我个人现在的习惯是，任何新项目第一件事就是把CLAUDE.md写好，构建命令、测试命令、目录约定全部码清楚，然后再谈功能开发。这个习惯帮我省掉了大量“返工重写”的时间。后面我打算接着写一篇关于怎么把Claude Code接进团队Code Review流程的实操记录，如果你正在用这套工具做一些有意思的事情，也欢迎来评论区聊聊你踩过的坑。
