最近这一波AI编程助手确实把开发节奏彻底带起来了。GitHub Copilot还没聊完Cursor又冒头紧接着终端里的Claude Code、Codex、OpenCode全挤上了牌桌。这篇文章我只讲一件事Claude Code的部署与基础使用。我会把Windows环境下的真实安装过程、首次登录授权、常用命令参数、接入DeepSeek模型、通过MCP连接本地MySQL以及它在Android UI业务开发里的实际用法全部按我自己的踩坑顺序写清楚。如果你正准备把一个能直接读项目、改文件、跑命令的AI Agent装进自己的开发环境或者已经在用Claude Code但被授权弹窗、模型配置、MCP连接这些细节卡住这篇文章应该能帮你省下不少试错时间。我不讲花里胡哨的概念只讲能落地的东西你照着敲命令就能跑起来。1. Claude Code到底是什么为什么要在终端里跑1.1 从聊天问答到自动动手改代码的转变网页版Claude再聪明它也只是给你返回文字。真正干活的时候你得自己把代码从浏览器复制到编辑器自己找到要改的文件自己跑测试。Claude Code改变的就是这个环节——它是一个跑在终端里的编码智能体拥有自己读文件、写文件、执行命令的能力能处理整个项目上下文而不只是单个文件。第一次在终端输入claude回车的时候你会明显感觉到它和普通AI工具的区别。界面左侧会显示当前工作目录、当前模型、Token用量右侧就是你跟它对话的区域。你让它把这个模块的单元测试补上它会先列出改动计划然后逐个文件改给你看遇到需要执行命令的关键节点比如跑测试、装依赖它会停下来征求你的授权你说允许它就继续往下干。这个Agent形态和Copilot形态有本质差别。Copilot类工具更像是带预测输入的编辑器插件它补全你的下一行代码Agent类工具则是把你的意图翻译成一系列文件操作和命令执行也就是从给你一段代码升级成帮你把代码写进文件、把命令跑完、把测试结果反馈回来。特别是面对多文件重构、跨模块排查bug、批量修改这类脏活累活一两天的工作量确实可能压缩到一两个小时。1.2 适合谁用解决什么问题先说结论Claude Code最适合三类人。第一类是日常工作里需要频繁跨文件改代码的开发者。比如你有一个老项目要升级依赖几百个文件里的API调用都要跟着换靠人工搜索替换容易漏靠Claude Code就能全项目范围内统一替换并逐个检查。第二类是喜欢把繁琐操作交给脚本和命令行的工程师。这类人本来就在终端里工作多一个AI Agent只是给终端加了一层自然语言交互不需要额外切换窗口。第三类是实习生或者刚接触陌生代码库的新人。你丢给Claude Code一个刚克隆下来的仓库让它梳理项目结构和核心流程写出README它能在一分钟内给你一份还像样的说明文档这对快速上手新项目帮助很大。不过也得说清楚它不擅长什么纯视觉层面的UI微调、需要大量人工审美判断的设计工作、以及涉及多团队多系统联调的复杂业务它只能辅助没法替代。它是效率放大器不是自动完成按钮。2. 部署前的准备与方案选型2.1 环境要求与账号准备在Windows上部署Claude Code我实测下来的完整要求并不复杂Node.js 18或更高版本我推荐直接装LTS版也就是20或22太老的版本会导致CLI启动时报语法错误。一个能正常打开浏览器的终端Windows默认PowerShell、Windows Terminal都可以Git Bash也行。Anthropic账号或API Key。交互模式走账号授权自动化和CI/CD场景走API Key。网络能正常访问Anthropic服务。这一点看起来像废话但很多部署失败最后都卡在网络连通性上部署前先确认环境可以正常访问比反复重装CLI省时间得多。安装前先确认Node环境在终端里依次执行node -v npm -v如果提示命令不存在先去Node官网下载Windows LTS安装包一路默认安装即可。node -v能输出版本号说明环境基本就绪。然后做账号准备。如果你计划用交互模式直接准备Anthropic的账号如果你打算跑自动化脚本提前到控制台申请API Key。申请之后把Key保存好后面的环境变量配置要用。2.2 三种安装方式怎么选Claude Code目前在Windows上主要有三种安装方式我逐个说下取舍。第一种是npm全局安装CLI本身是一个Node包。命令就一行npm install -g anthropic-ai/claude-code好处是升级方便一行命令搞定坏处是依赖Node环境适合本来就用Node做开发的人。我主力推荐这种方式因为后续配合MCP生态、改配置、装插件都比较顺。第二种是官方原生安装器。Anthropic提供了不依赖Node的独立二进制版本适合不想在机器上装Node的情况或者要用在CI流水线里的场景。安装包可以直接通过官方渠道下载装完同样是claude命令。这种方式升级要重新下载安装包比npm麻烦一点但启动速度快、环境隔离更干净。第三种是Claude Code Desktop。你可以理解成给CLI套了个图形界面外壳底层跑的还是同一个命令行程序。它的价值在于如果你们团队有人完全不适应终端可以让他用Desktop入口日常看日志、切会话、配权限会直观不少。但对于真正的高强度编码使用我还是建议直接回到终端因为很多多文件操作和命令管道组合在纯终端里效率更高。我自己现在的工作流是开发机上npm安装CLICI服务器上用原生安装器偶尔需要展示给不熟悉终端的人时用Desktop。3. 部署实操Windows环境从零到跑通3.1 Node.js环境准备与全局安装Windows上跑Claude Code最稳的一条路就是npm安装。确认Node可用后直接执行npm install -g anthropic-ai/claude-codenpm会把它安装到全局目录Windows下通常是%APPDATA%\npm。安装完成后验证一下claude --version能打印出版本号就说明装好了。如果你遇到claude不是内部或外部命令这类报错别慌这是经典问题。执行下面命令看npm全局目录npm config get prefix如果输出路径不在你的PATH环境变量里手动把%APPDATA%\npm加进系统PATH。操作路径控制面板-系统-高级系统设置-环境变量在用户变量里找到Path新增一行。改完重新打开终端claude命令就能识别了。安装完成先跑一次最简单的非交互命令验证服务可用claude -p 你好用一句话介绍你自己如果配置正确终端会在几秒内打印模型返回内容。这一步能快速排除安装路径、网络连通、认证配置三个大坑。3.2 首次启动、账号授权与最小配置接下来进入正式使用的核心环节——首次启动和授权。在项目目录里比如D:\projects\my-app打开终端输入claude首次运行会进入引导流程。CLI会生成一个一次性授权链接自动打开浏览器你在浏览器里登录Anthropic账号并确认授权。这一步的本质是让CLI拿到一个本地保存的凭证之后的会话不用重复登录。如果你的环境是不方便开浏览器的服务器也可以用API Key方式启动。先设置环境变量再启动export ANTHROPIC_API_KEYsk-ant-你的Key claudeWindows PowerShell下用$env:ANTHROPIC_API_KEYsk-ant-你的Key。登录授权完成后我强烈建议马上做第二件事在项目根目录创建CLAUDE.md。千万别小看这个文件它是Claude Code的项目记忆文件。我一般会在里面写明白四件事项目是干什么的、用的什么技术栈、常用的构建和测试命令是什么、代码风格约定是什么。比如# my-app 后端Spring Boot 3 MySQL 8 前端React 18 Vite 常用命令 - 启动后端mvn spring-boot:run - 启动前端npm run dev - 跑后端测试mvn test - 跑前端测试npm run test 风格约定 - Java代码使用Controller-Service-Mapper分层 - 前端组件统一放src/components页面放src/pages - 所有业务错误统一抛BusinessExceptionClaude Code每次处理项目任务时会自动读取这份文件相当于你入职第一天给AI讲了遍项目背景后面协作效率会显著提升。我实际使用下来同一个任务有没有CLAUDE.md理解准确率差距非常明显。3.3 让Claude自动完成复杂任务而不需要频繁点击授权很多人在搜索Claude Code经常需要授权怎么不用点就让它干完。这个问题在官方设计里有一套正规且安全的解法就是权限模式。Claude Code默认在每次执行Bash命令、修改文件前会弹确认这对保守场景是保护但对一个连续几十步的复杂任务来说确实点得手累。第一种方式是调整权限模式。进入交互模式后按ShiftTab会在默认模式-自动接受文件编辑-完全自动模式几个档位之间切换。切到自动接受文件编辑后AI改文件不需要你挨个确认但执行Bash命令仍然会问切到完全自动模式连命令执行都自动化。我通常建议日常开发用自动接受文件编辑档既省掉大量确认又保留对命令执行的掌控。第二种方式是启动时用参数指定工具白名单。例如claude --allowedTools Bash(git*) Read Edit Write这个语法意思是允许执行任何以git开头的Bash命令允许读写改文件其余工具仍然要确认。这样AI在处理版本控制相关操作时不需要你介入但碰到npm install这类可能改环境的命令还会问你。第三种方式更彻底直接在CLAUDE.md里声明项目规则例如在本项目下运行测试、git提交、git分支操作不需要额外授权。这不是绕过安全检查而是把项目的常规操作优先级告诉AI让它遇到这些操作时主动执行而非停下来等待。只要你的项目边界清晰、命令不会产生破坏性影响这套组合就能让AI连续把任务跑完。我自己的经验是真正需要完全无脑跑完的长任务放独立测试分支或临时目录里做配合全自动模式出了问题也不影响主仓库。4. 基础使用与命令详解4.1 交互模式最常用的日常形态部署完成之后日常最高频的形态就是交互模式。在项目根目录运行claude进入接着就可以像跟人聊天一样描述任务。交互模式里有几个高频斜杠命令值得记/help查看帮助信息。/model快速切换模型版本。/clear清空当前会话上下文上下文塞太多了就用这个。/memories查看和编辑跨会话记忆。/exit退出会话。除了纯文字描述Claude Code支持直接在命令里引用文件。你可以在对话里输入#再跟上文件路径CLI会自动读取该文件内容加入上下文。比如我想让它排查报错会这么写claude 帮我看看 #src/App.tsx 这个文件里的错误处理为什么没生效它的状态栏会显示当前模型、目录、Token用量上下文快满的时候能直观看到需要手动/clear继续。还有一个细节你可以在一条消息里同时引用多个文件也可以让它搜索相关代码。比如请对比 #src/utils/a.ts 和 #src/utils/b.ts告诉我哪个更合适做公共工具函数。这种先喂上下文再提问题的模式比单纯的给我写个排序函数要高效得多。4.2 打印模式与非交互调用交互模式适合人来盯着而自动化场景要用打印模式核心参数是-p或--print。它启动后执行一次任务输出结果然后退出不做交互确认。最基本的调用claude -p 为这个仓库的README写5个使用示例打印模式最有价值的地方是可以跟Shell管道结合。举个例子我排查线上日志的时候先过滤出异常片段再直接让CLI分析tail -n 200 app.log | claude -p 根据这段Java日志找出根因并按可能性列出三个排查方向这比先把日志复制到网页对话框再粘贴方便太多了。如果需要结构化输出配合--output-format json返回的是JSON方便脚本解析。例如claude -p 检查当前目录下所有JSON文件并返回格式错误的文件列表 --output-format json我在写自动化脚本时常用这种方式让CLI产出结果供脚本继续处理形成一个自然语言处理节点。常用参数速查表如下参数作用示例-p, --print非交互打印模式claude -p 解释这段代码--output-format json输出JSON格式claude -p 总结README --output-format json-c, --continue继续上一个会话claude -c 接着说上次的改动--resume恢复指定会话claude --resume 会话ID--model指定模型claude --model claude-sonnet-4-5--allowedTools工具白名单claude --allowedTools Bash Edit--add-dir追加工作目录claude --add-dir /path/to/other--dangerously-skip-permissions跳过全部权限确认慎用独立分支测试用4.3 让Claude自动完成复杂任务的三种姿势很多人的真实诉求不是让它写一段代码而是让它把一个复杂任务从头到尾跑完。我试着拆解一下怎么让这样的任务更可靠。第一任务描述要带边界和验收标准。不要说帮我重构登录模块而要说重构src/auth下的登录模块抽出AuthService类保持对外接口不变跑通现有的auth相关测试。边界越清楚AI跑偏的概率越低。第二用好会话的连续性。复杂任务别一次全塞进去分几轮对话逐步推进每轮结束让它总结进展和计划。你会发现前后文连贯性对最终质量的影响比模型参数还大。中断了可以用-c继续上次会话或者--resume恢复指定会话。第三建立评审-反馈循环。别让AI闷头干完整个任务而是规定它做完一个阶段就停下来展示改动你来评审再让它继续。虽然听起来多了一步但实际比最后一次性返工快很多。复杂度越高的任务这个节奏越有效。5. 进阶接入换用DeepSeek模型与MCP生态扩展5.1 通过兼容端点接入DeepSeek模型Claude Code默认只连Anthropic的Claude模型但社区里很常见的玩法是让它接入DeepSeek模型。DeepSeek提供了Anthropic兼容的API端点所以你可以通过环境变量把Claude Code指向DeepSeek。Linux或macOS下这样设置export ANTHROPIC_BASE_URLhttps://api.deepseek.com/anthropic export ANTHROPIC_AUTH_TOKENsk-你的DeepSeekKey export ANTHROPIC_MODELdeepseek-chat claudeWindows PowerShell下这样设置$env:ANTHROPIC_BASE_URLhttps://api.deepseek.com/anthropic $env:ANTHROPIC_AUTH_TOKENsk-你的DeepSeekKey $env:ANTHROPIC_MODELdeepseek-chat claude配置完成后原来的交互模式和打印模式都能正常工作但底层模型已经是DeepSeek了。我实际对比过几个模型接入后的差异deepseek-chat响应快适合日常代码生成、问答、批量修改。deepseek-reasoner推理深度更好适合复杂bug定位、架构拆解但响应慢一些。DeepSeek经过Anthropic兼容层的工具调用能力整体是够用的但某些极端复杂的长链路任务稳定性不如Claude系模型。所以我的用法是日常任务用DeepSeek跑遇到AI反复绕圈子的疑难问题再切回Claude。注意环境变量在终端关闭后会失效。如果你希望长期默认走DeepSeek可以在系统环境变量里固化或者写入Shell配置文件。另外不同模型的价格、上下文窗口、限流策略都不一样接入前建议到对应模型控制台确认额度避免任务跑到一半撞上限流。5.2 Claude Code CLI安装MCP并连接本地MySQLMCP的全称是Model Context Protocol模型上下文协议。你可以把它理解成AI的标准USB接口只要把外部工具和数据源封装成MCP服务器Claude Code就能直接调用而不需要为每个数据源写定制插件。这让Claude Code连接数据库、浏览器、文件系统这类能力变得通用化。实际操作中我用claude mcp add命令添加了一个本地的MySQL MCP服务。先确认本地MySQL在运行然后执行claude mcp add mysql -e MYSQL_HOST127.0.0.1 -e MYSQL_PORT3306 -e MYSQL_USERroot -e MYSQL_PASS你的密码 -- npx -y benborla/mcp-server-mysql这条命令的意思是为当前项目注册一个名为mysql的MCP服务器把连接数据库用的环境变量传给它然后通过npx启动对应的MCP服务包。-e是传环境变量包名我用的benborla/mcp-server-mysql它是一个社区常用的MySQL MCP实现。添加完成后可以核对claude mcp list claude mcp test mysqllist能查看当前注册的MCP服务器test会测试连通性。如果一切正常你在Claude Code里就可以直接说查看orders表结构统计最近7天的订单总量它会调用MCP工具连数据库取数据而不是瞎编。这里有几个实战注意点不要在生产库上直接配MCP尤其不要把生产密码写进项目的配置文件里。项目级配置会通过.mcp.json分享给同仓库同事密码这种敏感信息应该走个人级配置或环境变量。默认MCP给Claude的权限是完整SQL能力如果只想让它查表可以选配只读的MCP服务器包或者利用MySQL账号权限限制到只读。如果MCP连不上先自己用相同的环境变量跑一次MySQL客户端验证账号密码没问题再去排查MCP本身不要上来就怀疑Claude Code配置。MCP生态目前扩展速度很快文件系统、Playwright浏览器自动化、GitHub、PostgreSQL等都有现成服务器思路相通。一旦掌握claude mcp add这个模式等于给Claude Code装上了无限扩展的能力。6. 工具选型Claude Code、Codex、OpenCode怎么选6.1 三条路线的定位差异很多人在选择终端AI Agent时会在Claude Code、Codex、OpenCode之间摇摆。我三个都实际用了不短的时间给你一个尽量客观的对比维度Claude CodeCodexOpenCode出品方Anthropic官方OpenAI官方开源社区默认模型Claude系列GPT系列可配多家模型安装方式npm / 原生包npm / 原生包npm / 源码MCP支持原生支持生态丰富有一定支持支持权限控制细粒度模式切换灵活有但相对简化可自定义追求的人群Claude用户、看重Agent能力OpenAI生态用户想自由换模型、喜欢折腾的人Claude Code的优势在Agent能力和工具调用的成熟度。它对长链路任务的处理、多文件修改的稳定性、MCP生态完善程度目前在我项目里表现最好。权限控制是我最喜欢的一点能精细到允许哪些命令自动执行这让半自动开发成为了日常可用的状态。Codex的优势在于OpenAI模型用户基数大如果你本来就重度使用GPT系列上手成本最低。但它的工具链和权限模型相对简单在复杂项目里能做的事情没有Claude Code那么深。OpenCode是个开源激进派它最吸引人的是模型自由。你可以在一个工具里同时配置Claude、DeepSeek和其他模型配合Models.dev的模型注册表切换模型非常方便。它的社区活跃度很高很多新MCP很快就有支持。代价是稳定性偶尔飘有些配置需要自己折腾适合喜欢尝鲜和控制的工程师。6.2 我的实际组合与使用心得我目前的固定搭配是主力开发用Claude Code所有日常Agent编码操作都在它里面完成OpenCode当作多模型测试场想快速试验某个新模型时用它Codex则更多是观察和对比学习偶尔验证同一个任务在不同模型下的表现。这个组合不是拍脑袋定的而是根据实际产出效率来的。我自己观察到的数据是同样一个修改支付模块并补测试的任务Claude Code在权限自动化和MCP数据库支持下能比较顺畅地一次跑完OpenCode给我更多模型自由度但配置成本和偶发的不稳定让我不敢把它用在赶进度的任务里。这里提醒一句工具选型不要频繁切换。每个CLI工具都有各自的会话管理、记忆体系、配置约定习惯的切换成本被严重低估。选定一个主工具至少稳定用两周再评估效果比每个工具用两天就换要靠谱得多。7. 常见问题与排查技巧实录7.1 高频报错速查表部署和使用Claude Code过程中我遇到的报错大概能归成下面几类整理成速查表方便你排查报错/现象常见原因解决办法claude不是内部或外部命令npm全局目录不在PATHnpm config get prefix查看路径手动加入PATH首次启动授权页不弹出环境变量冲突或旧凭证残留检查ANTHROPIC_API_KEY环境变量清空~/.claude缓存后重试Connection error/ 连接超时网络不通或API服务异常先用浏览器访问对应服务确认连通性再检查环境变量是否指向正确的API地址429 rate limit请求频率超限降低调用频率检查模型账户额度等待限流窗口过中文乱码Windows终端编码不符在PowerShell执行chcp 65001切换UTF-8或在Windows Terminal设置默认编码Bash工具执行失败默认Shell识别异常Windows下在配置里指定Git Bash为Shell路径MCP连接失败MySQL账号/地址配置错先用原生客户端验证连接参数再claude mcp test定位遇到报错第一原则是不要慌着重装先看错误日志。claude的日志一般在~/.claude/logs目录下打开最新的日志文件往往能直接看到具体是哪一步失败。7.2 授权与权限控制的避坑经验关于权限这块我踩过几次坑之后总结出几条习惯。第一自动授权不是越猛越好。--dangerously-skip-permissions这个参数确实能让AI完全不问就执行任何命令但不到万不得已别用。我用它的场景只有一种独立的临时目录或测试分支里让它跑一个完全封闭的任务。一旦代码涉及生产分支或者重要数据宁可多花两分钟点几次确认。第二限制工具并不是限制能力而是提高稳定性。我用--allowedTools给不同项目定制白名单后AI的执行路径变得非常可预测。比如只允许它跑测试和git命令的项目它不会突然给你执行rm -rf之类的高危操作。第三跨目录操作要明说。默认Claude Code只操作当前工作目录如果你希望它改别的目录要用--add-dir显式增加目录。这既防止它改错地方也避免上下文意外读取到无关文件。7.3 Android UI业务开发实战小结之前有实习生问我怎么用Claude Code做Android UI相关业务开发这里简短分享一下我的方法。Android UI开发本质上分两层一层是布局代码包括XML布局和Compose代码另一层是配套的状态逻辑比如ViewModel、数据绑定。Claude Code擅长的是在两层之间做联动修改。比如你让它把登录页的输入框改成Material3样式同时更新对应的ViewModel校验逻辑它可以同时改动布局文件和状态逻辑文件这是纯手工操作里比较繁琐的工作。实际操作中我会先喂给它当前页面的布局文件和ViewModel比如用#引用claude 分析 #app/src/main/res/layout/activity_login.xml 和 #app/src/main/java/.../LoginViewModel.kt帮我重构UI结构保持业务逻辑不变然后让它给出具体的修改方案确认后再让它动手。改完以后让它在终端跑Gradle构建claude -p 运行 ./gradlew :app:compileDebugKotlin如果报错就分析原因并给出修复建议这里有一个重要体会Claude Code对UI代码层面的重构、批量修改、报错排查辅助效果很好但真正的视觉微调——比如间距是否舒服、颜色是否协调——仍然要靠Android Studio的Preview和人工审美判断。它的价值在于把改代码、跑构建、查报错这条链路自动化让你把精力集中在真正需要人判断的地方。对我个人来说Claude Code部署之后最大的改变是很多以前要开好几个窗口、反复切换上下文才能完成的脏活现在一个终端会话里就能顺序跑完。最后再分享一个小技巧我习惯在每个项目里维护一份精炼的CLAUDE.md里面固定写清楚构建命令、测试命令、代码风格和哪些操作不需要二次确认每次重新进入项目AI都能快速恢复到上次的高效协作状态。环境的稳定性和规则的清晰程度往往比模型本身更能决定你一天能写完多少代码。