Claude Code 终端版：读懂一个陌生项目

1. 进入项目目录，再启动 claude

Windows 可按官方文档运行 winget install Anthropic.ClaudeCode，安装后重开终端；其他系统使用各自安装页。首次启动 claude 时按提示完成认证。在终端进入练习项目文件夹，用 pwd（PowerShell 也可用 Get-Location）确认位置，再运行 claude。

本篇限定终端版。Claude Desktop 的聊天窗口不是这个终端；桌面内的 Code 入口也有自己的选择项目流程。启动后先让它阅读 CLAUDE.md、README 和构建配置。

pwd
claude

2. 先确认项目状态

阅读 README、项目说明和包管理配置，检查版本控制状态。不要为了方便开始任务就清理已有未提交修改。

让工具先列出项目入口、运行命令和主要模块，而不是立刻重构代码。

3. 要求带文件依据的解释

一份有用的项目介绍应当指出文件位置和调用关系。让 AI 说明它看到了什么，哪些判断尚未验证。

请先阅读这个项目，不修改文件。
找到运行入口、主要模块、现有测试和项目约定。
用文件路径说明一次核心请求经过哪些部分。
区分代码中已经确认的信息和仍需运行验证的判断。
最后建议一个适合熟悉项目的小任务。

4. 选择最小变更并验证

选择一个可以复现和验收的小问题，例如错误提示不清楚。先明确触发条件、预期结果和修改范围。

完成后检查差异，运行与改动直接相关的测试。命令没有执行或执行失败时，不应把结果记录为通过。

练习与核对

• 找到运行入口和一条核心调用链
• 记录现有改动与测试命令
• 完成一个小修改并检查差异与测试结果

按实际操作自查，完成标记与成果草稿请在互动版保存。

带走这一点

先建立项目地图，才能让后续修改保持在正确范围内。

资料与核对记录

已确认 Windows winget 安装、终端启动和登录；桌面 Code 是另一个入口。

本次核对公开官方资料，未登录产品账号、运行练习或发起付费调用。

• Claude Code 官方概览

  已核对资料 · 获取：2026年9月14日 · 来源更新：未披露

  终端安装、认证及项目目录