1. 为什么我最终把主力开发工具换成了 Claude Code先说结论Claude Code 不是那种装完就完事的插件它是一个跑在终端里的 AI 编程代理能直接读写你本地的文件、执行命令、跑测试、改配置。我用了大概三个月从最初抱着试试看的心态到现在日常开发基本离不开它。这篇文章不讲虚的只讲我从零装到顺手用起来的完整过程包括中间踩过的坑、配置的取舍、以及怎么把本地模型接进来省钱。如果你属于以下几类人这篇内容会对你有直接帮助一是刚听说 Claude Code 但不知道从哪下手的新手二是装了但用不起来、卡在环境配置上的开发者三是想把它和本地模型比如 LM Studio、Ollama结合使用、降低调用成本的老手四是在 Windows、macOS、Linux 多平台之间来回切换、需要一套通用方案的人。我先把最核心的认知摆出来Claude Code 和你在 IDE 里用的那种代码补全插件完全是两码事。补全插件是被动的你打字它猜Claude Code 是主动的你给它一个任务描述它会自己去读项目结构、定位相关文件、修改代码、运行验证。这个区别决定了它的安装方式、使用习惯、以及你对它的预期都得重新调整。很多人第一次接触会问它和 Cursor、Copilot 有什么区别我的实际感受是Cursor 更像一个AI 增强的编辑器你还是在编辑器里操作Claude Code 更像一个能动手的助手你在终端里跟它对话它直接动你的文件系统。两者不冲突我现在是 Cursor 写日常代码Claude Code 处理跨文件重构、批量修改、环境搭建这类重活。关于账号和订阅这块网上信息很杂我只说我自己验证过的你需要一个可用的账号体系来登录具体订阅方式以官方页面为准。我见过有人因为频繁切换环境、多设备同时登录触发风控所以我的建议是固定一台主力机器使用不要今天在这台明天在那台来回折腾。这一点后面我会单独展开讲。2. 装之前必须想清楚的几件事环境、账号与工具链2.1 运行环境的最低要求和推荐配置Claude Code 本质是一个命令行工具通过 npm 分发。所以你的机器上必须有 Node.js 环境。我实测下来Node.js 版本建议 18 以上20 LTS 最稳。低于 18 的版本会在安装依赖时报各种奇怪的错别问我怎么知道的。平台最低要求我的推荐配置WindowsWin10 1909Win11 WSL2macOSmacOS 12macOS 14Linux主流发行版均可Ubuntu 22.04 LTSWindows 用户这里有个关键选择是直接在 PowerShell 里跑还是走 WSL2。我两种都试过直接跑能用但涉及文件路径、权限、shell 脚本的时候容易出幺蛾子。WSL2 里跑体验最接近 Linux 原生各种命令行为一致。如果你本来就熟悉 Linux 命令行强烈建议走 WSL2如果你完全没碰过 Linux那就先在 PowerShell 里跑起来别一上来就给自己加难度。内存方面纯跑 Claude Code 本身占用不大2GB 足够。但如果你要同时跑本地模型后面会讲那显存和内存就是另一回事了8GB 显存起步比较舒服。2.2 Node.js 和 npm 的安装别用系统自带的这是第一个大坑。很多 Linux 发行版和 macOS 自带的 Node.js 版本又老又乱npm 全局安装权限还经常出问题。我的做法是用版本管理工具。macOS 和 Linux 上我推荐用 nvm# 安装 nvm curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash # 重新加载 shell 配置 source ~/.bashrc # 或 ~/.zshrc # 安装并使用 Node.js 20 nvm install 20 nvm use 20 nvm alias default 20 # 验证 node -v # 应输出 v20.x.x npm -vWindows 上我推荐用 nvm-windows或者干脆在 WSL2 里用上面的 nvm 方案。用 nvm 的好处是不需要 sudo 就能全局装包版本切换干净卸载也彻底。注意如果你之前用系统包管理器装过 Node.js先卸干净再装 nvm否则 PATH 里会有多个 node排查起来很痛苦。2.3 账号准备与规避封号这件事的正确理解标题里提到规避封号风险我得把话说清楚所谓封号绝大多数情况不是因为你用了什么工具而是因为账号行为异常。我总结了几条实际经验固定设备使用不要频繁在多台机器、多个 IP 之间来回登录。不要共享账号给多人同时使用并发登录是风控的重点关注对象。订阅和支付信息保持稳定不要频繁更换。遵守服务条款不要用自动化脚本做违反条款的批量操作。说白了就是像一个正常用户那样使用。我自己的账号用了很久没出过问题靠的就是这几点。任何声称能绕过风控的方法我都不会碰也不建议你碰风险远大于收益。3. 安装 Claude Code 的完整流程与验证方法3.1 全局安装与首次启动环境准备好之后安装本身其实就一行命令npm install -g anthropic-ai/claude-code装完之后验证claude --version能输出版本号就说明装好了。如果报command not found八成是 npm 全局 bin 目录没在 PATH 里。用npm config get prefix看看全局目录在哪然后把它加到 PATH。首次启动直接在项目目录下敲cd your-project claude第一次运行会引导你完成登录授权。跟着提示走就行会打开浏览器让你确认。授权完成后回到终端你就进入交互界面了。3.2 在 VS Code 里用起来终端集成才是正解很多人搜vscode 配置 claude code其实不需要什么特殊插件。最顺手的做法是在 VS Code 里打开集成终端直接在项目根目录运行claude。这样你一边看代码一边跟它对话它改完文件你立刻能在编辑器里看到 diff。如果你想要更紧密的集成可以装官方或社区的 VS Code 扩展但我的经验是终端版本功能最全、更新最快扩展有时候会滞后。所以我的主力用法就是VS Code 集成终端 claude 命令。3.3 验证它真的能干活一个最小测试装完别急着上大项目先做个小测试确认它能读写文件。新建一个空目录进去运行 claude然后输入创建一个 hello.py打印当前时间然后运行它如果它自动创建文件、执行、把输出贴给你说明整条链路通了。这个测试能同时验证文件读写权限、命令执行权限、模型响应。任何一环有问题都会在这一步暴露。4. 把本地模型接进来LM Studio 与 Ollama 的实操配置4.1 为什么要接本地模型Claude Code 默认走云端模型能力强但按量计费。如果你有大量重复性的小任务比如批量改注释、格式化、简单重构全部走云端成本不低。这时候把本地模型接进来就很划算。本地模型跑在你自己的机器上不产生调用费用隐私性也好。代价是本地模型的能力通常不如云端大模型复杂任务容易翻车。所以我的策略是分级使用——复杂任务用云端简单批量任务切本地。4.2 LM Studio 的配置步骤LM Studio 是一个带图形界面的本地模型运行工具对新手友好。步骤去 LM Studio 官网下载对应平台的安装包装好。在软件里搜索并下载一个适合代码的模型比如 Qwen 系列的 coder 版本。加载模型切到 Local Server 标签页启动服务。默认端口是 1234。确认服务地址通常是http://localhost:1234/v1。然后在 Claude Code 这边通过环境变量指向本地服务export ANTHROPIC_BASE_URLhttp://localhost:1234/v1 export ANTHROPIC_API_KEYlm-studio # 本地服务通常不校验随便填再启动 claude它就会走本地模型。这里要注意不同版本的 Claude Code 对环境变量的读取方式可能有差异如果发现没生效检查一下是不是需要在配置文件里设置而不是临时 export。4.3 Ollama 方案与离线场景Ollama 更适合喜欢命令行的用户而且支持离线安装包内网环境也能用。基本流程# 安装后拉取模型 ollama pull qwen2.5-coder # 启动服务默认 11434 端口 ollama serveOllama 的 API 兼容 OpenAI 格式地址是http://localhost:11434/v1。配置方式和 LM Studio 类似改ANTHROPIC_BASE_URL即可。方案优点适合人群LM Studio图形界面模型管理方便新手、不想碰命令行Ollama命令行、支持离线、轻量老手、内网环境提示本地模型接进来之后响应速度取决于你的硬件。显存不够会疯狂调用内存速度断崖式下跌。跑之前先用小模型试水别一上来就上大参数模型。5. 日常使用中真正提效的几个习惯5.1 用 CLAUDE.md 给它立规矩这是我认为最值得花时间的一件事。在项目根目录放一个CLAUDE.md文件写上项目的技术栈、代码规范、目录结构说明、常用命令。Claude Code 每次启动会读这个文件相当于给它一份项目说明书。我自己的CLAUDE.md大概包含这些内容# 项目说明 - 技术栈Python 3.11 FastAPI PostgreSQL - 代码风格遵循 PEP8函数必须有类型注解 - 测试命令pytest tests/ - 不要修改 migrations 目录下的历史文件有了这个它改代码时会自动遵守你的规范省去大量来回纠正的口舌。5.2 任务描述要具体别让它猜新手最容易犯的错是给一个模糊指令比如优化一下这个项目。它会一脸懵地乱翻文件。正确的做法是给具体、可验证的目标差改改登录逻辑好在 auth.py 的 login 函数里把密码校验从明文对比改成 bcrypt 校验并更新对应的单元测试任务越具体它干活越准。这跟带新人的道理一样你说得越清楚返工越少。5.3 善用先规划后执行对于复杂任务我会先让它出方案确认没问题再让它动手。比如先不要改代码告诉我你打算怎么重构这个模块列出涉及的文件和步骤它给出计划后我审一遍觉得靠谱再让它执行。这一步能挡掉很多它自作主张改错方向的情况。6. 踩过的坑与排查思路6.1 安装报权限错误npm install -g报 EACCES这是 Linux/macOS 上的经典问题。根因是全局目录属于 root。解决方案有两个一是用 nvm前面推荐过二是改 npm 全局目录到用户目录mkdir -p ~/.npm-global npm config set prefix ~/.npm-global export PATH~/.npm-global/bin:$PATH我强烈推荐第一种一劳永逸。6.2 登录后一直转圈或超时这种情况我遇到过两次。一次是网络环境问题换个网络就好了一次是本地代理配置冲突终端里残留了旧的代理环境变量。检查http_proxy、https_proxy这些变量清掉再试。6.3 本地模型接了但没反应最常见的原因是 base URL 写错或者本地服务没真正启动。排查顺序先用 curl 直接打本地服务的接口确认服务活着再检查环境变量有没有被正确读取最后看 Claude Code 的日志输出。别跳过第一步很多人栽在以为服务启动了其实没有。6.4 它改错了文件怎么办这是必须提前想好的问题。我的做法是所有项目都用 Git 管理动手前确保工作区干净。这样它改错了git diff一看便知git checkout一键还原。没有版本控制就用 AI 改代码等于裸奔。7. 关于工具链搭配的一些个人体会把 Claude Code 用顺之后我的工作流大概是这样Git 管版本VS Code 写代码集成终端跑 Claude Code 处理重活本地模型兜底简单任务。这套组合跑下来效率提升是实打实的。我不建议一上来就追求全自动让 AI 接管所有编码。更现实的做法是把它当成一个执行力很强但需要你把关的助手你负责定方向和验收它负责动手和跑腿。这个定位摆正了用起来会舒服很多。最后分享一个小技巧每次让它做完一批修改我都会让它自己跑一遍测试并汇报结果。它跑测试、看报错、再修这个闭环能省掉我大量手动验证的时间。前提是你的项目得有像样的测试没有测试的项目这一步就只能靠人肉 review 了。