Claude-Code-常用教程

Claude Code 常用教程1. 简介Claude Code 是 Anthropic 推出的命令行 AI 编程助手深度集成在终端中能帮你理解代码、修复 bug、重构项目、生成文档等。2. 安装与环境2.1 安装# npm 全局安装推荐npminstall-ganthropic-ai/claude-code# 或使用 npx 直接运行npx anthropic-ai/claude-code2.2 认证# 首次运行需要认证支持 API Key 或 OAuthclaude login2.3 查看帮助claude--help# 通用帮助claude-c# --continue继续上次对话claude-p你的问题# --print非交互模式直接输出答案claude-rsession# --resume恢复指定会话3. 基本使用3.1 启动交互模式# 在项目目录下直接启动cd/path/to/your/project claude3.2 常用交互命令命令说明Enter发送消息CtrlC中断生成CtrlD退出CtrlO打开/关闭文件预览CtrlV粘贴图片到对话3.3 一次性问答非交互模式# 快速提问claude-p解释这个项目的目录结构# 管道传入内容caterror.log|claude-p分析这个错误日志# 配合 gitgitdiff|claude-p审查这些代码变更4. 斜杠命令Slash Commands在交互模式中输入/可以使用的命令4.1 对话管理命令说明/clear清空对话历史/compact压缩上下文腾出空间/copy复制最后一次回复/restore恢复被压缩的内容4.2 配置与状态命令说明/config打开配置面板/status当前会话状态/context查看上下文使用情况/cost查看 API 费用统计/todos查看待办任务列表4.3 模型与模式命令说明/model切换模型Opus/Sonnet/Haiku/fast切换快速模式Opus 加速输出/permissions配置工具权限/allowed-tools管理允许的工具4.4 版本控制命令说明/init初始化项目记忆文件 CLAUDE.md/doctor诊断安装问题/upgrade升级到最新版本/bug提交 bug 报告4.5 工作流程命令说明/plan进入计划模式先规划再执行/review审查 Pull Request/loop按间隔重复执行命令/memory管理持久化记忆5. 项目配置CLAUDE.md在项目根目录创建CLAUDE.md或.claude/CLAUDE.mdClaude 会自动读取并遵循其中的规则。5.1 示例 CLAUDE.md# 项目规则 ## 技术栈 - 前端React 18 TypeScript Zustand - 后端Go 1.21 Gin - 数据库PostgreSQL - 测试Jest Playwright ## 规范 - 使用函数式组件和 Hooks不使用 class 组件 - 禁止 any 类型 - 提交前确保 npm run check 通过 - 新功能必须写测试 ## 常用命令 - 安装依赖pnpm install - 启动开发pnpm dev - 运行测试pnpm test - 类型检查pnpm tsc5.2 设置文件位置~/.claude/ ├── settings.json # 全局设置 │ 项目/ ├── .claude/ │ ├── settings.local.json # 本地设置 │ └── CLAUDE.md # 项目规则 └── CLAUDE.md # 项目规则另一种位置6. 工具权限系统Claude Code 有严格的权限控制分为以下级别级别说明Allowlist始终允许无需确认Ask每次操作需要确认默认Denylist始终拒绝Workspace-only仅允许在当前工作区执行6.1 配置示例# 在交互模式中用 /permissions 配置# 或直接编辑 settings.json{permissions:{allow:[Bash(npm:*),Bash(git:status),Bash(git:diff*)],deny:[Bash(rm:*),Bash(gh:pr:merge)]}}7. 常用工作流7.1 理解和探索代码# 解释项目结构claude-p解释这个项目的架构和目录结构# 理解某个文件claude-p解释 src/auth/login.ts 的实现逻辑# 追踪数据流claude-p追踪用户从登录到获取数据的完整流程7.2 编写和修改代码# 在交互模式中启动 claude 后 在 src/components 下创建一个 Loading 组件支持 spinner 和 skeleton 两种模式 重构这个函数把 200 行的 handleSubmit 拆分成更小的函数 把这段 class 组件改成函数式组件 hooks7.3 调试和修复# 分析错误caterror.log|claude-p分析这个错误并给出修复方案# 查看 git diff 找 buggitdiffmain|claude-p检查这些改动可能引入的 bug7.4 代码审查# 审查暂存的改动gitdiff--cached|claude-p审查这些改动找出潜在问题# 审查 PRclaude-c# 继续已有对话/review# 使用 review 命令7.5 编写测试为 src/utils/format.ts 中的所有函数写单元测试 给这个 API 接口写集成测试覆盖正常和异常情况7.6 文档生成给这个模块生成 API 文档 为这个组件写 Storybook story8. 实用技巧8.1 使用 引用文件# 在对话中引用文件或目录分析 src/components 的组件结构对比 old.ts 和 new.ts 的差异解释 error.log 中的错误8.2 分屏模式VSCode 扩展安装 VS Code 或 JetBrains 扩展后可以在 IDE 中直接使用 Claude Code享受分屏体验。8.3 会话恢复# 列出历史会话claude--resume# 恢复最近会话claude-c# 恢复指定会话claude-rsession-name8.4 管道组合# 日志分析tail-n100app.log|claude-p找出所有 ERROR 并分类统计# 代码统计findsrc-name*.ts|xargswc-l|claude-p分析代码量分布是否合理# Git 历史分析gitlog--oneline-20|claude-p总结最近的工作内容8.5 后台执行在交互模式中可以让耗时操作在后台运行在后台运行测试套件 # Claude 会自动使用后台任务8.6 自定义 Hook在settings.json中配置 hook实现自动化行为{hooks:{PostToolUse:[{matcher:Edit|Write,hooks:[{type:command,command:npx prettier --write $CLAUDE_TOOL_INPUT_FILE_PATH}]}]}}9. 常用提问模式9.1 代码理解场景提问方式理解代码“解释这段代码做了什么”找实现位置“处理用户登录的代码在哪里”理解调用链“从 controller 到 database这个请求经过了哪些层”9.2 代码生成场景提问方式创建组件“创建一个 Dialog 弹窗组件”添加功能“给 UserService 添加修改密码的方法”重构“把 useEffect 里的逻辑提取成自定义 hook”9.3 代码审查场景提问方式安全性“检查这段代码有没有安全漏洞”性能“这个 render 函数有什么性能问题”最佳实践“这个写法符合 React 最佳实践吗”10. 注意事项上下文长度Claude 有上下文限制长对话会自动压缩重要信息早点说成本意识使用/cost查看费用Opus 模型成本最高权限审查首次使用时检查/permissions根据项目需要调整安全第一Claude 执行的命令都可以看到敏感操作会请求确认项目记忆用 CLAUDE.md 记录项目规范让 Claude 始终遵循你的约定11. 快速参考卡片# 最常用的 5 个命令claude# 启动交互模式claude-p问题# 一次性问答claude-c# 继续上次对话/model# 切换模型/clear# 清空对话官方文档https://docs.anthropic.com/en/docs/claude-codeGitHub Issueshttps://github.com/anthropics/claude-code/issues