玩了一个多月的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 CodeCursorGitHub 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/anthropicANTHROPIC_AUTH_TOKEN覆盖认证Tokensk-xxxxxx额外还有一个ANTHROPIC_MODEL用来覆盖默认模型名。你会发现Claude Code本质上变成了一个“AI编程客户端”模型本身可以换成任何兼容的端点。这也是“Claude Code接入DeepSeek”这类需求火爆的原因——很多人手里的DeepSeek API比Claude的API便宜得多在日常编码需求上完全够用。4.2 实操配置把DeepSeek接进Claude CodeDeepSeek官方提供了Anthropic兼容端点地址是https://api.deepseek.com/anthropic模型名是deepseek-chat。以Linux/macOS为例配置过程长这样export ANTHROPIC_BASE_URLhttps://api.deepseek.com/anthropic export ANTHROPIC_AUTH_TOKENsk-你的DeepSeek密钥 export ANTHROPIC_MODELdeepseek-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_1H1到底有没有用。我的实测结论是有用但要看场景。这个变量开启的是提示缓存如果你在一次会话里反复发送大量相似上下文比如每轮对话都带着整个项目的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流程的实操记录如果你正在用这套工具做一些有意思的事情也欢迎来评论区聊聊你踩过的坑。
Claude Code基础使用全攻略：安装、VSCode集成与实战技巧
玩了一个多月的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 CodeCursorGitHub 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/anthropicANTHROPIC_AUTH_TOKEN覆盖认证Tokensk-xxxxxx额外还有一个ANTHROPIC_MODEL用来覆盖默认模型名。你会发现Claude Code本质上变成了一个“AI编程客户端”模型本身可以换成任何兼容的端点。这也是“Claude Code接入DeepSeek”这类需求火爆的原因——很多人手里的DeepSeek API比Claude的API便宜得多在日常编码需求上完全够用。4.2 实操配置把DeepSeek接进Claude CodeDeepSeek官方提供了Anthropic兼容端点地址是https://api.deepseek.com/anthropic模型名是deepseek-chat。以Linux/macOS为例配置过程长这样export ANTHROPIC_BASE_URLhttps://api.deepseek.com/anthropic export ANTHROPIC_AUTH_TOKENsk-你的DeepSeek密钥 export ANTHROPIC_MODELdeepseek-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_1H1到底有没有用。我的实测结论是有用但要看场景。这个变量开启的是提示缓存如果你在一次会话里反复发送大量相似上下文比如每轮对话都带着整个项目的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流程的实操记录如果你正在用这套工具做一些有意思的事情也欢迎来评论区聊聊你踩过的坑。