Claude Code 入门与基础操作

在 AI 编程工具快速演进的今天，大多数人的第一印象是 Cursor、GitHub Copilot 这类嵌入在 IDE 里的工具。但 2025 年 3 月，Anthropic 发布了另一种思路的产品——Claude Code。它不在编辑器里工作，而是直接出现在终端命令行中，用自然语言和 AI 对话就能完成代码阅读、编写、调试、提交的全流程。

这种「终端 Agent」范式代表了一个重要方向：开发者不再需要盯着编辑器逐行修改代码，而是把任务交给 AI 代理，让它自主探索项目结构、读写文件、执行命令，开发者只负责审查和确认。对于初学者来说，这反而降低了门槛——你甚至不需要熟悉一个复杂 IDE 的界面，只需要打开终端，输入你想做的事情。

本文面向零基础读者，从安装到核心概念，从常用命令到实操案例，帮助你建立对 Claude Code 的完整认知。

什么是 Claude Code

Claude Code 是 Anthropic 推出的 agentic coding 工具。Agentic 的意思是「代理式」——它不只是回答问题或补全代码，而是作为一个自主代理，能够理解你的项目上下文、规划执行步骤、调用各种工具完成任务。

与 IDE 类工具相比，核心差异在于工作模式：

  • Cursor / VS Code + Copilot：你在编辑器里写代码，AI 在旁边辅助——补全代码片段、回答侧边栏提问、在编辑器内做小幅修改。AI 是「副驾驶」。
  • Claude Code：你在终端里用自然语言描述任务，AI 自主去读文件、改代码、跑命令、执行测试。你审查结果，决定接受或拒绝。AI 是「执行者」。

这不是说哪个更好，而是工作流哲学的不同。Claude Code 更适合需要大范围重构、跨文件修改、自动化流水线的任务；Cursor 更适合逐行编辑、实时补全、前端样式微调这类精细操作。两者也可以配合使用。

安装与配置

系统要求

  • 操作系统：macOS、Linux、Windows（原生或通过 WSL）
  • Node.js：18 及以上版本（如果选择 npm 安装方式）
  • 账户：Claude Pro（$20/月）、Max（$100 或 $200/月）、Team、Enterprise 订阅之一，或者 Anthropic Console 的 API 预付额度

安装方式

方式一：原生安装（推荐）

原生安装会自动后台更新，保持最新版本。

macOS / Linux / WSL：

curl -fsSL https://claude.ai/install.sh | bash

Windows PowerShell：

irm https://claude.ai/install.ps1 | iex

Windows CMD：

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

方式二：Homebrew

brew install --cask claude-code

注意 Homebrew 安装不会自动更新，需要手动 brew upgrade claude-code。

方式三：npm 安装

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

登录账户

安装完成后，在终端运行：

claude

首次启动会自动引导你通过浏览器完成登录认证。登录后凭证保存在本地，后续无需重复登录。

如果之后需要切换账户，在 Claude Code 会话中输入 /login 即可。

验证安装

claude --version

能看到版本号说明安装成功。

核心概念

Agent 模式：AI 作为自主代理

Claude Code 的核心理念是 Agent 模式。当你输入一个任务描述后，Claude 不会只返回一段建议文本，而是会进入一个「代理循环」：

  1. 理解意图：分析你的自然语言请求
  2. 探索上下文：自动读取项目中的相关文件
  3. 规划步骤：决定需要修改哪些文件、执行哪些命令
  4. 执行操作：读写文件、运行终端命令
  5. 请求确认：每个文件修改都需要你批准（或你可以开启「全部接受」模式）

这意味着你可以说「给用户注册表单添加邮箱验证」，Claude 会自己找到表单代码、理解当前的验证逻辑、添加新的验证规则、甚至运行测试确认没有引入 bug。

上下文窗口：项目理解能力

上下文窗口是 AI 一次能「看到」的信息量。Claude Code 默认支持 200K token 的上下文窗口，beta 版本可扩展到 1M token。作为参考，一本中等规模的小说大约是 10 万 token。

