准备环境
你需要一个终端、自己有权使用的代码仓库,以及官方支持的账户或接入方式。安装选项和系统要求会变化,请从官方 Quickstart 选择与你的系统匹配的方法。本教程不要求执行未经检查的第三方安装脚本。
如果 macOS 已安装 Homebrew,可以参考官方文档中的 Homebrew 方式。执行前先确认包来源及当前安装说明。
brew install --cask claude-code
claude --version进入正确的工作目录
先进入准备好的练习仓库,确认位置和版本状态,再启动 Claude Code。把下面的路径替换为真实目录。
cd /path/to/your-project
pwd
git status --short
claude首次使用按界面完成登录。若版本命令或登录失败,先记录错误并核对官方文档,不要混用多个来源的安装命令。
先读,再改
先发一个只读任务:“请阅读 README,说明项目如何运行、主要目录做什么,以及修改首页应从哪里开始。暂时不要修改文件。”确认它找对项目后,再给出小任务,例如修改一个帮助提示并保持现有布局。
理解权限提示
当工具请求执行命令时,检查命令作用、目录和数据去向。读取文件与安装依赖、删除文件、推送远端的影响不同。对本次任务不需要的操作,应要求说明原因或采用范围更小的方式。
验收修改
离开交互或另开终端,用 git diff 检查差异。按 README 启动,实际触发所修改的状态。不要把命令执行成功等同于界面符合预期,也不要把页面能打开等同于业务流程完成。
完成标准
- 你知道修改发生在哪个仓库。
- 你能说明每个变化与任务的关系。
- 修改后的行为已经观察到。
下一次可以把常用验证要求写进项目说明,让协作持续保持一致。不要把 API Key 或密码写进项目指令文件。