Claude Code入门指南：10分钟上手Anthropic的AI编程工具

Claude Code是Anthropic推出的AI编程助手，驻扎在你的终端中。与基于IDE的工具不同，Claude Code以CLI形式运行，能读取整个代码库、编辑文件、执行命令、运行测试和管理git工作流——全部通过自然语言完成。它基于Claude的深度推理能力构建，在理解复杂代码库、多文件重构和架构决策方面尤其强大。

本指南让你在大约10分钟内从零到高效使用。你将学到：如何安装Claude Code、理解核心命令、为项目配置、管理成本，以及围绕它建立日常工作流。

---

准备工作

• 已安装Node.js 18+
• 一个你熟悉的终端
• Claude Pro/Max订阅（$20-200/月）或Anthropic API密钥

---

第一步：安装Claude Code（1分钟）

通过npm全局安装：

npm install -g @anthropic-ai/claude-code

验证安装：

claude --version

导航到你的项目目录并启动Claude Code：

cd your-project
claude

首次启动时，Claude Code会要求你进行身份认证。你可以使用Claude账号（Pro、Max或Team版）或API密钥。如果你已有Claude Pro订阅，直接使用即可——它包含Claude Code的使用权限（有用量限制）。

---

第二步：理解界面（2分钟）

Claude Code在终端中以交互式提示运行。你用自然语言描述指令，Claude回复后代表你执行操作。

核心交互模型：

1. 你用自然语言描述需求
2. Claude读取相关文件 理解上下文
3. Claude提出修改方案 并请求确认
4. Claude执行 —— 编辑文件、运行命令或两者兼有

核心内置命令（输入 / 查看全部）：

命令	功能
/help	显示所有可用命令
/init	创建CLAUDE.md项目文件
/clear	清除对话上下文
/compact	压缩对话以节省token
/cost	显示当前会话费用
/review	审查未提交的更改
/pr	创建Pull Request

---

第三步：设置CLAUDE.md（2分钟）

CLAUDE.md是Claude Code的项目记忆。它告诉Claude你的项目约定、技术栈、测试命令和编码规范。运行 /init 生成起步文件，或手动创建：

# 项目：我的任务管理器

## 技术栈
- Next.js 14，使用App Router
- TypeScript（严格模式）
- Tailwind CSS
- PostgreSQL + Prisma ORM

## 命令
- 开发：`npm run dev`
- 测试：`npm test`
- 代码检查：`npm run lint`
- 构建：`npm run build`

## 约定
- 使用具名导出，不用默认导出
- 组件放在 src/components/
- API路由放在 src/app/api/
- 测试文件放在被测文件旁边

将此文件放在项目根目录。Claude在每个会话开始时都会读取它，这样它就不需要每次都重新了解你的项目结构。

你也可以在子目录中创建 .claude/CLAUDE.md 文件，用于目录级别的特定指令。它们会与根文件叠加生效。

---

第四步：你的第一批任务（3分钟）

以下是你可以让Claude Code执行的真实示例：

阅读和解释代码：

解释这个项目的认证流程是怎么工作的。
涉及哪些文件？每个文件做什么？

添加功能：

在Prisma的Task模型中添加"priority"字段。
更新创建和编辑表单，加入优先级下拉选择（低、中、高）。
自动运行数据库迁移。

修复bug：

用户报告任务在页面刷新后消失。
问题可能出在数据库保存的逻辑中。
找到bug并修复。

编写测试：

为taskService模块编写单元测试。
覆盖：创建任务、更新状态、删除任务，
以及任务标题为空的边界情况。
写完后运行测试。

重构代码：

TaskCard组件超过200行了。
拆分为更小的子组件：TaskHeader、TaskBody、TaskActions和TaskStatusBadge。
保持所有现有功能正常。

Git操作：

审查我未提交的更改，写一条好的提交信息，
然后创建提交。再创建一个PR，
总结这个分支上的所有更改。

---

第五步：管理权限和成本（2分钟）

Claude Code在执行可能有重大影响的操作前（写文件、运行命令、发起网络请求）会请求许可。你会看到类似提示：

Claude想执行：npm install axios
允许？(y/n/always)

对你信任的命令（如测试运行器或代码检查工具）选择”always”，避免重复提示。你可以在项目的 .claude/settings.json 中配置永久权限：

{
  "permissions": {
    "allow": [
      "Bash(npm test)",
      "Bash(npm run lint)",
      "Bash(npm run build)"
    ]
  }
}

成本管理技巧：

• 经常使用 /cost 追踪会话支出
• 对话变长时运行 /compact——它会压缩上下文并降低token消耗
• 提示词要具体。“修复TaskCard中的bug”比”浏览所有代码找bug”更省token
• Claude Code每次回复后显示token用量，方便你校准提示风格
• 使用Claude Pro时，你每月有使用配额。使用API密钥时按token计费（根据任务复杂度通常每任务$0.01-0.10）

---

日常使用的专业技巧

开始会话时提供上下文。 启动Claude Code前先导航到相关目录。它会自动读取附近文件获取上下文。

主动使用 /compact。 不要等到上下文溢出。每15-20轮交互就运行 /compact，保持响应速度和低消耗。

按逻辑顺序串联任务。 Claude Code在一次给一个明确目标时效果最好。“修复登录bug，然后给任务列表加分页”最好分成两条独立提示。

让Claude自己验证工作。 修改完成后，让Claude运行测试或代码检查：“现在运行测试套件，修复任何失败。“这形成了自然的红-绿-重构循环。

显式引用文件。 需要Claude关注特定文件时，直接提及：“在 src/components/TaskCard.tsx 中，移动端的hover状态不工作。”

脚本中使用 --print 模式。 运行 claude --print "explain this codebase" 获取非交互式输出，可以管道给其他工具。

---

常见错误

跳过CLAUDE.md。 没有它，Claude每个会话都要重新学习你的项目约定。花5分钟设置能节省数小时的重复指令。

提示太模糊。 “让它更好”会得到不可预测的结果。“改进API路由的错误处理——添加正确的HTTP状态码和用户友好的错误消息”给了Claude明确的目标。

不用 /compact。 长对话消耗更多token并拖慢响应。尽早且频繁地压缩。

不看就批准。 Claude会准确展示它计划的修改。批准前阅读差异。你能发现问题，也能更快了解代码库。

期望一次就完美。 Claude Code在迭代循环中效果最好。描述、审查、优化。把它当作和一位速度极快、记忆力完美的初级开发者的对话。

---

总结

Claude Code是一个基于终端的AI编程助手，能读取代码库、编辑文件、执行命令和管理git——全部通过自然语言。入门工作流是：npm安装、创建CLAUDE.md项目文件、开始描述任务、迭代优化。用 /compact 和具体的提示词管理成本，用权限系统管理信任度。

这个工具在你把它当作思考伙伴而非单纯代码生成器时最为强大。让它解释架构决策、审查代码中的bug、执行前规划重构、用测试验证自己的工作。这个循环——描述、执行、验证、优化——是Claude Code发挥最大价值的地方。