实际意义是：Claude Code 可以在一次对话中理解你项目的大量代码。但上下文窗口不是无限的，随着对话推进，早期的内容会被压缩或遗忘。管理上下文的实践建议：

  • 不同任务之间用 /clear 清除对话历史，避免无关上下文干扰
  • 长对话中主动使用 /compact 压缩历史
  • 连续多次尝试失败后，重新开始对话比继续在同一个对话里挣扎更有效

工具调用：读文件、写文件、运行命令

Claude Code 内置了多种工具能力：

工具说明示例
读取文件查看任意文件内容Claude 自动读取它需要理解的代码
写入/编辑文件创建新文件或修改已有文件每次修改都会显示 diff 并请求确认
执行命令在终端运行任意 shell 命令运行测试、安装依赖、构建项目
搜索代码在整个项目中搜索关键词或模式查找某个函数被引用的位置
Git 操作提交、分支、查看 diff用自然语言完成 Git 工作流

你也可以在对话中直接引用文件和执行命令：

  • 用 @文件名 引用特定文件作为上下文
  • 用 !命令 直接执行 shell 命令，比如 !pnpm test

CLAUDE.md：项目记忆

CLAUDE.md 是 Claude Code 特有的项目配置文件，放在项目根目录。它的作用是让 Claude 在每次启动时自动了解你的项目约定，不需要你反复说明。

典型内容包括：

  • 项目使用的技术栈和框架
  • 代码风格约定（比如用单引号还是双引号、缩进规则）
  • 常用命令（构建、测试、部署）
  • 目录结构说明
  • 特殊约束或注意事项

生成初始 CLAUDE.md：

/setup

Claude 会分析你的项目并生成一份初始配置。建议随后精简它——只保留 Claude 无法自己推断出来的规则。过于冗长的 CLAUDE.md 反而会导致关键指令被忽略。

CLAUDE.md 支持三个层级：

  • 项目级：项目根目录/CLAUDE.md，随代码仓库提交，团队共享
  • 本地级：项目根目录/CLAUDE.local.md，个人偏好，不提交到仓库
  • 全局级：~/.claude/CLAUDE.md，所有项目通用的默认规则

常用命令

Shell 命令（在终端中运行）

命令功能使用场景
claude启动交互式会话日常开发，进入对话模式
claude "任务描述"运行一次性任务快速执行一个明确任务
claude -p "问题"查询后直接退出脚本中调用，或快速提问
claude -c继续当前目录最近的对话中断后回到之前的工作
claude -r选择并恢复历史对话找回之前的某个会话

会话命令（在 Claude Code 内部运行）

命令功能
/help查看所有可用命令和 skills
/clear清除当前对话历史
/compact压缩对话历史，释放上下文空间
/login切换或重新认证账户
/model切换使用的 AI 模型
/setup生成初始 CLAUDE.md 文件
/resume恢复之前的对话
/exit 或 Ctrl+D退出 Claude Code

快捷操作

  • 输入 / 查看所有命令和 skills 列表
  • Tab 键进行命令补全
  • ↑ 方向键查看命令历史
  • Shift+Tab 切换权限模式
  • Escape 中断当前操作

实操案例

案例一：用 Claude Code 修复一个 Bug

假设你的项目有一个 bug：用户在登录页面输入错误的密码后，页面显示空白而不是错误提示。

第一步：启动 Claude Code 并描述问题

cd /path/to/your/project
claude

进入对话后输入：

登录页面有一个 bug：用户输入错误的密码后，页面显示空白而不是错误提示。请找到问题并修复。

第二步：Claude 自动探索

Claude 会开始工作：

  1. 搜索登录相关的代码文件
  2. 读取认证逻辑和错误处理代码
  3. 定位到问题所在——可能是错误回调没有正确设置状态
  4. 展示它找到的问题和修复方案
  5. 请求你的确认

第三步：审查并确认修改

