Claude Code

Claude Code 上手:在终端里读懂并修改一个小项目

从安装检查、进入项目到一处可验证修改,走完第一次终端协作。

准备环境

你需要一个终端、自己有权使用的代码仓库,以及官方支持的账户或接入方式。安装选项和系统要求会变化,请从官方 Quickstart 选择与你的系统匹配的方法。本教程不要求执行未经检查的第三方安装脚本。

如果 macOS 已安装 Homebrew,可以参考官方文档中的 Homebrew 方式。执行前先确认包来源及当前安装说明。

sh
brew install --cask claude-code
claude --version

进入正确的工作目录

先进入准备好的练习仓库,确认位置和版本状态,再启动 Claude Code。把下面的路径替换为真实目录。

sh
cd /path/to/your-project
pwd
git status --short
claude

首次使用按界面完成登录。若版本命令或登录失败,先记录错误并核对官方文档,不要混用多个来源的安装命令。

先读,再改

先发一个只读任务:“请阅读 README,说明项目如何运行、主要目录做什么,以及修改首页应从哪里开始。暂时不要修改文件。”确认它找对项目后,再给出小任务,例如修改一个帮助提示并保持现有布局。

理解权限提示

当工具请求执行命令时,检查命令作用、目录和数据去向。读取文件与安装依赖、删除文件、推送远端的影响不同。对本次任务不需要的操作,应要求说明原因或采用范围更小的方式。

验收修改

离开交互或另开终端,用 git diff 检查差异。按 README 启动,实际触发所修改的状态。不要把命令执行成功等同于界面符合预期,也不要把页面能打开等同于业务流程完成。

完成标准

  • 你知道修改发生在哪个仓库。
  • 你能说明每个变化与任务的关系。
  • 修改后的行为已经观察到。

下一次可以把常用验证要求写进项目说明,让协作持续保持一致。不要把 API Key 或密码写进项目指令文件。

官方资料与参考

产品功能与命令可能调整。遇到差异时,以对应官方页面和当前环境为准。

读完了,动手试一次。

完成练习后,标记进度,方便继续学习。

需要独立的 macOS 开发环境?

了解三万主机的远程 Mac 租赁,或先看看你是否需要一台远程 Mac。

了解三万主机 ↗