【实战】Claude Code 入门使用指南:从第一个命令到高效开发

0 阅读5分钟

上一期我们完成了 Claude Code 的安装和配置,这一期带你真正上手使用。从最基础的命令开始,逐步掌握这个 AI 编程助手的核心能力。


前置准备

开始之前,确保你已经:

  • 安装了 Claude Code(npm install -g @anthropic-ai/claude-code)
  • 配置好了 API Key 或自定义模型端点
  • 在终端中能正常运行 claude 命令

如果还没装好,可以回顾上期的安装教程。


第一步:启动 Claude Code

打开终端,进入你的项目目录,输入:

 cd your-project
 claude

启动后你会看到 Claude Code 的交互界面。恭喜,你已经准备好开始和 AI 搭档写代码了。


第二步:认识核心交互方式

Claude Code 提供三种交互模式:

1️⃣ 对话模式(默认)

直接在终端输入自然语言描述需求:

 > 帮我创建一个 Express 服务器,监听 3000 端口

Claude 会理解你的意图,自动编写代码、创建文件,并告诉你做了什么。

2️⃣ 编辑模式

当 Claude 建议修改某个文件时,你可以:

  • 输入 y 或回车 — 接受修改
  • 输入 n — 拒绝修改
  • 输入 e — 手动编辑后再确认

3️⃣ 直接指令

使用 / 开头的快捷命令:

命令功能
/help查看帮助
/clear清空对话历史
/compact压缩上下文(对话太长时用)
/cost查看当前会话消耗的 token
/model切换模型
/quit退出

第三步:实战练习——5个典型场景

场景1:创建新项目

 > 创建一个 React + TypeScript 的 Todo 应用,包含添加、删除、标记完成功能

Claude 会自动:

  1. 初始化项目结构
  2. 创建组件文件
  3. 编写完整代码
  4. 安装依赖

场景2:理解和修改现有代码

 > 这个 utils.js 是做什么的?帮我看一下有没有 bug

Claude 会:

  1. 读取并分析文件
  2. 解释代码逻辑
  3. 指出潜在问题
  4. 提出修复建议

场景3:调试报错

遇到报错时,直接把错误信息贴过去:

 > 运行 npm start 报了这个错:TypeError: Cannot read property 'map' of undefined

Claude 会:

  1. 定位问题所在文件和行号
  2. 分析错误原因
  3. 给出修复方案并直接修改代码

场景4:代码重构

 > 把这个 500 行的组件拆分成 3 个子组件,提取公共逻辑到 hooks 里

Claude 会:

  1. 分析当前组件结构
  2. 规划拆分方案
  3. 创建新文件
  4. 更新引用关系

场景5:写测试

 > 给 src/api/user.js 写单元测试,覆盖率要达到 80% 以上

Claude 会:

  1. 分析被测文件
  2. 安装测试框架(如需要)
  3. 编写测试用例
  4. 运行测试并确认通过

第四步:进阶技巧

💡 技巧1:善用上下文

Claude Code 会自动读取项目文件,但你也可以主动给它线索:

 > 参考 src/components/Header.tsx 的风格,创建一个 Footer 组件

💡 技巧2:分步执行复杂任务

不要一次性丢一个巨大的需求,拆成小步骤:

> 第一步:先搭建数据库 schema
> 第二步:创建 RESTful API
> 第三步:写前端页面
> 第四步:联调测试

💡 技巧3:用 /compact 管理上下文

长对话会消耗大量 token。当对话变慢时:

/compact

Claude 会压缩对话历史,保留关键信息,释放 token 空间。

💡 技巧4:让 Claude 先问再动手

对于不确定的需求,加一句:

> 帮我重构用户认证模块,动手之前先告诉我你的方案

这样可以在 Claude 动手前确认方向,避免返工。

💡 技巧5:利用 .claudeignore 排除文件

在项目根目录创建 .claudeignore,排除不需要让 Claude 看的文件:

node_modules/
dist/
*.log
.env

常见问题

Q1:Claude 改错了代码怎么办?

Claude 的每次修改都需要你确认(按 y 才会生效)。如果不小心接受了错误的修改:

  • 使用 Git 回退:git checkout -- <file>
  • 或者让 Claude 自己修复:刚才那个改动有问题,帮我回退

Q2:对话太长导致响应变慢?

使用 /compact 压缩上下文,或者 /clear 清空重新开始。

Q3:Claude 不理解我的需求?

尝试更具体的描述:

# 模糊(不好)
> 优化一下这个函数

# 具体(好)
> 这个函数处理用户数据,目前是 O(n²) 复杂度,帮我优化到 O(n),保持输出格式不变

Q4:如何限制 Claude 的操作范围?

默认情况下 Claude 可以读写项目文件。你可以通过启动参数限制权限:

claude --allowedTools "Read,Write" --disallowedPaths "src/core/"

效率对比:用 vs 不用 Claude Code

任务手动开发Claude Code 辅助
创建新项目2-4 小时10-20 分钟
写 CRUD 接口4-8 小时30-60 分钟
修复 Bug30 分钟 - 数小时5-15 分钟
写单元测试2-4 小时20-40 分钟
代码重构1-2 天1-3 小时

⚠️ Claude Code 是工具,不是替代品。核心架构设计、业务逻辑决策仍然需要你来把控。


下一步建议

  1. 今天:用 Claude Code 创建一个Hello World项目,熟悉交互
  2. 本周:在真实项目中用 Claude Code 完成一个小功能
  3. 持续:积累提示词经验,找到最适合你的使用方式

👨‍💻 H先生出品 | 专注 AI 工具与效率提升 关注公众号,回复「Claude」获取完整系列教程