Claude Code 的基础能力并不只是在终端里提问。真正开始工作前,你需要完成安装和配置,理解 CLAUDE.md 如何为项目提供上下文,并用 Git 控制每一次代码变更。本篇以一组入门知识点为主线,帮助你检查自己是否已经具备日常使用 Claude Code 的基础。
先把工作环境准备好
使用 Claude Code 时,建议从项目根目录启动,让工具能够围绕当前代码库理解文件结构、配置文件和 Git 状态。具体安装命令会随官方版本和运行环境变化,因此应以当前 Claude Code 文档提供的安装方式为准。
安装完成后,可以进入一个已有 Git 仓库进行检查:
cd ~/projects/my-app
claude
如果项目还不是 Git 仓库,可以先初始化并创建一个基线提交:
cd ~/projects/my-app
git init
git add .
git commit -m "chore: create baseline"
claude
这个基线很重要。Claude Code 可能会修改多个文件,有了干净的起点,你才能快速比较改动、审查结果,并在需要时恢复到已知状态。
CLAUDE.md 是项目说明书
CLAUDE.md 可以用来记录项目级约定,让 Claude Code 在后续会话中持续获得稳定上下文。它适合放置以下内容:
- 项目使用的语言、框架和运行时版本
- 安装依赖、运行测试和启动服务的命令
- 目录职责和关键模块说明
- 代码风格、命名规则和不可修改的文件
- 提交代码前必须完成的检查
可以在项目根目录创建一个最小版本:
# Project Guide
## Commands
- Install dependencies: `npm ci`
- Run tests: `npm test`
- Run lint: `npm run lint`
## Working rules
- Keep changes focused on the requested task.
- Do not edit generated files by hand.
- Add or update tests when behavior changes.
- Explain any command that could modify data or infrastructure.
这份文件不是替代测试和代码审查的自动授权书。它提供的是工作上下文,实际执行命令或接受修改前,仍需要确认影响范围。尤其要谨慎对待删除文件、修改数据库、访问生产环境和重写大量代码的操作。
用 Git 保持控制力
Claude Code 的价值在于减少编辑和探索成本,但变更的所有权仍然属于开发者。一个可靠的循环是:让工具完成小范围任务,立即查看差异,运行针对性验证,再决定是否保留。
# 查看当前状态
git status --short
# 查看未提交的具体改动
git diff -- .
# 运行项目已有检查
npm test
npm run lint
# 确认结果后再提交
git add src/ tests/
git commit -m "fix: handle empty input"
如果改动不符合预期,不要直接继续叠加新的请求。可以先记录问题,再让 Claude Code 针对具体文件和行为修正;也可以使用项目既有的 Git 流程恢复不需要的变更。执行恢复命令前,务必确认工作区中没有需要保留的人工修改。
一次合格的入门自测
你可以用下面的问题检查自己的使用方式:
- 你能说明 Claude Code 是从哪个目录启动的吗?
- 你是否在项目根目录维护了清晰的
CLAUDE.md? - 你是否知道项目的测试、格式化和构建命令?
- 你能用
git status和git diff识别工具做了哪些修改吗? - 对于删除、部署或数据迁移等高风险操作,你是否会在执行前确认?
- 代码行为改变时,你是否要求补充或更新测试?
如果这些问题都能回答清楚,说明你已经掌握了 Claude Code 入门阶段最关键的工作方式:让工具参与实现,但让项目规则、测试和 Git 共同约束结果。
采用建议
把 Claude Code 引入团队时,可以从低风险、边界清晰的任务开始,例如补测试、解释模块、修复小型缺陷或生成重复性代码。每次任务都尽量保持范围明确,并把可重复的项目知识沉淀到 CLAUDE.md。
核心检查清单很短:安装方式明确,项目上下文可读,命令可验证,Git 状态可追踪,高风险动作有人确认。做到这些,Claude Code 才会成为开发流程中的可控工具,而不是无法解释的批量修改器。