Claude Code 入门：安装配置、对接 DeepSeek 与实战改代码

1. 认识 Claude Code它到底是个什么工具1.1 一个能直接帮你改代码的AI命令行助手Claude Code 是 Anthropic 推出的命令行编程助手它不是简单的聊天机器人而是在你的终端里直接读取项目代码、分析逻辑、修改文件、运行命令的AI工具。第一次看到它工作的时候说实话我有点震惊——你只需要在终端里输入一句“帮我修一下这个登录逻辑的bug”它能自己打开文件、定位问题、完成修改、甚至跑一遍测试给你看结果。和传统的AI编程工具相比Claude Code的核心能力差异在于它拥有读取整个项目上下文的能力而不仅仅是当前打开的文件。这意味着它能跨文件理解你的代码结构知道这个函数在哪里被调用、那个变量在哪个模块里定义然后基于全项目的理解来执行修改。1.2 它和ChatGPT、GitHub Copilot有什么区别很多人会把Claude Code和市面上其他AI编程工具放在一起比较我个人的理解是这样的ChatGPT / Claude网页版需要在浏览器里手动复制代码再把修改后的内容粘贴回去交互成本高且无法完整理解项目结构。GitHub Copilot擅长“补全”和“建议”在写代码时给出行内提示但对整体架构的修改能力有限。Claude Code直接在终端里运行可以自主完成“分析-修改-验证”的闭环操作。用生活里的事来类比Copilot像是你在开车时坐在副驾驶的陪练能时不时给你指正Claude Code更像一个能坐在主驾驶位上的代驾你告诉它目的地它自己踩油门打方向盘到站后把驾驶权还给你。1.3 这篇教程适合谁如果你属于下面任意一类人这篇教程就是为你准备的刚接触编程的初学者想用AI辅助写代码但不知道怎么配置独立开发者想提升日常开发的效率减少机械重复劳动对Claude API有了解但还没试过官方命令行工具的人想在VSCode里集成AI助手但不想用付费插件的开发者我会从零开始把从环境准备、安装配置、到第一次实际代码修改的完整过程都走一遍包含我踩过的坑和总结的经验。2. 安装前的环境准备先把这三件事做好2.1 Node.js环境安装必需项Claude Code 本质上是一个基于 Node.js 开发的命令行工具所以安装它的前提是电脑上已经准备好 Node.js 环境。这里说的 Node.js 是 JavaScript 的运行时环境你可以把它理解为“能让Claude Code跑起来的底座”。我建议直接去 Node.js 官网下载 LTS 版本Long Term Support长期支持版。为什么不选最新版而选LTS因为LTS版本经过更充分的稳定性验证对于工具类软件来说稳定性比新功能重要得多。下载完成后直接双击安装包一路下一步就行不需要修改任何配置。安装完成后打开终端Windows下是命令提示符或PowerShellmacOS是Terminal输入下面两个命令验证是否安装成功node -v npm -v如果看到类似v18.17.0和9.6.7这样的版本号输出说明Node.js已经装好了。如果提示“node不是内部或外部命令”大概率是安装时没有勾选“添加到PATH”选项或者安装完没有重启终端。注意npm 是随 Node.js 一起安装的包管理器后面我们用 npx 命令调用 Claude Code 时会用到它。如果npm命令无法识别建议重新安装Node.js并在安装向导中确认“Add to PATH”选项已勾选。2.2 Git环境安装强烈建议虽然安装Claude Code本身不强制要求Git但在实际操作中Git几乎是必备的。原因有两个第一Claude Code在修改代码时会用Git来感知你项目的变更情况。它能通过git diff查看你改了哪些文件这是它理解你工作上下文的重要途径。第二当AI帮你做了修改之后你大概率需要回看这次改了什么、甚至回滚修改——这些都是Git的活。Git的安装同样很直接去 Git 官网下载对应操作系统的安装包Windows用户一路下一步即可。安装完成后用下面的命令验证git --version我经历过的真实场景是这样的有一次帮同学配置Claude Code环境都装好了但Claude Code一直无法读取项目的变更状态。排查了半天发现就是因为他没装GitClaude Code调用git diff时直接报错。装完Git后一切正常。所以这里强烈建议你在装Claude Code之前就把Git装好。2.3 准备一个装有代码的项目文件夹Claude Code需要在一个实际的项目目录中运行。如果你现在手头没有现成的项目可以先创建一个测试文件夹放一两个简单的代码文件进去。我先演示一下初始化。假设你在桌面建了一个名为demo-project的文件夹里面放一个简单的Python脚本cd ~/Desktop/demo-project git init echo print(Hello World) hello.py这里git init是初始化一个Git仓库这样Claude Code能通过Git感知文件的变更状态。如果你是在公司已有的项目上使用直接进入项目目录即可但建议确认该项目已经是Git仓库。如果不是养成先执行git init的习惯。3. 核心环节Claude Code 的安装与登录3.1 通过npm全局安装Claude Code的官方推荐安装方式是通过npm。打开终端执行下面的命令npm install -g anthropic-ai/claude-code这里-g参数表示全局安装这样你在任意目录下都能直接运行claude命令。安装过程中会下载一些依赖包具体耗时取决于你的网络状况一般在几十秒到几分钟不等。安装完成后验证一下是否成功claude --version如果能看到类似0.2.23这样的版本号说明安装成功了。安装过程中有几点经验分享如果npm安装速度很慢建议先检查一下npm源配置。国内用户可以把npm registry切换到镜像源命令是npm config set registry https://registry.npmmirror.com。如果你用的公司电脑有管理员权限限制npm全局安装可能需要授权这个看具体网络环境不做过多展开。Windows用户如果在PowerShell里提示“无法加载脚本因为在此系统上禁止运行脚本”需要先执行一下Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser允许本机脚本运行。3.2 登录Claude账号并完成身份验证安装完成后在项目目录下直接运行claude第一次启动会进入登录流程。Claude Code的登录是在浏览器中完成的——终端里会输出一个验证码和一个链接你需要在浏览器中打开链接输入验证码然后确认Claude账号的授权。这个登录验证的目的是确认你有使用Claude API的权限。这里有两条路线如果你是Claude Pro/Max订阅用户可以直接用订阅账号登录Claude Code会包含在你的订阅额度中。如果你想通过API调用需要在 Anthropic Console 里创建API Key并在Claude Code中进行配置。登录完成后终端会显示一个交互式界面说明Claude Code已经准备就绪。你会在终端里看到一个类似对话框的界面这就是Claude Code的交互入口。3.3 VSCode中的集成方式很多读者希望把Claude Code嵌入到VSCode中使用让编辑体验更流畅。实际上有一种简单的方式VSCode终端中直接运行claude命令。你只需要在VSCode里打开终端快捷键是Ctrl 然后执行claudeClaude Code就会在VSCode的集成终端中运行。它的能力不会因为所在终端不同而有差异因为它的核心是访问文件和命令执行与终端环境无关。还有另一个选择是安装Claude Code的VSCode扩展但目前官方扩展的成熟度还在迭代中。我个人的建议是先用好终端集成的方式因为这样不会引入额外的插件兼容性问题。4. 与DeepSeek等第三方模型对接选择你自己的底座4.1 为什么有人想把Claude Code接入DeepSeek在使用Claude Code的过程中不少开发者尝试把它和其他模型对接。原因很现实Claude官方API的调用成本相对较高而且在国内访问Claude API的体验不稳定。相比之下DeepSeek这类国内模型API调用成本低得多。不过这里要先说清楚一个技术事实Claude Code本身是Anthropic的开发工具它的官方调用链路是基于Claude模型的。把它接入DeepSeek本质上是修改它的模型配置让它调用DeepSeek的API来完成代码理解和修改。这种改造在实际操作层面怎么做呢核心是通过环境变量来指定API的base URL和key。4.2 通过环境变量配置第三方模型如果你需要把Claude Code接入DeepSeek或者其他兼容Anthropic API协议的模型服务可以在启动Claude Code前设置几个环境变量。在bash/zsh环境下可以这样配置export ANTHROPIC_BASE_URLhttps://api.deepseek.com/anthropic export ANTHROPIC_AUTH_TOKEN你的DeepSeek_API_KEY这里的ANTHROPIC_BASE_URL是API接口的地址ANTHROPIC_AUTH_TOKEN是你的鉴权令牌。设置完之后再运行claudeClaude Code就会把API请求发到DeepSeek的接口上。在Windows PowerShell环境下用下面的方式设置$env:ANTHROPIC_BASE_URLhttps://api.deepseek.com/anthropic $env:ANTHROPIC_AUTH_TOKEN你的DeepSeek_API_KEY设置完成后重新运行claude即可。注意不同第三方服务商的接口兼容层级不一样有的能完整兼容有的只兼容部分功能。实际使用时如果出现个别工具调用报错需要先确认第三方服务的兼容性文档。4.3 模型选择与成本权衡在你真正决定用哪个模型之前先把成本和效果的关系捋清楚。Claude官方模型如Claude Sonnet 4.5、Claude Opus 4.5在代码理解能力上确实处于第一梯队尤其是在复杂多文件修改、架构级重构的场景下表现突出。但它的API按token计费一个完整的项目分析可能会消耗不少token长期使用的预算压力不小。DeepSeek这类模型胜在便宜、国内直连速度稳定对于日常的代码补全、bug定位、脚本编写等轻量任务完全够用。但在极端复杂的项目里它可能在理解深度和生成质量上和Claude旗舰模型有差距。我的建议日常开发用性价比高的模型处理简单任务在遇到硬骨头比如跨模块重构、算法设计、疑难bug定位时切换到Claude旗舰模型。具体怎么切换就是改环境变量的事熟练之后操作成本很低。5. 实操篇用 Claude Code 完成第一次代码修改5.1 任务场景设定为了让教程有实际的参考价值我们构造一个具体的任务场景把从启动Claude Code到修改完成的完整流程走一遍。我用一个简单的Python脚本来演示——假设你有一个用户登录验证的函数里面存在一个问题当用户名为空时程序会直接抛异常而不是返回友好的错误提示。代码如下def login(username, password): if len(username) 0 and len(password) 0: return 登录成功 else: raise ValueError(用户名或密码不能为空)问题在于正常业务逻辑下用户名或密码为空时应该返回给前端一个可控的错误提示而不是让程序抛出异常。我们需要修改这段逻辑。5.2 启动Claude Code并描述需求在项目目录下启动Claude Code后输入下面的指令帮我修改login函数当用户名为空或密码为空时不要抛出异常改为返回错误信息。同时补充一个用户名为空的测试用例。Claude Code会先读取项目文件结构定位到包含login函数的文件然后输出它的分析过程和修改方案。你会在终端里看到它一步步执行操作的过程——打开文件、定位函数、修改代码、展示diff。这个过程中可以观察到的现象是Claude Code不会盲目动手它会先描述它准备怎么做然后询问你的确认意见。这种“先请示再执行”的交互模式是为了避免AI的修改方向与你的预期不符导致不必要的返工。5.3 审查改动并确认执行Claude Code给出修改方案后你需要在交互界面中选择确认。在它的交互界面中按 Tab 键或输入 y 表示接受修改。修改完成后它会展示这次改动涉及的代码差异diff。下面是它可能给出的修改结果def login(username, password): if not username or not password: return {success: False, message: 用户名或密码不能为空} return {success: True, message: 登录成功}可以看到修改后的函数不再抛出异常而是返回一个结构化的字典这样前端可以直接读取success和message字段来做进一步处理。如果你觉得这个修改方向不对可以直接在对话中继续提出修改要求比如“不要返回字典保持返回字符串”。Claude Code会基于你的反馈调整实现方式。5.4 验证修改结果修改完成后需要实际运行测试来验证代码的正确性。在Claude Code的对话中继续输入帮我运行这个测试文件确认修改后的逻辑正确Claude Code会执行相应命令比如python test_login.py然后把运行结果反馈给你。如果测试通过它会告诉你结果如果测试失败它会分析原因并尝试修复。这个“分析-修改-验证”的闭环是Claude Code最有价值的部分。它不只是帮你写完代码就结束而是会通过实际执行来确认改动真的有效。5.5 一个完整的日常开发工作流参考用了一段时间后我总结出了一个比较顺手的日常开发流程开发新功能时先用自然语言描述需求让Claude Code生成基础代码框架代码写出后要求它补充边界条件的处理逻辑提交代码前让Claude Code review一遍改动它会发现一些低级错误遇到bug时把完整的报错信息复制给Claude Code它能快速定位到可疑代码段这个工作流本质上让你从“逐行写代码”变成了“提需求验结果”把更多精力留给架构设计和业务梳理。6. 常见问题排查安装和使用中踩过的坑6.1 安装阶段的报错与解决办法我在安装过程中遇到过不少报错也看到很多读者在网上提问。这里把最常见的几种情况整理成表格问题表现可能原因解决办法npm install超时或卡住npm源速度慢切换到npmmirror镜像源后重试提示claude 不是内部或外部命令全局bin目录未加入PATH检查Node.js安装是否正确重启终端或手动添加PATHPowerShell报脚本执行错误系统禁止脚本运行执行Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUserclaude启动后界面乱码终端编码格式不对把终端编码切到UTF-8登录时浏览器打不开链接终端复制链接不完整手动在地址栏输入完整链接其中npm源的问题在国内用户里最普遍。如果你的npm下载速度一直很慢不要犹豫直接换镜像源。6.2 运行时API连接问题启动Claude Code后如果提示认证失败、 connection error 之类的错误需要按顺序排查三点首先确认账号的登录状态是否有效。Claude Code的登录凭证是有有效期的如果长时间未使用可能已经需要重新登录。可以退出登录后重新授权。其次确认网络连接是否能访问API服务。如果你在特殊网络环境下使用可能需要检查一下网络配置。这里就不展开讨论了。最后确认API Key如果用的是API Key方式它是否还有效余额是否充足。API Key在 Anthropic Console 中可以查看状态。6.3 使用中的性能与体验问题有读者反馈Claude Code在处理大项目时响应慢或者会出现上下文不够用的情况。Claude Code的上下文窗口是它理解项目的范围。默认配置下它能读取大量信息但对于特别庞大的代码库它未必能一次性加载全部内容。这时可以在对话中明确指出需要关注的文件路径比如“重点看src/utils/helpers.py这个文件”它会优先加载这部分信息。另外一个实用技巧是善用 CLAUDE.md 文件。你可以在项目根目录创建一个 CLAUDE.md 文件在里面写清楚项目的结构说明、编码规范、常用命令等信息。Claude Code启动时会自动读取这个文件把它作为理解项目的“全局上下文”。这相当于给AI提前划好重点避免它每次都要“猜”项目的信息。我实际测试过有了 CLAUDE.md 之后Claude Code 对项目意图的理解准确度提升非常明显尤其是在团队项目里信息前置能大幅减少AI因误判上下文产生的干扰。6.4 代码安全与变更管理用AI改代码最担心的问题之一它修改出来的东西破坏了原有功能怎么办这个问题靠Git来解决。Claude Code操作的每一步改动都会体现在Git状态中。在让它执行大的改动之前先确认你的工作区是干净的git status没有未提交的变更这样即使它改出问题也能通过git checkout .一键还原。还有一个习惯值得养成每次让Claude Code完成一个独立的修改任务后及时查看git diff确认改动内容有问题立即反馈给它修正。不要把多个修改任务一次性丢给它同时执行——AI一次聚焦一个目标的执行效果远好于多任务并行。7. 一些实用的配置建议和扩展用法7.1 常用配置项Claude Code支持通过配置文件的方式预设你的使用偏好。在项目根目录或用户主目录下你可以编辑.claude/settings.json文件将常用配置固化下来。比如设置默认的语气风格、启用某些插件、指定输出的详细程度等。一个示例配置文件{ permissions: { allow: [Bash(npm run *), Read(project/**)], deny: [Bash(rm -rf *)] } }这个配置的意义在于你可以在全局或项目维度控制Claude Code的执行权限。比如只允许它运行npm类命令禁止执行删文件的危险操作。这样即使AI的理解出现偏差也不会因为误操作破坏项目。7.2 嵌入式设备开发场景STM32和汇编层面的帮助顺着热词里的stm32话题多说一句。Claude Code的应用场景远不只是Web开发在嵌入式开发中同样能派上用场。它可以阅读寄存器配置代码、分析中断处理逻辑、检查时序配置的顺序问题。嵌入式开发环境里它面对C语言、汇编代码时同样具备理解能力。你可以让它帮忙分析一份STMCubeMX生成的初始化代码梳理各外设的时钟配置是否冲突。虽然它没法直接调试硬件但作为辅助分析工具它的价值是实打实的——尤其是面对动辄上千行的初始化代码时能帮你节省大量从头读代码的时间。7.3 结合桌面版与飞书机器人等信息有读者在热词里提到了Claude Code桌面版和cc-connect飞书集成。目前市面上的第三方工具生态确实在快速发展出现了不少辅助工具。桌面版通常是社区开发的GUI封装本质上还是在终端运行Claude Code只是换了一层界面。飞书机器人集成则是把Claude Code接到飞书消息里可以在聊天框中向它下发任务、让它返回结果。这种形式的优势是你可以在收集到问题反馈的第一时间就让AI开始分析不必切换窗口。不过第三方工具良莠不齐使用前建议先确认开源项目的维护活跃度。8. 最后分享一点实际使用体会从我自己的使用体验来看Claude Code这东西最打动我的不是它能“写代码”而是它把“改代码”这个以往最费精力的环节变得足够高效。以前改一个跨文件的重构需求我得先梳理逻辑、手动打开每个文件、小心谨慎地修改、再逐一测试。现在只需要把需求描述清楚Claude Code能在一两分钟内完成整套操作。那些常见的低级错误——变量名拼错、括号不匹配、逻辑分支遗漏——它基本不会犯能高效处理的往往是那些体力活。它不是万能的也会有理解偏差或者面对极其模糊的需求时不知道你要什么。但和它协作的体验本质上是在培养一种“用精确描述换高效执行”的工作习惯。需求描述得越清晰它的表现就越超出预期。最后给新手一个小建议拿着一个练手项目从“给一个函数加上类型检查”“把代码里的硬编码提取成常量”这类小任务开始熟悉它的交互模式和判断逻辑。用顺手之后再逐步把更复杂的需求交给它处理。说到底工具摆在那里用不用、怎么用全看你自己。希望这篇教程能帮你少走几步弯路第一天就能感受到AI辅助编程的爽快感。