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

Claude Code是Anthropic推出的AI编程助手，彻底驻扎在你的终端中。与基于IDE图形界面的外挂插件不同，Claude Code以命令行自主Agent形式运行，能读取整个代码库、执行精准的多文件编辑、运行测试脚本、执行终端命令和管理Git工作流——全部通过自然语言完成。它基于Claude 3.5/4.5 Sonnet的深度推理能力构建，在理解复杂架构、多模块重构和自主查错方面尤为卓越。

在2026年9月发布的v2.1.267版本中，Anthropic引入了关键工程控制参数maxEffortLevel（算力上限限制），并正式公布了调整后的每周基准使用额度体系。

本指南让你在大约10分钟内从零到高效使用。你将学到：如何安装最新版Claude Code、掌握核心命令、配置项目工程记忆规范、控制Token与推理算力预算，以及围绕它建立敏捷的日常开发工作流。

---

准备工作

• 已安装Node.js 18+
• 一个现代终端模拟器（iTerm2、Warp、Kitty或VS Code内置终端）
• Claude Pro/Team/Enterprise订阅或Anthropic API密钥

---

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

通过npm全局安装：

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

验证安装（确保版本为v2.1.267或更新）：

claude --version

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

cd your-project
claude

首次启动时，Claude Code会引导你进行网页端授权。你可以使用Claude账号（Pro、Team或Enterprise版）或API密钥。对个人开发者而言，Claude Pro或Team订阅提供固定的月费与内置用量保护，性价比更为可控。

---

第二步：理解界面（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)"
    ]
  }
}

成本与算力治理（v2.1.267重磅更新）：

从v2.1.267开始，Anthropic为终端Agent增加了细粒度算力控制，防止自主探索大项目时代价过高：

• 配置 maxEffortLevel 算力限制：在项目配置或命令行参数中设定推理深度（如 --effort low|medium|high）。对于常规代码重构或静态错误修复，将其设为 low 或 medium，能有效切断过度发散的深层反思循环，大幅降低Token消耗。
• 2026年9月14日额度调整换算：官方宣布自9月14日起，为Pro和Team用户永久上调25%的每周基准使用额度。但需注意：由于夏季50%的促销Boost期同步结束，重度开发者相比夏季临时峰值，实际可用额度净降约17%。因此，结合 maxEffortLevel 进行算力节流变得尤为必要。
• 高频使用 /cost 与 /compact：在长会话中随时输入 /cost 查看Token消耗与实际花费；每隔15-20轮交互执行一次 /compact，压缩过往终端日志以节省Prompt上下文费用。
• 聚焦单点指令，避免空泛扫描：“重构 TaskCard.tsx 提取 TaskHeader 子组件” 比 “扫描全工程所有文件寻找潜在改进点” 能节省70%以上的Token支出。

---

日常使用的专业技巧

开始会话时提供上下文。 启动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发挥最大价值的地方。