Claude Code 完整手册:从第一次启动到稳定输出的每一步

Claude Code 完整手册:从第一次启动到稳定输出的每一步 用了 Claude Code 大半年从最初的这玩意能行到现在每天离不开它踩了不少坑也攒了不少经验。它不是终端版 ChatGPT——它能直接进入项目目录、理解文件结构、逐文件修改并执行命令。想快速对比 Claude Code 和其他 AI 编程工具的效果差异可以在库拉 leadhi.cn 这类 AI 模型聚合平台上切换体验。这篇文章把从安装到稳定使用的每个环节都捋清楚。它跟其他工具的本质区别Copilot 是你写函数名它补函数体本质是补全。ChatGPT 是你贴代码片段它给建议你手动复制回去。Claude Code 是你说重构这个模块它自己读源码、拆任务、逐文件改、跑测试。一个能动嘴一个能动手。它能独立完成从创建目录到运行测试的整个开发链路。但关键是你得把它当成进入工程链路的工具而不是会写代码的聊天框。安装2026 年推荐原生安装器不需要 Node.js装完自动后台更新。macOS/Linux 和 Windows 各有对应的安装命令官方文档里直接复制就行。原生失败走 npm——先装 Node.js 18再全局安装。npm 上有仿冒包正确命令是claude不是claude-code。这点一定要注意装错了轻则命令找不到重则泄露密钥。三个配置文件缺一不可少一个都可能启动报错文件路径作用settings.json~/.claude/API 地址和密钥.claude.json~/跳过官方登录CLAUDE.md项目根目录项目说明书启动时自动读入国内用户推荐 API Key 方式接入。配置出问题先跑claude doctor排查。CLAUDE.md90% 的人没用对这是决定 Claude Code 表现上限的核心文件。它不是 README——README 可选阅读CLAUDE.md 是强制注入。没有它Claude 每次从零理解项目。用/init生成初始版本但只是起点。四个原则150-200 行封顶。写到 2000 行会变慢变飘信息太多重点被稀释。只写代码里推断不出来的信息。如果不知道这条规则就可能写错代码才值得写进去。比如本项目使用 PostgreSQL 14不支持某些 JSONB 语法——这种信息不写进去它可能给你生成不兼容的 SQL。命令式语言。代码应该整洁是废话函数不超过 50 行超过必须拆分才是指令。犯过的错沉淀成规则。改接口忘补测试、动了 migration 文件都该变成下一次不会再犯的规则。核心命令速查命令作用时机/init生成 CLAUDE.md项目首次使用/clear清空对话任务切换/compact压缩上下文每完成一个阶段后/model切换模型Sonnet 日常Opus 复杂任务/plan先出计划多文件修改前/btw旁路提问问不相关问题/cost查消耗大任务前后各查一次/doctor排查配置启动异常时进阶三件套MCP连接外部工具——查 GitHub Issues、操作数据库、发通知。Claude 可以直接读取 Issue 描述修复后自动关联。Hooks在工具调用前后插入脚本。改完代码自动跑格式化rm -rf、drop table这类危险命令自动拦截。在项目配置文件里写好 matcher 和 command 即可生效。Skills把代码审查、部署流程打包成一键调用的模板。团队统一配置后新人也能按标准流程执行。这三件套是把 Claude Code 从偶尔能用变成日常好用的分水岭。工作流最佳实践基于大量项目使用经验开新任务前/clear清空上下文避免残留信息干扰。复杂任务先/plan出方案确认后再执行。别直接让它开干尤其是多文件重构。每完成一个阶段/compact压缩上下文。上下文越长模型越容易走神。改完必须验证。让它自己跑测试不要相信看起来对的代码。大任务前后查 /cost。避免账单失控。趋势判断Claude Code 的竞争维度已经从能不能写对代码变成了能不能控制住成本和能不能融入团队工作流。CLAUDE.md 可以像 .editorconfig 一样纳入版本管理。团队成员共享同一份项目说明书Claude 的行为就是一致的。Hooks 把代码规范自动化——不靠 Code Review 时的嘴上提醒靠工具链强制执行。同样都是 Claude Code有人偶尔惊艳一下有人已经把它变成日常开发流的一部分。差别藏在这些细节里。