Getting started
基础使用
学习 Claude Code 的日常工作流：启动会话、理解项目、先规划再编辑、运行检查并延续上下文。
Claude Code 更适合被当成运行在项目里的开发代理，而不是一个泛泛的聊天窗口。好的基本流程是：先让它理解仓库，再让它给出计划，然后做小步修改，最后用项目已有命令验证结果。
启动会话
在项目根目录打开终端，启动交互式会话：
claude也可以带着初始问题启动：
claude "解释这个项目的目录结构"如果只想做一次性命令行查询，可以使用 print 模式：
claude -p "总结最近 20 条提交记录"如果要确认当前是否已经登录，可以先运行：
claude auth status新项目的第一条提示词
第一次进入一个仓库时，不要马上要求它改代码。先让 Claude Code 建立项目上下文：
请检查这个仓库，说明应用结构、主要路由、构建命令和高风险模块。先不要编辑文件。然后再缩小范围：
找出登录流程涉及的文件，并解释数据如何从前端流向后端。这样后续让它实现功能时，会更容易落在真实文件和真实边界上。
日常工作流
| 步骤 | 应该怎么问 | 为什么重要 |
|---|---|---|
| 探索 | “找出控制这个功能的文件。” | 让任务绑定到真实项目结构。 |
| 规划 | “先给出一个小步实施计划。” | 先审查方案，再进入编辑。 |
| 编辑 | “只实现第一步，并保持 diff 小。” | 方便检查和回滚。 |
| 验证 | “运行已有检查，只修复相关失败。” | 使用项目自己的质量门槛。 |
| 总结 | “总结改动文件、测试结果和剩余风险。” | 方便复盘、评审或提交。 |
涉及认证、支付、数据库迁移、部署或跨模块改造时，建议先进入 Plan Mode：
claude --permission-mode plan在交互会话中，也可以使用 /plan，或在支持的终端里用 Shift+Tab 切换权限模式。
常用交互命令
在 Claude Code 中输入 / 可以查看当前环境可用的命令。不同平台、订阅、插件和 MCP 配置下，命令列表可能不同。
| 命令 | 用途 |
|---|---|
/model | 查看或切换当前会话使用的模型。 |
/effort | 在模型支持时调整推理强度。 |
/usage | 查看 token 使用情况和本地估算成本。 |
/permissions | 查看或调整工具权限。 |
/mcp | 检查 MCP 服务器连接状态。 |
/compact | 在长会话中压缩上下文。 |
如果某个命令没有出现，先核对官方 Commands 页面和当前 Claude Code 版本，不要把旧命令写成固定教程。
更有效的提示词写法
尽量同时说明文件、目标、约束和验证命令。
请在 src/components/UserList.tsx 中修复空状态展示，保持现有设计系统风格，不改变组件公开 API，修改后运行 npm test -- UserList。请给订阅升级路由增加服务端校验，沿用现有 auth guard 模式，不要改动支付服务封装。请只从正确性风险角度审查当前 diff。除非样式问题会造成真实用户问题，否则不要重写样式。如果任务范围较大，先让它输出文件地图：
请梳理 onboarding 相关文件，解释当前流程，并列出增加“公司名称必填”步骤的最小安全改动。常见低效问法
| 不够好的问法 | 更好的问法 |
|---|---|
| “帮我修 bug。” | “退出登录后个人资料页崩溃，请复现问题、定位文件，并先提出修复方案。” |
| “把 UI 做好看点。” | “优化 pricing 卡片在移动端的间距，同时保留当前色彩系统。” |
| “做一个登录系统。” | “先检查现有 auth 模块，提出增加 GitHub 登录的最小改动。” |
| “全部优化一下。” | “找出 dashboard 路由里最慢的数据库查询，并提出一个可衡量的优化点。” |
安全习惯
- 新手先使用默认权限模式，让编辑和命令执行保持可见。
- 认证、支付、迁移、部署和跨模块重构优先使用 Plan Mode。
- 要求 Claude Code 运行项目已有检查，而不是只给口头保证。
- 提交前自己检查 diff。
- 把长期项目规则写进 CLAUDE.md，不要每次都重复粘贴。
相关页面
官方来源
下一步：CLAUDE.md 配置 - 把可复用的项目规则沉淀下来。