Claude 会展示具体的代码 diff。你审查后，选择接受修改。

第四步：验证修复

运行测试确认修复没有引入新问题

Claude 会执行测试命令并报告结果。

第五步：提交

用描述性的 commit message 提交这个修复

整个过程从描述问题到提交修复，通常只需要几分钟。

案例二：为新功能编写完整实现

假设你需要给用户 API 添加分页功能。

请为 /api/users 接口添加分页功能：
1. 支持 page 和 pageSize 查询参数
2. 默认 page=1, pageSize=20
3. 返回总数和分页信息
4. 添加对应的单元测试

Claude 会按照步骤依次完成：

  1. 找到现有的 users 路由和控制器代码
  2. 理解当前的数据查询方式
  3. 修改查询逻辑，添加分页参数处理
  4. 更新响应格式，包含总数和分页元信息
  5. 为新的分页逻辑编写测试用例
  6. 运行测试确保一切正常

你需要做的是审查每一步的修改，确保符合你的预期。如果有不满意的地方，直接告诉 Claude 调整：

pageSize 的默认值改成 10，并且在 pageSize 超过 50 时返回错误

对比表格

Claude Code vs Cursor vs GitHub Copilot

维度Claude CodeCursorGitHub Copilot
工作界面终端 CLI + VS Code 扩展 + 桌面应用VS Code 深度定制版VS Code / JetBrains 插件
交互模式Agent 优先，AI 自主执行IDE 优先，用户引导 AI代码补全 + Chat 辅助
模型选择仅 Anthropic Claude 系列多供应商（OpenAI、Google、xAI 等）OpenAI / Anthropic / Google
上下文窗口200K token（beta 1M）官方标称 200K，实际约 70K-120K受限于模型和插件
实时代码补全不支持（终端工具的本质决定）核心功能，有专用补全模型核心功能
自主执行能力极强——读文件、改代码、跑命令、执行测试有 Agent 模式，但需要更多手动引导有限，主要依赖 IDE
适合的任务大范围重构、跨文件修改、自动化流水线精细编辑、前端样式、实时补全行级补全、简单问答
入门难度需要了解基本终端操作需要安装定制版 VS Code需要安装 IDE 插件

Claude Code 各模式对比

模式说明适用场景
默认模式可以读写文件、执行命令，每次修改需确认日常开发，需要审查每个变更
全部接受模式自动批准所有文件修改信任度高的重复性任务
Plan 模式只分析和规划，不执行修改复杂任务的方案设计阶段
只读模式只读取代码，不做任何修改代码审查、项目理解

定价方案对比

方案价格使用额度适合人群
Pro$20/月基础额度，每 5 小时重置，有每周上限轻度使用者、初学者
Max 5x$100/月5 倍基础额度日常开发者
Max 20x$200/月20 倍基础额度重度使用者、全职开发者
Team$25-125/用户/月团队管理 + 共享额度开发团队
API 按量计费按 token 消耗计费无上限，用多少付多少企业、自动化流水线

适合与不适合的任务类型

任务类型适合 Claude Code？原因
跨多个文件的大规模重构非常适合Agent 模式可以自动追踪引用关系并批量修改
新功能完整实现适合从路由到数据库到测试，一次性完成
自动化测试编写适合可以读取源码后生成测试用例并执行
Git 工作流操作适合自然语言完成提交、分支、合并等操作
CI/CD 流水线配置适合可以直接编写和调试配置文件
前端样式微调不太适合需要实时预览，Cursor 或 IDE 工具更直观
逐行代码补全不适合终端工具无法提供编辑器内的实时补全体验
可视化 UI 调试不适合没有浏览器预览能力
快速代码片段编写看情况简单任务用 Claude Code 有点「杀鸡用牛刀」

用 Claude Code 完成开发任务的流程

流程图画布 · 115%
Mermaid 流程图加载中...

新手上路检查清单

