最近大半年我的日常开发基本长在终端里了。Claude Code 配合 vibe coding 这套玩法很多以前要憋一整天的需求现在一个下午能跑完三轮。这篇文章就集中聊我实际用下来的完整工作流怎么装、怎么配模型、怎么让 Claude Code 读懂你的项目最后把 vibe coding 从“看着好玩”变成“真能落地”。适合已经用过一点 AI 编程工具、但还没形成稳定方法的开发者也适合被“AI 写的东西不敢上生产”折磨过、想找个更受控姿势的人。先说结论vibe coding 不是“把键盘扔了让 AI 自己发挥”。它更像你把方向盘交出去但导航、路况判断和最终去哪还是自己心里有数。Claude Code 给了这种工作方式一个很舒服的形态——不打断你、能真正操作代码库、又保留了你随时叫停的权力。下面我会从环境准备一直讲到大型代码库里的实际协作顺带把踩过的坑都摊开说。1. vibe coding 火成现象之后我重新理解了这五个字1.1 Vibe coding 到底在“vibe”什么最早看到 vibe coding 这个词是 Karpathy 在社交媒体上随口聊的一种新编程体验你不再逐行手写代码而是给出一个相对模糊但方向明确的描述让 AI 把架子搭起来、把细节填上整个过程像在“跟着感觉走”。很多人把这句话理解成“甩手掌柜式编程”这其实是个误会。我自己的理解是vibe coding 的注意力重心从“怎么写”转移到了“写出来是不是我想要的”。传统编程里你的大脑同时要管语法、接口、边界条件、代码风格负担很重。而 vibe coding 模式下AI 承担了大部分机械劳动你把精力省下来做更有价值的事确认需求、设定验收标准、审阅改动、纠偏方向。这就好比你不会因为用了洗碗机就放弃判断哪个盘子不能进洗碗机vibe 的重点从来不是“不动脑”而是“把脑力用在更靠前的位置”。实际操作里vibe coding 最典型的形态就是你在终端里对 Claude Code 说“帮我给这个接口加个幂等处理用 Redis 做锁注意并发边界”然后它去改代码、加测试、跑一遍验证最后把 diff 摆在你面前。你更像一个教研组长在批改年轻老师的教案而不是每一行都要自己写。这也解释了为什么 vibe coding 特别依赖一个能主动执行任务的 agent 型工具而不是简单的代码补全或聊天窗口。补全工具只能在光标后面猜你下一个字符聊天窗口只能告诉你答案却不碰你的工程。Claude Code 这类终端 agent 才能做到“接需求、翻项目、改代码、跑验证”这一整条链路。1.2 Claude Code 在工具谱系里的准确位置现在市面上的 AI 编程工具大体分三类搞清楚区别才知道什么场景该用谁。第一类是 IDE 补全插件比如 GitHub Copilot 的自动补全模式。它的价值在“你写代码时给你递砖头”适合你已经很清楚要怎么写、只是需要提速度的场景。它不会替你完成一个跨多文件的改动因为它没有“任务”的概念。第二类是对话式助手比如各种聊天插件。你问它“这个 bug 可能是什么原因”它给你一段解释。它的输出停在“建议”要不要执行、怎么执行全靠你手动搬。好处是安全坏处是大量工作仍然需要你自己完成所谓“AI 写代码”其实只完成了一半。第三类就是 Claude Code 所在的终端 agent 阵营。它以命令行工具的形式运行能自己列目录、读文件、执行测试、运行 lint、修改代码、甚至提交 git。你和它的交互不是“一问一答”而是“分派任务—检查结果—继续调整”。在 vibe coding 的工作流里它是唯一能真正把“让 AI 写代码”闭环起来的形态。Claude Code 有几个点让我觉得它在同类里特别顺手。首先是权限模型它可以被配置成只读、只允许编辑特定目录、或者完全信任这个对生产项目太关键了其次是长上下文能力你真的可以往会话里塞一个中大型项目的结构信息再就是它的检查和回滚机制比如自带 checkpoint关键操作前会自动留恢复点。这些都是 vibe coding 能从“玩具”变成“生产力工具”的基础。2. 环境准备与安装从零到能跑通 vibo2.1 安装方式怎么选Claude Code 的安装路径主要有三条不同系统有不同的推荐姿势。如果你是 macOS 或者 Linux直接用官方提供的原生安装脚本最省事在终端执行官方安装命令后它会自动把二进制装到合适的位置后续升级也有对应的命令不污染系统。如果你习惯用 Node.js 生态也可以走 npm 全局安装npm install -g anthropic-ai/claude-code装完输入claude --version能出版本号就说明基础环境 OK。Windows 上我踩过几次坑简单说下老版本时代 Windows 必须靠 WSL 才能跑得顺现在官方已经支持原生 Windows但如果你习惯在 WSL 里做开发直接在 WSL 里安装一样没问题。关键是要注意别把两个环境的 CLI 搞混了不然 VSCode 里打开终端却找不到命令十有八九是 PATH 指错了环境。还有一个很常见的报错“由于与 64 位版本的 Windows 不兼容”。这个多半是安装包或脚本下错架构了你在一台 x64 机器上装了个 ARM 版或者反过来。解决方式很简单确认系统架构重新下载对应版本不要手动去改兼容性设置硬撑那只会埋更多雷。2.2 登录与账号订阅的坑装好之后输入claude首次运行会引导你登录。这里两条路一是用 Claude 订阅账号授权二是用 API key 走按量付费。个人开发者我建议直接走订阅账号体验最完整也不用心疼 token 账单团队使用则可能更倾向 API key方便统一管理和审计。有一个很典型的报错热搜里也有your organization has disabled claude subscription access for claude code。我第一次在公司电脑上遇到时还以为是工具坏了其实是管理员在后台把 Claude Code 的订阅访问权限关掉了。这种场景通常是企业账号通过管理后台统一控制了工具权限个人账号没被拉白名单。解决路径只有一条找 IT 管理员确认策略、把你加入允许列表或者干脆用自己的个人订阅账号登录。别想着绕这种权限设计本身就是公司安全策略的一部分遵守它才是对自己和公司负责。2.3 环境变量与第三方模型接入Claude Code 默认走 Anthropic 官方模型但它的结构其实是可配置的。通过环境变量你可以把底层模型源换成本地模型或者其他兼容服务这在国产模型和本地推理玩家中非常流行。核心环境变量就这几个变量名作用典型示例ANTHROPIC_MODEL指定会话使用的模型claude-sonnet-4-5ANTHROPIC_BASE_URL覆盖模型服务地址http://127.0.0.1:1234/v1ANTHROPIC_AUTH_TOKEN自定义服务时的认证令牌本地服务填lm-studioANTHROPIC_API_KEYAnthropic API 密钥sk-ant-xxx比如你想接 LM Studio 跑的本地模型可以这样启动export ANTHROPIC_BASE_URLhttp://127.0.0.1:1234/v1 export ANTHROPIC_AUTH_TOKENlm-studio export ANTHROPIC_MODELlocal-model-name claude关键是 LM Studio 里要先把本地服务器启动并且你选的模型必须支持工具调用。Claude Code 是 agent 型工具它要通过 tool calling 来执行命令、读写文件如果底层模型不支持这个能力你会看到它答非所问、或者想用工具却一直报错整个 vibe 完全起不来。接入 DeepSeek 也是同理。DeepSeek 提供了 Anthropic 兼容 API 端点所以对 Claude Code 来说几乎是透明的export ANTHROPIC_BASE_URLhttps://api.deepseek.com/anthropic export ANTHROPIC_AUTH_TOKEN你的API-KEY export ANTHROPIC_MODELdeepseek-chat claude这样一顿操作下来你在终端里面对的还是同一个 Claude Code 界面但底层推理的已经是别的模型了。省钱、隐私、模型偏好都通过环境变量解决。需要注意不同模型的能力差距在复杂工具链场景下非常明显轻任务可以切便宜模型重活记得切回强模型这个后面我会专门聊。3. 大型代码库里的工作流设计从“能跑”到“靠谱”3.1 先把 CLAUDE.md 当成新员工入职手册来写很多人装好 Claude Code第一件事就是丢个任务让它干活然后抱怨“AI 不懂我的项目”。问题几乎都出在同一个地方你没有一个清晰的 CLAUDE.md。CLAUDE.md 是 Claude Code 在每次会话中都会读取的项目记忆文件相当于给 AI 的入职培训手册。它分两个层级放用户主目录的~/.claude/CLAUDE.md是你的个人偏好适用于所有项目放项目根目录的CLAUDE.md是团队约定只对当前仓库生效。我一般这样写项目级 CLAUDE.md# 项目简介 这是一个基于 Spring Boot 的支付网关核心模块包含订单、退款、对账。 # 常用命令 - 启动测试./mvnw test - 代码规范检查./mvnw spotless:check # 关键约定 - 新增接口必须写明幂等键禁止裸 Redis 操作 - 数据库迁移脚本存放在 db/migration命名遵循 V{版本}__{描述}.sql - 涉及金额的字段一律用 decimal禁止 double # 禁忌 - 不要修改 protobuf 生成的代码改 .proto 后自行重新生成 - 不要动 balance-service 的旧版同步逻辑那是历史债宁可新增也不能重构写旧版 CLAUDE.md 后Claude Code 启动时就会带着这套“公司制度”去理解你的请求。它的工具调用会更精准不会踩你项目的雷沟通成本直线下降。我实测的感受是没有 CLAUDE.md 时AI 像个聪明的实习生到处踩坑写完 CLAUDE.md 之后它像个入职三个月的正式员工基本不用你操心常识问题。3.2 别上来就开干先让 AI 画地图进入一个陌生的大型代码库时我的习惯是不着急谈需求先让 Claude Code 帮我梳理结构。你可以直接说“请先阅读项目 README 和核心模块的目录结构输出一张当前代码库的地图包括模块清单、依赖关系、关键入口。”甚至可以直接键入/initClaude Code 会自动扫描项目并生成一份初始化的 CLAUDE.md把你需要维护的“入职手册”先立起来非常省事。这个过程看起来是在摸鱼其实是在校准 AI 的上下文视角。AI 读代码和我们人读代码一样先有全局地图再看局部细节理解深度完全不同。你要避免的典型错误是对话框一开就直接输入“修复某某模块的 bug”结果 AI 花了大半天在错误的地方打转。先让它花几十秒建立地图后面每一步的效率都会高很多。另外要提醒的是别试图把整个仓库一次性塞进上下文。大型项目的上下文管理是 vibe coding 成败的关键Claude Code 虽然支持很长的上下文窗口但一次性塞入过多代码会导致推理质量下降、响应变慢、成本飙升。正确做法是让 AI 先通过 grep、ls、查看目录结构自己定位相关文件再让它按需读取具体文件内容。你只要告诉它方向它自己会知道该翻哪本书。3.3 计划模式与执行模式的切换节奏Claude Code 里有个非常重要的习惯大改动先走计划模式小改动直接执行。官方提供了 plan 模式在这个模式下 AI 不会直接改文件而是先输出方案、列出改动点、给出影响面等你确认后才动手。这个设计太适合 vibe coding 了因为它把“盲目执行”和“理性规划”拆开了。我的流程是这样的需求下来先切到 plan 模式让 AI 给出实现方案读完方案后觉得 OK切换回执行模式让它动手改完之后不急着让它继续先自己看一眼 diff确认没问题再让它补测试、跑回归。这个“计划—执行—检查”的节奏一旦养成AI 写出来的代码基本不会滑出预期。同时我强烈建议你留意 checkpoint 功能。Claude Code 会在关键操作前自动为工作区建恢复快照一旦 AI 改坏了什么你可以快速回退到上一个可用状态。这相当于给 vibe coding 上了一道保险丝你可以更放心地让 AI 放开手脚。还有一个容易被忽视的点如果会话太长上下文会逐渐变“糊”。我的习惯是在完成一个中型任务后执行/compact压缩上下文或者/clear开启新会话让 AI 轻装上路。你不需要让一个会话永远持续下去谈崩了就换成本很低效果反而更好。3.4 用 Hooks 和 Skill 把重复动作变成肌肉记忆vibe coding 用得越深你会发现自己重复交代的事情越来越多。比如每次改完代码都要 AI 自动跑一遍 lint 和测试或者项目里有一系列固定的代码审查标准。这些东西可以沉淀成 Claude Code 的两个机制Hooks 和 Skill。Hooks 是挂在工具调用生命周期上的自动化脚本。你可以配置在 AI 执行某个操作前或者操作后自动触发命令。比如在它执行完文件编辑后自动跑一遍npm test或者在它执行git commit前自动做代码格式校验。相当于给 AI 戴上了一副“条件反射”的手铐不用每次口头提醒。配置在.claude/settings.json里下面是一个简化的语义示例{ hooks: { PreToolUse: [ { matcher: bash, hooks: [ { type: command, command: echo 即将执行命令注意生产环境操作 } ] } ], PostToolUse: [ { matcher: Edit, hooks: [ { type: command, command: npm test -- --runInBand } ] } ] } }Skill 则是更高级的自定义指令包。你可以把项目的代码规范、常用重构步骤、测试书写范式封装成一个 Skill存放在.claude/skills/目录下里面用 SKILL.md 描述触发条件和执行步骤。以后只要输入/skill名AI 就会按这套封装好的标准工作。这个设计让团队的编码规范真正变成了可执行的流程而不是文档里躺着的一句空话。4. 上下文、成本与权限三个最容易失控的地方4.1 别迷信长上下文喂得越多脑子越糊Claude Code 的宣传点里有很长上下文窗口听起来很诱人仿佛可以把整个项目都塞进去让它随便翻。实际用过之后我劝你冷静长上下文是双刃剑。窗口拉长后AI 的注意力被分散越早的信息越容易被“淡忘”推理速度和稳定性也会下降而且在 API 计费模式下token 消耗会直接变成账单上的数字。正确姿势是“精准投喂”。与其把整个模块的源码一股脑丢给它不如告诉它“去src/modules/order目录里找幂等相关的实现”。让它自己翻文件它找到的关键代码天然带着项目语境比你手动复制粘贴的半截代码更连续。必要的时候用文件名显式引入单个文件把上下文预算花在刀刃上。这里也介绍一下网页搜索能力。Claude Code 现在支持 web search碰到“某个新版本库的 API 变了”这种问题直接用命令搜索最新文档不要让 AI 凭训练数据里的旧记忆硬编。对 vibe coding 来说能查到实时信息比单纯靠模型记忆可靠得多。4.2 成本控制别让 AI 把你的余额烧光我用 Claude Code 这么久见过太多人头脑一热把大模型当免费劳动力一周下来账单惊人。其实成本控制说穿了就三板斧。第一板斧是模型分级。轻量级任务——比如解释一段代码、写个正则、补个注释——完全可以用更便宜的模型甚至本地模型走起真正需要强推理的重活比如跨模块重构、架构设计再切换到最强模型。Claude Code 的模型选择可以通过环境变量或运行时命令切换养成“任务分级”的习惯成本直接降一个量级。第二板斧是限制轮数。--max-turns参数可以限制单次会话中 AI 的最大工具调用轮数防止它在一个问题上反复横跳、无限自嗨。我的经验是一个中型任务给 20 到 30 轮足够如果一个任务超过这个轮数还没搞定大概率是方向错了应该停下来复盘而不是让它继续烧钱。第三板斧是常看账单。Claude Code 里可以用/cost查看当前会话的 token 消耗和估算费用养成“每一轮大改动完看一眼”的习惯。你不需要精确到每一分钱但要有数字敏感度这能帮你及时嗅到失控的信号。4.3 权限模型给 AI 戴上合适的手铐让 AI 拥有操作代码库的能力听起来很爽但你必须给它划定边界。Claude Code 的权限配置从严格到宽松大致分几个档plan 模式只读不改、默认模式每次操作要你确认、acceptEdits 自动接受文件编辑但仍然管控执行命令、bypassPermissions 完全信任。在真实项目里我给 Claude Code 的原则是能改代码但别碰危险命令。在settings.json的 permissions 里可以显式约束它能用和不能用哪些工具比如禁止rm、禁止git push而允许npm test和git diff。{ permissions: { allow: [ Bash(git diff), Bash(npm test), Read ], deny: [ Bash(rm -rf *), Bash(git push) ] } }这套配置的核心思想是把 AI 当成一个有权限的新同事而不是一个无所不能的神。它可以自由发挥但踩到红线时系统会拦下来。配合前面说的 hooks你甚至能让它在越权动作发生前收到警告这种多重保险机制是 vibe coding 能进入生产环境的底气。5. 常见报错与避坑实录5.1 高频报错速查表vibe coding 的体验确实爽但工具本身的报错一点也不少。我把这段时间高频遇到的报错整理成一张速查表方便你对着症状找药方。报错或现象常见原因解决思路InternetOpenURL() failed: 0x800系统网络栈异常、证书链不完整或本地时间严重偏差校准系统时间更新根证书排查本地防火墙是否拦截 CLI 请求your organization has disabled claude subscription access企业账号在后台限制了 Claude Code 访问联系管理员检查权限策略确认账号是否被拉入白名单“与 64 位版本的 Windows 不兼容”安装了错误架构的安装包确认 CPU 架构重新下载对应版本接入本地模型后无响应本地模型不支持工具调用agent 能力失效换一个支持 function calling 的模型重新配置环境变量接入第三方 API 报 401BASE_URL 或认证令牌配置错误检查地址是否包含 Anthropic 兼容路由核对 API KeyCannot find module一类的 Node 报错Node 版本过低或全局安装路径异常升级 Node 版本重新执行全局安装检查 PATH在 VSCode 里找不到 claude 命令终端 PATH 未刷新或工作区环境不同重启终端、刷新 PATH确认是否同属一个 Shell 环境5.2 工作流层面的坑与我的处理经验除了上面这些硬报错vibe coding 里更隐蔽的坑是工作流层面的。我总结三条最值得注意的。第一条AI 改完代码测试挂了。这几乎是 vibe coding 的标配场景原因是 AI 习惯“先写实现、后补测试”而实现它自己的测试逻辑可能存在盲区。我的解法是在任务描述里就写明“先写测试用例再实现逻辑”让 AI 按 TDD 的顺序工作。如果它一上来就改实现我会主动打回“请先为这个功能补充失败测试。”第二条AI 在一个问题上反复横跳。典型表现是它为了修一个 bug方案换了三四次越改越乱。这种时候不要继续 vibe 下去马上喊停让它先用/compact或/clear清空上下文然后重新用计划模式提出方案。多数情况下换成新会话之后 AI 的思路会清爽很多因为旧的混乱上下文已经被清掉了。第三条嵌入式或特殊工具链场景比如 STM32。Claude Code 完全可以帮你生成寄存器配置、外设初始化代码、驱动骨架而且做得又快又好。但编译、烧录、硬件调试的链路强烈依赖本地工具链AI 给不了你硬件层面的实时反馈。我的做法是让 AI 负责生成和解释代码编译和验证自己手动跑把它当一个懂行的协作者而不是全自动流水线。你可以让它“检查这段启动代码里时钟配置是否有遗漏”效果远好于让它“直接把整个工程编译出来”。另外补充一个 VSCode/IDE 插件的选择问题。Claude Code 官方提供 VSCode 扩展安装后可以直接在编辑器里唤起终端会话查看 diff 的体验很好。如果你用的是 IntelliJ IDEA 系也有社区插件可用但我更建议你在 IDEA 里只把 Claude Code 当外部终端工具让它在命令行里跑而不是强行追求插件整合。开发环境的核心是稳定别为了界面好看给自己增加排错成本。最后说点个人体会。vibe coding 被很多人理解成“躺着让 AI 把活干完”但真正让项目从不失控的恰恰是那些看起来不太“vibe”的部分CLAUDE.md 写好、模型选对、权限卡紧、每一轮改动都 git diff 看一眼。所谓 vibe是你把专业判断力省下来用在刀刃上而不是把责任全丢给机器。如果你刚开始用 Claude Code我建议第一次就花半小时把 CLAUDE.md 写好暂时先别管技巧和优化。两周后你会回来谢我的。