自学教程

Claude Code 基础用法

Claude Code 教程

简介

Claude Code 是可在终端、VS Code、JetBrains IDE 中使用的 AI 编码助手，可以读取项目代码、修改文件、运行终端命令，辅助开发、调试、重构代码。
本章介绍最常用的基础操作，快速上手 Claude Code。

前置条件

  1. 安装 Claude Code CLI，或安装 VS Code / JetBrains IDE 插件
  2. 完成认证（Anthropic账号登录 或 配置API Key）
  3. 准备本地项目文件夹，建议使用 Git 管理
  4. 可选：执行 claude init 初始化项目，生成 CLAUDE.md 和 .claude 配置

一、启动会话

终端 CLI

进入项目根目录，在终端执行：

claude

进入交互式对话，直接输入自然语言需求。

一次性执行任务（执行完成自动退出）

claude -p "给这个项目添加读取配置文件的工具函数"

VS Code / JetBrains IDE

  1. 使用IDE打开项目文件夹
  2. 打开 Claude Code 侧边面板
  3. 在输入框中直接输入需求，发起对话

二、基础对话写法

直接用自然语言描述开发任务，支持中文。
常用示例：

解释 src/main.ts 的代码逻辑
找出这个项目的类型错误并修复
封装一个请求工具，统一处理接口异常
优化这个组件，减少重复代码

小技巧：使用 @文件名 快速引用文件，自动带上文件上下文
示例：@src/api/request.ts 增加超时重试逻辑

推荐工作流程（基础版）

  1. 提出需求，先让 Claude 输出 Coding Plan
  2. 审阅方案，确认是否符合项目规范
  3. 确认后，再执行代码修改
  4. 查看代码Diff，接受或拒绝改动
  5. 运行测试验证结果

三、交互模式控制（基础）

交互模式控制 Claude 修改文件、执行命令是否需要你的审批，会话内可随时切换。

模式说明
Manual（默认）文件修改、终端命令都需要手动审批，最安全
Plan仅读取分析代码，不能修改任何文件，适合方案设计
Accept Edits自动应用代码修改，终端命令仍需要审批
Auto自动判断风险，低风险操作自动执行，谨慎使用

切换方式：

  • 快捷键：Shift+Tab 循环切换
  • 斜杠命令：/mode plan、/mode manual

四、变更审批操作

当 Claude 修改代码，会展示 Diff 对比：

  • ✅ 接受：应用本次代码改动
  • ❌ 拒绝：放弃本次修改
  • 支持单独勾选部分变更，选择性接受修改

终端命令执行前，同样会弹出确认提示，可选择允许/拒绝。

五、常用基础斜杠命令

在对话输入框输入 / 调用命令：

/help      # 查看所有斜杠命令
/mode      # 切换交互模式
/doctor    # 检查项目配置、环境、API连通性
/clear     # 清空当前对话，开启新任务（新会话加载最新CLAUDE.md）
/rewind    # 回退代码与对话到历史节点
/compact   # 压缩对话上下文，减少token消耗
/exit      # 退出CLI会话

六、会话控制

  • 中断任务：Ctrl + C（终端） / IDE面板点击停止按钮
  • 新建任务：/clear 清空对话，开启新会话
  • 会话隔离：不同项目相互独立；新建会话会重新加载项目 CLAUDE.md

七、简单示例实操

需求：给工具函数增加参数校验

  1. 启动会话：claude
  2. 输入指令：
先输出Coding Plan，然后给@src/utils/helper.ts增加参数校验，参数为空时抛出异常
  1. 查看输出的 Coding Plan，确认方案
  2. 切换到 Manual 模式，确认代码变更
  3. 查看Diff，接受修改，运行代码验证

最佳实践

  1. 复杂任务优先使用 Plan 模式，先看方案再改代码
  2. 生产项目保持默认 Manual 模式，每一处改动人工审核
  3. 在 .claude/ignore 配置屏蔽密钥、证书等敏感文件
  4. 项目规范写在根目录 CLAUDE.md，统一代码风格
  5. 任务过大时拆分多个小任务，避免上下文溢出

常见问题

  1. 修改 CLAUDE.md 不生效
    当前会话不会自动加载，执行 /clear 新建会话即可。
  2. Claude 无法读取文件
    检查文件路径，确认文件没有被 .claude/ignore 忽略。
  3. 每次修改都要手动确认
    当前是 Manual 模式，可以临时切换为 Accept Edits 提升速度。

安全提示

  • 不要让 Claude 读取包含密钥、数据库密码、私钥的文件
  • Auto模式风险较高，仅本地测试项目使用
  • 执行未知终端命令前，仔细查看命令内容
标签：

0 条笔记