用 Claude Code 开始一个真实项目

它适合处理真实代码库里的具体工作：解释项目结构、定位入口、修改某个函数、补测试、排查本地报错。因为它就在项目目录里运行，通常不必先把大段代码手工粘贴进对话。

它不适合被当成“一键重构整仓、自动部署、自动跑危险命令”的黑盒。越是不可逆、影响面大的操作，越应该由你来决定是否批准。

官方推荐 Native Install。安装后用 claude --version 确认版本号；输出里通常会带 Claude Code。

curl -fsSL https://claude.ai/install.sh | bash
claude --version

irm https://claude.ai/install.ps1 | iex

也可以用 brew install --cask claude-code 或 winget install Anthropic.ClaudeCode。Homebrew / WinGet 安装不会自动更新，之后需要手动升级。

然后进入真实项目根目录再启动。不要在空目录里练习第一次；你需要一个有代码可读的仓库，才能看出它到底有没有理解项目。

cd /path/to/your/project
claude

第一次运行会走登录流程。按提示完成浏览器登录；如果已经设置了 ANTHROPIC_API_KEY，则会确认该 Key。之后也可以在会话里用 /login 切换账号。

刚进入项目时，先让 Claude 读懂仓库，再谈修改。直接甩一个大需求，很容易得到看起来热闹、实际上没有摸清边界的改动。

可以先问这些：

• what does this project do?
• where is the main entry point?
• which files should I read first to understand the request flow?

这一步的价值不只是“让它熟悉代码”。你也在检查：它能不能指出真实入口、会不会凭空编造目录结构、描述是否和你对项目的认知一致。如果这一步已经偏了，后面的修改更不该直接批准。

第一次改动尽量小、可回滚、不影响生产数据。比如给某个表单补输入校验、修一个明确的文案问题、给已有函数补一条边界判断。任务描述要具体到文件或行为，不要一开始就说“重构一下整个模块”。

在默认权限模式下，改文件前通常会征求确认。你可以先看建议，再决定是否写入。也可用 Shift+Tab 切换权限模式，但刚开始更建议保持需要确认的模式。

不要只看对话里的总结。真正要核对的是工作区变化：它改了哪些文件、删了什么、有没有顺手动到无关目录。

• 用 git status 看变更范围是否仍然很小
• 用 git diff 逐段检查具体改动
• 确认没有意外新增依赖、配置文件或脚本
• 能跑的话，再跑一次和这次改动直接相关的检查

如果 diff 已经超出你要求的范围，先停下来问清楚原因，而不是继续追加新任务。

下面这些都属于工程常识上的高风险操作。即便 Claude Code 能执行，也不代表应该自动批准：

• 大范围删除文件或目录
• 数据库 migration、生产数据清理、强制覆盖数据
• deploy、推送生产、修改线上配置
• destructive shell 命令，例如不可逆删除、重置仓库、批量改写历史
• 把密钥、token、.env 内容写进代码或提交

原则很简单：影响面大、难以回滚、或会碰到真实数据与生产环境的事，先自己判断，再决定要不要让工具继续。

• 始终在真实项目目录启动，而不是空文件夹
• 先理解，再修改；先小改，再扩大
• 每次只给一个边界清楚的任务
• 改完先看 git diff，再决定下一步
• 保持需要确认的权限模式，直到你熟悉它的行为
• 把危险操作留在对话之外，由你自己显式执行