以下清单帮助你从零开始顺利使用 Claude Code：

  • 安装 Node.js 18+：从 nodejs.org 下载并确认 node --version 输出正确
  • 安装 Claude Code：选择原生安装、Homebrew 或 npm 任一方式
  • 准备有效账户：至少订阅 Claude Pro（$20/月）或准备 Console API 额度
  • 完成首次登录：运行 claude 后按提示在浏览器中完成认证
  • 进入一个真实项目：cd 到你的项目目录，运行 claude
  • 先问再改：先用 这个项目做了什么？ 等提问来理解项目，不要急着让 Claude 修改代码
  • 生成 CLAUDE.md：运行 /setup 生成项目配置，然后精简为只保留核心规则
  • 从小任务开始：先试「给某个函数添加注释」这类简单操作，熟悉交互模式
  • 学会管理上下文：不同任务之间用 /clear 清理，长对话用 /compact 压缩
  • 掌握快捷操作：Tab 补全、↑ 历史、! 执行命令、@ 引用文件
  • 描述要具体：「修复登录页面的错误提示显示问题」比「修复 bug」有效得多
  • 分步拆解复杂任务：把大需求拆成编号步骤，让 Claude 按顺序执行
  • 始终审查 diff：不要盲目接受所有修改，理解每个变更再确认
  • 用 Git 保护进度：在开始大任务前确保代码已提交，方便回滚
  • 了解费用边界：清楚你的订阅方案的额度限制，避免意外超支

常见问题

Q：完全不会编程，能用 Claude Code 吗？

Claude Code 降低了编程的门槛，但仍然需要基本的开发环境操作能力——会用终端、了解文件路径、知道 Git 是什么。如果你是纯零基础，建议先了解终端基础操作和 Git 基本概念。

Q：没有 Mac 或 Linux，Windows 能用吗？

可以。Claude Code 支持 Windows 原生安装（通过 PowerShell 或 CMD），也支持 WSL。推荐安装 Git for Windows 以获得完整的 Bash 工具支持。

Q：Claude Code 会替换掉 Cursor 或 VS Code 吗？

短期内不会。两者的定位不同——Claude Code 擅长自主执行大范围任务，Cursor 擅长实时编辑和精细操作。很多开发者的实际工作流是两者配合使用。

Q：API 按量计费和订阅制，哪个更划算？

如果你每天编码时间不超过 4-6 小时，Pro（$20/月）通常够用。Max 方案适合全职高强度开发。API 按量计费适合需要自动化调用或在 CI/CD 中集成的场景。独立测试表明 Claude Code 在相同任务上消耗的 token 比竞品更少。

小结

Claude Code 代表了 AI 编程工具的一个重要分支——终端 Agent 模式。它把开发者从逐行写代码的工作中解放出来，转而用自然语言驱动 AI 完成编码任务。对于 AI 产品出海团队来说，掌握这类工具意味着更快的原型迭代、更低的开发成本、更高效的单人产出。

本章覆盖的内容：

  • Claude Code 的定位和与 IDE 工具的核心区别
  • 三种安装方式和账户配置
  • Agent 模式、上下文窗口、工具调用、CLAUDE.md 四大核心概念
  • Shell 命令和会话命令速查
  • 两个完整的实操案例
  • 四组对比表格
  • 开发任务流程图
  • 15 项新手上路检查清单

下一步建议：打开终端，安装 Claude Code，在一个真实项目中完成你的第一次对话。

参考资料

  1. Claude Code 官方文档 - 快速开始（中文）
  2. How to Use Claude Code (Beginner Guide) - Builder.io
  3. Claude Code vs Cursor: What to Choose in 2026 - Builder.io
  4. Claude Code vs Cursor: Complete Comparison Guide - Northflank
  5. Claude Code Learning Path: A Practical Guide - Medium
  6. Claude Code 安装与使用 - 菜鸟教程
  7. Claude Code Pricing 2026: Complete Plans & Cost Guide - Finout
  8. Claude Code Has Four Agent Modes - Medium