Claude Code 使用教程命令行编程实战Anthropic 出的 Claude Code 是又一个把 AI 直接塞进终端、让你跟它协作改代码的工具。它跟前面聊过的 Codex 定位接近但在交互细节和工程化程度上各有各的味道。我把它当作主力编码搭档用了几个项目从修小 bug 到整模块开发都跑过这篇把核心用法和实战流程整理出来。文章按装起来 → 命令怎么用 → 完整跑一个功能 → 跟 git 怎么配合 → 团队怎么用的顺序走收尾聊限制和我的选型建议。命令都以我实际跑过的为准版本号标以官方文档为准需要截图的地方放占位符。安装与启动三分钟跑起来Claude Code 是 Node.js 包前提是机器上有 Node.js 18 以上具体版本要求以官方文档为准。# 全局安装npminstall-ganthropic-ai/claude-code# 验证版本claude--version# 预期输出类似 1.x.x 的版本号以官方文档为准# 进入项目目录后启动cd/path/to/your/project claude启动后首次使用需要认证。两个途径用 Claude 账号订阅登录或者配置 Anthropic API key。走 API key 的方式exportANTHROPIC_API_KEYsk-ant-你的keyclaude【此处需补真实截图claude 启动成功、进入交互界面的终端截图】进入交互界面后提示符直接让你输入。第一次用建议先敲/help看内置命令清单再敲/init让它扫描项目、生成一份 CLAUDE.md 项目说明——这份文件是后面团队协作的关键后面专门讲。核心命令与交互模式Claude Code 的交互核心是斜杠命令常用这些命令作用我的用法/init扫描项目生成 CLAUDE.md新项目必备第一步/help查看所有命令记不清时现查/status查看当前会话状态、用了多少上下文长会话提醒自己该收尾/compact压缩历史继续对话上下文快满时的续命手段/clear清空会话重新开始换任务时用/model切换模型简单任务换便宜模型省钱/cost查看本次会话费用心里有数交互上有个很好用的点对话里用直接引用文件或目录不用把代码贴进聊天框。比如src/utils.py 这个文件里的 validate_input 函数帮我补几个边界条件的测试它会自动去读那个文件。另外ShiftTab可以在普通对话 / 自动接受编辑 / 计划模式几种模式间切换。计划模式只输出方案不动手复杂改动我先切到计划模式看方案确认后切回自动模式让它落地节奏很舒服。实际任务实战让它完整实现一个功能拿一个真实任务走一遍。需求项目里有一堆 CSV 数据文件我要一个合并工具能按列对齐、自动跳过表头、输出合并结果。第 1 步描述需求tools/ 目录下加一个脚本 merge_csv.py做这些事 - 输入多个 CSV 路径输出合并后的 CSV - 按第一个文件的表头对齐列 - 跳过重复的表头行 - 缺失字段补空值第 2 步它读目录、写代码、给 diff。我逐个确认有意见直接说错误处理再稳一点文件不存在时退出码用 1。第 3 步让它自测造两个测试 CSV跑一遍脚本展示结果【此处需补真实截图Claude Code 实现 merge_csv.py 的对话与 diff 截图】第 4 步我手动补了第三个 CSV故意打乱列顺序来验证对齐逻辑。这一步它自己容易忽略多一个测试文件就露馅改了两行逻辑过了。第 5 步收尾让它补 README 说明和命令行--help然后 git 提交。整段下来我实际输入的内容远少于它产出的代码。但要注意每个任务结束前自己读一遍 diff。它的代码质量在线但对业务语义的理解是盲区业务上的对错只能你把关。补一个我用的验收清单每次任务结束逐条过核心逻辑符合需求吗边界条件空输入、异常输入处理了吗测试真的跑过了吗而不是只写了没跑有没有改动需求范围之外的文件有没有留下调试代码print、断点这五条过完基本可以放心收工。尤其是测试真的跑过了吗——AI 有时会自信地说测试通过而实际上没执行别问它看输出。与 git 集成自动提交与分支操作Claude Code 内置了 git 操作不用退出终端敲 git 命令。让它提交把这些改动 commitmessage 写清楚每个文件改了什么它会把改动分类、生成 commit message、执行提交。分支操作一样可以帮我新建分支 fix/retry-logic切过去把改到一半的改动一起带过去日常最省心的是/clear后让它在干净工作区干活配合git status确认状态。我的铁律让 AI 改代码前工作区必须干净或者已有 commit 保底这样它改砸了可以一键回退。审 diff 有个技巧别从头到尾线性读先git diff --stat看它改了哪些文件再挑核心逻辑的文件细看外围文件扫一眼。AI 生成的 diff 有个常见毛病——顺手改了无关的格式把真实改动淹没在噪音里。用git diff -w忽略空白差异一眼就能看出真正的逻辑变化。常用的 git 协作流整理成表场景怎么做改代码前git status确认干净或先 commit让它提交直接描述让它分类提交改砸了回退git checkout ./git reset多分支开发让它建分支、切分支代码审查让它 review 未提交 diff给问题清单团队协作CLAUDE.md 才是核心资产团队场景下Claude Code 最有价值的不是单机使用而是/init生成的 CLAUDE.md。这份文件放在项目根目录是给 AI 看的项目说明书架构约定、命名规范、测试命令、禁止事项。它每次启动都会先读这份文件相当于给 AI 装上团队上下文。我见过最好的用法是把它写进版本库团队共同维护。谁发现 AI 在某类任务上反复出错就补一条规则进 CLAUDE.md。规则越具体AI 表现越稳定。比如# CLAUDE.md 片段示例 ## 项目约定 - 新代码必须带类型注解 - 测试放 tests/ 目录用 pytest - 禁止修改 migrations/ 目录下的旧迁移文件这样每个成员用 Claude Code 干活AI 行为都是对齐的不会因为谁忘了交代上下文而跑偏。审代码、写提交信息这些也都可以固定成规则让 AI 产出风格统一。有个前提CLAUDE.md 要跟代码一起 review。规则写错了AI 会忠实地执行错误规则。我见过团队把过时的目录结构写进 CLAUDE.md新成员用 Claude Code 时反复被误导。它跟代码一样需要维护删掉的目录要同步删掉对应条目。上下文管理与长会话技巧Claude Code 的上下文不是无限的长会话到后面会出现前情提要遗忘——开头交代的约束中间还在遵守到后半段就忘了。这不是它变笨是上下文窗口被新内容挤掉了。几个应对手段用/compact主动压缩。感觉会话变钝时执行/compact它会保留关键结论、丢掉过程性对话相当于续上一段新鲜记忆。注意压缩会丢细节压缩之后别再追问你刚才分析的第 3 点它可能真不记得了。让 CLAUDE.md 当外部记忆。凡是项目级不变的事实——目录结构、命令约定、架构决策——都写进 CLAUDE.md而不是在对话里反复交代。它每次启动都会读等于把记忆存在了项目里而不是脆弱的会话里。大改动分批做。一次会话只推进一个阶段先出方案确认后改 A 文件再改 B 文件。让它一口气把十个文件全改了既容易上下文爆掉也难审。分批看起来慢实际总时长反而更短。什么时候该果断开新会话看这张表信号处理同一话题聊了 30 轮以上先让它总结现状新开会话续上任务范围变了改 bug 变成加功能直接新会话避免旧上下文误导它开始反复问已经交代过的事上下文顶不住了compact 或重开连续两次改错方向停下来重新描述需求别硬推常见问题与排查用久了总会踩几个坑把最常见的几个问题、现象和解决步骤列出来遇到直接照着排查。认证失败登录或 API key 不生效。现象是启动claude后反复要求登录或者报401/authentication failed。先确认环境变量真的传进去了echo$ANTHROPIC_API_KEY# 确认 key 前缀是 sk-ant-且没有多余空格或换行如果 key 没问题检查是不是用了代理或 VPN 导致请求被拦临时关掉再试。还不行就claude里敲/login重新走一遍认证流程或者删掉本地缓存重新登录缓存位置以官方文档为准。命令不生效敲了斜杠命令没反应。先确认当前是不是在交互界面里而不是在系统终端。斜杠命令只在 Claude Code 的提示符下有效。另外有些命令如/init必须在项目目录里跑在空目录或非项目目录下会提示找不到上下文。实在没反应就/clear重开一个会话多数情况是会话状态卡住了。上下文溢出聊到一半它开始忘事或答非所问。这是长会话最常见的坑。先/status看当前上下文占用如果接近上限执行/compact压缩历史。压缩会丢细节压缩后别追问早先的具体内容。如果任务还没做完建议把关键结论写进 CLAUDE.md然后/clear新开会话续上。它改错了文件或改了不该改的地方。别慌先git status看改动范围git diff看具体内容。如果只是误改git checkout .一键还原如果已经 commit用git reset回退。这也是前面强调改代码前工作区必须干净的原因——有 commit 保底任何误操作都能退回去。它说测试通过但实际没跑。这是 AI 的经典毛病别问它直接看输出。让它把测试命令和结果贴出来或者你自己在终端跑一遍。验收清单里测试真的跑过了吗这条永远以实际输出为准不信它的口头保证。启动报 Node.js 版本过低。Claude Code 是 Node.js 包版本不够会直接报错。先node --version确认再升级到要求的版本具体版本要求以官方文档为准。升级完重新npm install -g anthropic-ai/claude-code装一遍。费用失控长会话烧钱快。用/cost盯每轮费用设置预算提醒。简单任务用/model切到便宜模型把重活留给主力模型。重度使用前先想清楚哪些任务值得开长会话哪些直接新开更划算。限制与建议讲限制要坦诚。成本长会话上下文烧得快重度使用前先设置好预算提醒我一般用/cost盯每轮费用。补注释、写测试这类高频低难度任务可以考虑用/model切到便宜模型把重活留给主力模型账单压力小不少。上下文改大项目时它会忘记早先的对话/compact能续命但细节会丢。商业使用Anthropic 的授权条款对商用场景有要求团队落地前务必读一下官网的使用条款以官方文档为准这个不查清楚容易给自己埋雷。我的选型建议是个人项目、中小型代码库Claude Code 的体验非常能打但它解决不了需求本身就不清晰的问题——描述不清时它给的方案再漂亮也是南辕北辙。把它当成一个执行力极强的工程师而不是产品经理用起来会顺手得多。结论Claude Code 把 AI 编程从问答推到了协作它会读文件、改代码、跑命令、管 git你只负责描述意图和把关方向。CLAUDE.md 这套机制让团队上下文能被 AI 复用这是它区别于多数同类工具的核心。上手成本不高难的是建立AI 改、你审的稳定工作流——想清楚自己在这套流程里的角色工具就值了。