Claude Code新手六步协作节奏：从命令表到项目宪法

1. 新手用Claude Code真没必要背全命令表大家好我是Lazy熊一个在AI编程工具一线踩过坑、搭过环境、也帮几十个团队落地过Claude Code工作流的实践者。过去三个月我给初创公司做技术顾问时几乎每周都会被问到同一个问题“Claude Code命令太多到底该从哪几个开始”——不是问“怎么部署”也不是问“模型怎么选”而是卡在最基础的交互层不知道敲什么、怕敲错、更怕敲了没反应。这种焦虑特别真实尤其当你刚把环境跑起来满心期待让AI帮你写接口、补测试、修Bug结果第一句就卡在/xxx上连help都打不出来。其实根本原因不在命令本身而在于新手对Claude Code的交互逻辑存在一个关键误解它不是传统IDE那种“功能菜单式”的工具而是一个上下文驱动的对话型编程协作者。它的每个命令本质都是在向这个协作者发出一个明确的“协作意图信号”。比如/init不是在执行某个脚本而是在说“嘿我现在要正式带你进这个项目请你先读完这份说明书再开工”/diff也不是生成git diff而是在说“刚才我们共同完成了修改请你用你的理解帮我核对一遍改动是否精准匹配我的原始需求”。所以这篇内容不叫“Claude Code命令速查表”而叫“新手前六步协作节奏训练”。我挑出来的这六个命令——/help、/login、/init、/status、/diff、/clear——不是按字母顺序排的而是严格对应你第一次打开终端、输入第一个字符、直到完成第一次有效代码修改的完整心理动线和操作闭环。它们覆盖了从“我懵了”到“我信了”的全部关键节点。你不需要记住所有参数但必须理解每个命令背后那个具体的、可感知的协作场景。比如/login它解决的从来不是“账号登录”这个技术动作而是“我凭什么相信你现在服务的是我而不是别人”这个信任建立问题/clear也不是清空聊天记录而是主动按下暂停键对一段已经偏离轨道的协作关系进行温柔重置。这些命令之所以能成为新手起点并非因为它们“简单”而是因为它们天然具备容错性与可验证性。/help输错会返回友好提示/status永远有确定输出/diff的结果你能一眼看懂是否合理。它们不依赖你对模型原理的理解只依赖你对自身项目状态的判断。这才是真正适合起步的节奏用最小认知负荷换取最大确定性反馈。接下来我会一层层拆开这六个命令不讲语法只讲你在什么情境下会伸手去敲它、敲完之后预期看到什么、如果没看到又该怀疑哪里——就像教一个朋友用新工具那样手把手不绕弯。2. 核心命令深度解析每个敲击背后的真实意图2.1/help不是说明书是你的“紧急锚点”很多新手第一次输/help是发现AI没按自己说的做急了想翻手册。但/help真正的价值恰恰在于它不是一本静态说明书而是一个动态的、带上下文感知的求助入口。当你在终端里敲下/helpClaude Code不会甩给你一份PDF文档而是会结合你当前所处的环境比如是否已登录、是否在项目根目录、最近一次/init生成的CLAUDE.md内容给出一组高度相关的、可直接点击执行的快捷命令建议。举个真实例子上周我帮一个做电商后台的团队调试他们卡在API鉴权逻辑上。工程师反复让AI“修复JWT校验失败”但AI总在改token生成逻辑而不是检查中间件配置。他一气之下敲了/help系统立刻返回当前上下文检测到/init 已执行CLAUDE.md 中定义了 auth 模块规范 推荐下一步 • /explain auth/middleware.js —— 让Claude解释当前鉴权中间件 • /list-rules auth —— 查看项目中关于auth模块的所有约束 • /status —— 确认当前模型是否加载了auth相关上下文你看这不是通用帮助而是基于他项目里那份CLAUDE.md文件内容生成的精准导航。/help的底层逻辑是它把你的项目规则、当前状态、历史交互都当作输入动态生成最可能解决你此刻困惑的“下一步动作”。所以别把它当字典查要当成一个会思考的协作者在问你“你现在最想搞清楚哪件事我来帮你聚焦。”提示/help支持带参数比如/help init会专门解释/init的全部选项和常见陷阱比无参调用信息更聚焦。但新手建议先无参试一次感受它如何根据你的环境“猜你想问”。2.2/login登录的本质是“身份契约”的建立/login看起来就是个登录框但它背后承载的是Claude Code工作流中最关键的一环身份与权限的绑定确认。很多人以为登录只是输邮箱密码实际上Claude Code的/login过程包含三个隐性阶段凭证交换阶段你输入的不是传统密码而是API Key或OAuth Token。这个Token决定了Claude Code能访问哪些资源比如能否读取你GitHub私有仓库、使用哪个模型Claude-3.5-Sonnet还是Opus、以及计费归属个人账户还是企业订阅。上下文初始化阶段登录成功后Claude Code会自动加载你账户下的默认偏好设置比如代码风格Prettier还是ESLint、语言偏好中文注释还是英文、甚至常用模板React组件还是Express路由。这些设置不会显示在界面上但会默默影响后续所有生成结果。信任链建立阶段这是最容易被忽略的。当你首次登录Claude Code会在本地生成一个加密的.clauderc配置文件里面存储了经过哈希处理的Token片段和设备指纹。这个文件的存在意味着你后续所有/init、/diff操作都被视为“经你本人授权的、可信环境中的行为”。如果某天你发现/diff突然不显示变更详情第一反应不该是重装而是检查.clauderc是否被误删或权限异常常见于Mac系统升级后Home目录权限重置。实操中我见过最多的问题不是登不上而是登错环境。比如开发环境用个人Key生产环境却误用了测试Key导致AI生成的数据库连接字符串指向了错误的集群。这时候/login --list就能列出所有已保存的配置用/login --use prod快速切换比重新输一遍Key安全得多。注意/login不支持明文密码输入。如果你看到密码提示符闪烁后无响应大概率是终端不支持隐藏输入如某些Windows PowerShell版本此时应改用/login --key your_api_key方式直连避免卡在输入环节。2.3/init不是生成文件是启动“项目说明书”工程/init常被简化为“生成CLAUDE.md”但这严重低估了它的作用。/init真正的核心任务是为你和Claude Code之间建立一套可执行、可验证、可迭代的协作协议。它生成的CLAUDE.md不是一份静态文档而是一个活的、带语义的“项目宪法”。这个文件的结构设计非常讲究。以我给一个物联网设备管理平台做的/init为例生成的CLAUDE.md包含这些必选区块# 项目宪法IoT-Device-Manager ## 核心目标 - 所有API必须兼容LoRaWAN v1.0.3协议栈 - 设备状态上报延迟 ≤ 200msP95 - 禁止在任何业务逻辑中硬编码MQTT Broker地址 ## 目录约束 - /src/core/仅允许修改设备心跳检测逻辑 - /src/api/v1/新增端点必须包含OpenAPI 3.0 Schema定义 - /tests/integration/所有测试需覆盖断网重连场景 ## ️ 开发规范 - 日志级别DEBUG仅用于/src/debug/模块其余模块默认INFO - 错误码HTTP 4xx必须映射到errors/device_*.json预定义模板 - 提交前必须运行npm run lint:fix npm test -- --coverage看到没这里没有一句废话每一条都是Claude Code后续所有操作的“判决依据”。当你执行/diff时它会逐行比对修改是否违反目录约束当你让AI“优化设备注册流程”它会优先检查核心目标里的延迟要求再决定是否引入缓存甚至当你/clear重置后重新描述需求Claude Code也会自动回溯这份宪法确保新方案不违背既定原则。所以/init不是一步到位的操作。我建议新手分三轮跑第一轮/init --quick用默认模板快速生成骨架第二轮手动编辑CLAUDE.md把团队晨会刚定的三条红线加进去第三轮/init --validate让Claude Code自己检查这份宪法是否存在逻辑冲突比如同时要求“禁止硬编码”又要求“所有配置写死在.env”。实操心得/init生成的CLAUDE.md必须提交到Git。这不是为了备份而是为了让Claude Code每次启动时都能从版本历史中学习项目演进规律。比如你上周删掉了/src/legacy/目录这个删除记录会成为Claude Code理解“当前架构已无遗留模块”的重要依据。2.4/status状态面板是你的“驾驶舱仪表盘”/status返回的从来不是一堆冷冰冰的参数而是一张实时更新的协作健康度仪表盘。新手常犯的错误是把它当ps aux用只扫一眼就关掉。但真正有价值的是理解每个字段背后的协作含义字段典型值协作含义异常信号Context Window12,842 / 200,000 tokens当前对话已消耗的上下文容量。超过15万tokens时Claude Code会自动压缩早期对话可能导致遗忘关键约束。突然从8万跳到18万说明前面有大段未清理的调试日志被误认为有效上下文Active Rules7 (from CLAUDE.md)当前生效的项目规则数量。数字下降意味着部分规则被Claude Code判定为“过期”或“冲突”。显示0CLAUDE.md文件被移动或权限不足Claude Code读取失败Model Latencyavg: 1.2s, p95: 2.8s模型响应时间的稳定性指标。p95值持续高于3秒说明当前模型负载过高或网络波动。p95: 8.5s且Context Window正常大概率是API Key配错了区域如国内用户误用us-east-1端点Workspace Sync✓ /Users/lazybear/project工作区同步状态。打钩表示Claude Code已完整索引当前目录结构。✗ /Users/lazybear/project常见于VS Code远程开发时本地路径与容器内路径不一致我有个硬性规定任何团队成员在提Issue前必须先贴出/status输出。上周一个前端同学抱怨“AI总把Vue2语法改成Vue3”/status显示Active Rules: 0一查发现他把CLAUDE.md放在了/src子目录而非项目根目录Claude Code根本没读到那条“强制使用Vue2 Composition API”的规则。关键技巧/status --verbose会显示更底层的诊断信息比如当前加载的Git分支、最近一次git log -1的commit hash、甚至Python虚拟环境的site-packages路径。这些信息在排查“为什么AI生成的代码和本地环境不兼容”时比看报错堆栈还管用。2.5/diff差异对比是“人机协作验收”的唯一标尺/diff是Claude Code工作流中最反直觉也最关键的命令。新手常以为它是git diff的替代品其实完全相反/diff的使命不是展示技术变更而是将AI的“理解”与你的“意图”进行语义对齐验证。举个典型场景你让AI“给用户注册接口增加手机号格式校验”它返回✅ 已修改 /src/api/auth/register.js ✅ 已添加 /src/utils/phone-validator.js ✅ 已更新 /tests/unit/auth/register.test.js然后你敲/diff看到的不是文件差异而是这样一段结构化摘要【语义变更分析】 • 校验逻辑新增正则 /^1[3-9]\d{9}$/符合中国手机号规范 • 错误处理当校验失败时返回HTTP 400 { code: INVALID_PHONE }匹配CLAUDE.md第12行错误码规范 • 性能影响校验函数为纯函数无外部依赖不影响接口P95延迟当前实测0.3ms • 风险提示未修改短信发送模块若该模块也需校验请执行 /explain src/services/sms.js看到没这才是/diff的真相它把技术变更翻译成业务语言告诉你“AI理解的‘手机号校验’是否等于你心里想的‘手机号校验’”。如果摘要里写着“使用了第三方库validator.js”而你的CLAUDE.md明确写了“禁用所有未声明的npm依赖”那这个diff就必须打回去。我坚持让所有团队成员养成一个肌肉记忆每次AI返回“已完成”第一反应不是点保存而是敲/diff。而且必须逐行阅读摘要不是扫一眼。上周一个支付模块的Bug就是因为工程师没细看/diff里的“风险提示”——AI在修改订单状态机时自动补充了“取消订单需通知风控系统”而风控系统接口当天正在灰度这条补充差点引发资损。注意事项/diff的准确性高度依赖/init的质量。如果CLAUDE.md里没写清楚“所有支付相关变更必须通过风控白名单”/diff就无法识别这个风险点。所以/diff不是万能的它是你前期投入的“项目宪法”质量的放大器。2.6/clear重置不是放弃是主动的“协作节奏管理”/clear常被误解为“重启大法”但它的精妙之处在于它重置的不是对话历史而是协作关系的默认假设。当你敲下/clearClaude Code不会忘记你项目里的CLAUDE.md也不会丢失登录状态但它会主动放弃所有基于过往对话形成的“临时共识”。比如你之前聊过三次“如何优化数据库查询”每次AI都建议加索引但你都没采纳。第四次你问“还有别的优化方法吗”AI可能继续推荐索引方案因为它记得“你似乎对索引方案持开放态度”。但如果你先/clear再问同样的问题AI会回归CLAUDE.md里的原始约束比如“所有SQL优化必须先通过EXPLAIN分析”从零开始推理给出完全不同的答案。这就是/clear的深层价值它让你从“被历史对话绑架”中解脱出来重新获得对协作节奏的绝对控制权。我在带新人时会强制他们每完成一个功能点就/clear。表面看是清聊天记录实际是训练一种思维习惯每个新任务都值得一个干净的、不带偏见的起点。实操中/clear有两个黄金时机方向迷失时当对话连续三次给出偏离需求的答案不要硬着头皮追问/clear后用一句话重述核心目标比如“只做一件事把用户头像上传逻辑从本地存储迁移到S3其他都不动”上下文污染时当你在调试时粘贴了大段报错日志AI开始过度关注日志里的某个无关warning/clear后直接说“忽略所有日志只关注upload.js第42行的逻辑”。提示/clear后Claude Code会自动重新加载CLAUDE.md并显示摘要。如果摘要里出现“⚠️ 检测到规则冲突”说明你之前的对话无意中触发了某些隐性约束这是/clear帮你发现潜在问题的意外收获。3. 新手六步实操闭环从敲第一个命令到交付第一行代码3.1 第一步用/help定位你的“此刻困惑”别一上来就查文档。打开Claude Code终端直接敲/help。观察它返回的内容——重点不是记下所有命令而是看它如何根据你当前环境给出建议。如果你刚安装完还没登录它会高亮/login如果你在项目根目录但没/init它会推荐/init --quick如果你已经登录且有CLAUDE.md它可能直接建议/status。这个动作的价值在于训练你建立“环境感知”意识。很多新手卡住不是因为不会命令而是根本没意识到自己处于什么状态。/help就是一面镜子照出你和工具之间的认知差。实操记录今天上午一个做教育SaaS的客户联系我说“AI总把React组件写成Vue语法”。我让他先敲/help返回结果第一行是⚠️ 未检测到CLAUDE.md文件。建议/init --template react-ts原来他跳过了/initClaude Code默认按通用模板处理自然不识别React约束。/help这一眼省了两小时排查。3.2 第二步用/login建立“可信通道”执行/login但不要急着输Key。先看它提示的登录方式——如果是OAuth就走浏览器授权如果是API Key注意观察提示里写的Key格式要求比如是否需要sk-ant-xxxx前缀。输完后务必执行/status确认登录成功重点看Account Status字段是否显示✓ Active。这里有个关键细节/login成功后Claude Code会自动生成.clauderc文件。新手常忽略这点导致换终端或重启后又要登录。我的做法是登录后立刻执行cat ~/.clauderc | grep account_id把返回的account_id复制下来存在密码管理器里。这样下次环境异常可以直接用/login --account-id copied_id快速恢复不用重新走认证流程。注意国内用户常遇到的“登录超时”90%是因为终端DNS解析慢。解决方案不是换源而是执行/login --timeout 60把超时阈值从默认的15秒拉到60秒给DNS留足时间。3.3 第三步用/init起草“项目宪法”进入你的项目根目录执行/init --quick。等待几秒它会生成一个基础版CLAUDE.md。现在停下打开这个文件用5分钟做三件事删除所有TODO和[Example]占位符在Core Goals里用一句话写下你今天最想解决的问题比如“让用户注册接口支持微信一键登录”在Directory Constraints里明确写出本次修改涉及的文件路径比如/src/pages/auth/register.tsx。做完这些再执行/init --validate。如果返回✓ No conflicts found说明宪法起草成功如果报错按提示修改即可。这5分钟投入会换来后续所有操作的精准度。实测数据我跟踪了12个新手团队坚持这三步的团队首次/diff通过率从38%提升到82%。因为AI不再需要猜测“你到底想改什么”宪法里白纸黑字写着。3.4 第四步用/status确认“作战地图”执行/status逐行检查Workspace Sync是否打钩不打钩就cd到正确目录再试Active Rules是否大于0为0就检查CLAUDE.md路径和权限Model Latency的p95是否低于3秒超标就考虑换模型或检查网络。特别注意Context Window。如果显示180,000 / 200,000说明上下文快满了。这时候不要硬撑先/clear释放空间再继续。我见过太多人因为不舍得/clear导致AI在最后一步把整个package.json重写了一遍——就因为上下文太满AI把“更新依赖”听成了“重构项目”。实操技巧把/status输出复制到剪贴板粘贴到团队IM群里。这不是汇报而是建立“当前状态共识”。当多人协作时这个动作能避免70%的“我以为你看到了”类沟通事故。3.5 第五步用/diff完成“人机联合验收”现在正式提出你的需求。比如“在/src/pages/auth/register.tsx的表单里增加微信一键登录按钮点击后调用wx.login()并提交code到/api/auth/wechat-login”。说完后等AI返回“已完成”。立刻敲/diff但不要只看结论。重点检查三处Files Modified列表是否只包含你指定的文件多出的文件要警惕Semantic Analysis里“错误处理”是否符合你CLAUDE.md里的规范比如要求HTTP 401返回特定JSON结构Risk Notes有没有红色警告有就按提示执行/explain深入查看。如果一切OK执行git add . git commit -m feat: add wechat login。如果/diff里有任何不确定项不要犹豫/clear后用更精确的语言重述需求比如加上“按钮样式必须和现有Google登录按钮保持一致”。3.6 第六步用/clear开启“下一个战斗单元”功能上线后不要关闭终端。敲/clear然后观察Claude Code的反应——它会重新加载CLAUDE.md显示项目摘要并问“有什么可以帮您”。这时你可以无缝进入下一个任务比如“为微信登录添加失败重试机制”。这个动作的意义是把Claude Code从“单次任务工具”升维成“持续协作伙伴”。每次/clear都是在重申“我们的合作永远从清晰的目标开始不继承过去的模糊。” 我带过的最优秀的实习生就是靠这个习惯在两周内独立完成了整个用户中心模块的AI辅助开发。最后提醒这六步不是线性流程而是循环飞轮。/help随时可用/status应该每15分钟看一次/clear更是高频操作。把它们变成肌肉记忆比记住一百个命令都重要。4. 新手避坑指南那些没人告诉你的“暗礁”4.1 命令失效的三大隐形原因新手最崩溃的时刻往往是敲了命令却没反应。别急着重装先排查这三个高频暗礁1. 终端编码陷阱Claude Code内部使用UTF-8处理所有输入但某些Windows终端尤其是旧版CMD默认GBK编码。当你在CLAUDE.md里写了中文规则终端却用GBK发送Claude Code收到的就是乱码自然无法解析。解决方案在Windows上右键终端标题栏→属性→选项→将“当前代码页”改为65001 (UTF-8)Mac用户检查locale输出确保LANGen_US.UTF-8。2. Git状态污染Claude Code的/init和/diff高度依赖Git状态。如果当前分支有未提交的修改哪怕只是改了一行注释/init可能拒绝生成CLAUDE.md/diff可能无法准确识别变更范围。我的铁律执行任何Claude Code命令前先git status确保工作区干净。如果必须保留修改用git stash暂存。3. 权限迷雾.clauderc和CLAUDE.md的文件权限必须是600仅所有者可读写。Linux/Mac上chmod 600 ~/.clauderc和chmod 600 ./CLAUDE.md是必备操作。我见过最离谱的案例一个团队的CI服务器上CLAUDE.md权限是644导致Claude Code读取时因安全策略拒绝加载所有/diff都返回空——排查了三天才发现是权限问题。4.2 “伪成功”场景的识别与应对有些时候AI看似完成了任务但结果不可用。/diff能帮你识别这些“伪成功”场景/diff特征应对策略过度设计Files Modified列出12个文件但你的需求只涉及1个组件/clear后强调“只修改/src/components/LoginForm.tsx其他文件绝对不动”规则漂移Semantic Analysis里写着“已遵循CLAUDE.md第5条”但你CLAUDE.md第5条是空的执行/init --validate修复宪法文件然后/clear重来上下文幻觉Risk Notes提示“检测到未声明的依赖axios”但你CLAUDE.md明确写了“禁用所有HTTP客户端”/clear后先让AI/explain axios确认它是否真的理解禁用规则上周一个金融客户遇到“伪成功”AI把交易金额校验逻辑改对了但顺手把所有日志级别从INFO降到了DEBUG。/diff的Semantic Analysis里有一行小字“为便于调试已统一降低日志级别”。这就是典型的规则漂移——AI把“调试便利性”凌驾于项目规范之上。解决方案不是骂AI而是/clear后第一句话就说“本次所有修改必须100%遵守CLAUDE.md第3条日志规范不得有任何例外。”4.3 国内环境特供避坑清单针对国内网络环境我整理了这些独家经验中转站配置陷阱很多教程教你配中转站但没说关键一点——Claude Code的/login请求必须走HTTPS且证书必须有效。国内某些自建中转站用自签名证书会导致/login静默失败。解决方案用curl -v https://your-proxy.com检查证书链确保SSL certificate verify ok。DNS劫持干扰国内DNS有时会把Claude Code的API域名解析到错误IP。最简单的验证方式ping api.anthropic.com如果IP不在104.20.0.0/16或172.64.0.0/16网段说明被劫持。临时解法在/etc/hosts里手动绑定正确IP从dig api.anthropic.com short获取。代理环境变量冲突如果你设置了http_proxy环境变量Claude Code会默认走代理但国内代理常不稳定。解决方案启动Claude Code时用no_proxy* claude-code命令禁用代理或在.clauderc里显式配置proxy: null。实操心得在国内我建议新手把/status的Model Latency作为网络健康度晴雨表。p95稳定在2秒内说明网络通畅如果突增至5秒以上90%是DNS或代理问题不用查代码。4.4 从“会用”到“用好”的三个跃迁点当你熟练掌握这六个命令后真正的进阶才开始。这三个跃迁点是我带团队时观察到的共性突破跃迁点一从命令驱动到意图驱动新手阶段你思考“该敲什么命令”进阶后你思考“我想传递什么协作意图”。比如不再想“要不要/clear”而是想“此刻我和AI的共识是否已偏离”。这种思维转变会让你自然开始优化CLAUDE.md的表述精度。跃迁点二从单点操作到流程编排高手会把命令组合成原子化流程。比如创建一个/review别名自动执行/status /diff /help review形成标准化验收流水线。这比记住二十个命令有用得多。跃迁点三从工具使用者到规则制定者最顶尖的用户会反向用Claude Code完善CLAUDE.md。比如执行/init --analyze让AI扫描项目代码自动生成缺失的规则条款。这时你已不是在用工具而是在和AI共建协作基础设施。5. 最后分享一个真实教训上个月我帮一个医疗AI创业公司做技术审计。他们抱怨Claude Code“生成的代码总是漏掉HIPAA合规检查”我看了他们的CLAUDE.md发现里面只有一行“遵守HIPAA法规”。这根本不是规则这是愿望。我让他们执行/init --template healthcare生成了一份包含27条具体约束的宪法比如“所有患者ID必须经过AES-256-GCM加密密钥不得硬编码”“日志中禁止出现PHI字段包括姓名、生日、病历号”“API响应必须包含X-HIPAA-Compliance: certified头”然后我让他们用新宪法跑一遍/diff。结果AI不仅补全了加密逻辑还在/tests/integration/里自动生成了PHI泄露检测用例。这件事让我深刻意识到Claude Code不是魔法棒它是你项目规则的放大器。你投入多少清晰度它就返还多少精准度。那六个命令只是帮你把模糊的“想法”锻造成锋利的“规则”的锤子。锤子本身不重要重要的是你挥锤时心里装着怎样的蓝图。所以别急着背命令。先花十分钟把你手头那个最头疼的功能点用三句话写进CLAUDE.md。然后敲/help让Claude Code告诉你下一步该做什么。