← 返回指南
产品教程11 分钟· 更新于 2026-09-01

Claude Code 使用指南:把终端变成开发主力

Claude Code 是 Anthropic 的终端 Coding Agent,也是目前工程师口碑最好的 Agent 之一。它把「读仓库、改代码、跑命令、测功能、提交」这条链路完整闭环在终端里。这篇指南给出经过验证的上手路径。

目录

安装与认证

Windows 用户推荐通过 WSL 或原生安装包使用(需 Node 18+):

安装 Claude Code

npm install -g @anthropic-ai/claude-code
cd ~/your-project
claude            # 首次运行会引导登录
claude "解释这个仓库的架构"   # 直接提问

用 CLAUDE.md 定制你的 Agent

Claude Code 会在项目根目录读取 CLAUDE.md 作为「常驻记忆」。把项目的架构约定、命令习惯、质量红线写进去,Agent 的每一轮都会遵循,这是让产出稳定的关键一步。

示例 CLAUDE.md

# 项目约定
- 前端: React + TypeScript,禁止引入全局 CSS 文件
- 测试: 修改逻辑必须补充单元测试,运行 npm test 通过
- 提交: 每完成一个原子功能提交一次,信息遵循 conventional
- 禁止: 直接修改生产环境配置

让会话规范的三个设置

① 权限控制:用 /permissions 预设可自动放行的命令与文件白名单,减少重复确认;② 自定义指令:通过 /hooks 或全局 CLAUDE.md 预设代码风格;③ 定义 DONE:PM 式提问「你如何确认完成了?」让 Agent 先自述验收标准再动手。

在写任务描述时多加一句「先搜索相关代码再回答」,能显著降低幻觉、提高改对地方的概率。

子 Agent 与并行

Claude Code 支持 spawn 多个子 Agent 并行处理独立子任务(例如同时「重构 A 模块」与「给 B 模块补测试」),主 Agent 负责汇总。对于仓库大、任务多的场景,这是吞吐量的关键杠杆。

注意成本:并行 Agent 会同步放大 token 开销,先从小任务试水,再逐步增加并行度。

工程实践清单

最后是长期使用的四条守则:① 小任务起步:一次对话只干一件事;② 全程可审查:所有改动经 git diff 审查;③ 测试兜底:让 Agent 先写测试再实现;④ 注意成本:为重型任务估算输出量,必要时切换到更经济的模型档位。

Takeaways

  • CLAUDE.md 是稳定产出的核心,务必维护
  • 用权限、hooks 与「先搜索再回答」指令提升可控性
  • 子 Agent 并行是大仓库吞吐量的杠杆,但注意成本

常见问题

Q: Claude Code 与 Cursor 该怎么选?

A: 终端党、喜欢 Git/Unix 工作流选 Claude Code;需要可视化编辑体验选 Cursor。两者也可以组合:Claude Code 做重任务,Cursor 做界面微调。

Q: Windows 上体验如何?

A: 通过 WSL 运行体验最佳;原生 Windows 有独立安装包,功能基本一致但部分终端特性受限。

本文提到的产品

更多指南