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

原文：https://itjc.com/tutorials/claude-code-first-change/
主题：Claude Code；级别：入门；更新时间：2026-11-15。

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

## 准备环境
你需要一个终端、自己有权使用的代码仓库，以及官方支持的账户或接入方式。安装选项和系统要求会变化，请从官方 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 或密码写进项目指令文件。

## 官方资料与参考

- [Claude Code Quickstart](https://code.claude.com/docs/en/quickstart)
- [Claude Code Overview](https://code.claude.com/docs/en/overview)
