自学教程

Claude Code 操作说明

Claude Code 教程

简介

本文介绍 Claude Code 通用操作方法，覆盖终端CLI、VS Code、JetBrains IDE三类使用入口，包含会话启动、任务交互、变更审批、会话管理、快捷键、基础工作流。
Claude Code 支持自然语言描述开发需求，可读取项目文件、修改代码、执行终端命令；所有高危操作会根据交互模式请求人工确认。

前置准备

  1. 已安装 Claude Code CLI 或对应IDE插件
  2. 项目目录，推荐Git仓库
  3. 完成身份认证或配置API Key
  4. 可选：项目已执行 claude init，生成 CLAUDE.md 和 .claude 配置

一、会话启动操作

终端 CLI

进入项目根目录，执行命令：

# 开启交互式会话
claude# 启动会话并附带初始需求
claude "分析项目登录模块代码"
# 一次性执行指令，执行完成直接退出（非交互式）
claude -p "解释这个函数逻辑"
# 继续当前目录上一次会话
claude -c

VS Code / JetBrains IDE

  1. 打开项目文件夹
  2. 点击侧边 Claude Code 图标，唤起对话面板
  3. 直接在输入框输入需求，发起会话

会话隔离：每个项目独立会话；新建会话会重新加载 CLAUDE.md 项目指令。

二、基础任务交互

1. 提交需求（自然语言）

直接用中文描述开发任务，示例：

修复表单提交空值的bug
新增用户列表接口，增加分页
重构工具函数，添加异常捕获

最佳实践：复杂任务先要求输出 Plan，审核方案后再执行修改。

2. 文件变更审批流程

Claude 修改代码时，会展示 Diff 变更预览：

  • ✅ 接受：确认应用本次代码修改
  • ❌ 拒绝：放弃本次改动
  • 部分接受：可只勾选需要的变更

行为由交互模式控制：Manual / Accept Edits / Plan / Auto。

3. 终端命令审批

当 Claude 需要执行 shell 命令（npm run test、git log等），会弹出请求：

  • 允许执行 / 拒绝执行；高危命令默认强制人工确认。

4. 任务中断

  • 终端：Ctrl + C / Esc，立刻停止当前任务，保留对话上下文
  • IDE面板：点击停止按钮中断任务

三、会话管理操作（斜杠命令）

在对话输入框输入 / 调出命令列表，常用命令：

/help        # 查看全部斜杠命令
/clear       # 清空当前对话历史，项目记忆保留，开启全新任务
/resume      # 恢复历史会话
/rewind      # 回退对话与代码到历史检查点
/compact     # 压缩对话上下文，节省token
/mode        # 切换交互模式，例：/mode plan
/config      # 查看/修改项目配置
/doctor      # 诊断Claude Code环境与项目配置状态
/init        # 交互式初始化项目，生成CLAUDE.md
/exit        # 退出会话（CLI）

四、快捷键

终端 CLI

  • Ctrl + C：终止当前任务
  • Shift + Tab：循环切换交互模式
  • Enter：发送消息
  • Shift + Enter：换行输入多行提示词

VS Code

  • Ctrl+Shift+X：打开扩展面板
  • Ctrl+Shift+P：命令面板，搜索 Claude Code
  • Shift + Tab：切换交互模式

JetBrains IDE

  • Ctrl + Esc（Windows/Linux） / Cmd + Esc（Mac）：唤起Claude Code
  • Ctrl+Alt+K（Windows/Linux） / Cmd+Option+K（Mac）：选中代码发送给Claude
  • Shift + Tab：切换交互模式

五、推荐标准工作流

  1. 进入项目目录，启动会话
  2. 切换为 Plan 模式，下达需求，获取 Coding Plan
  3. 人工审阅方案，调整需求
  4. 切换 Manual（推荐）模式执行代码修改
  5. 逐一审阅Diff变更，确认修改
  6. 执行测试、lint校验，验证功能
  7. 任务完成：/clear 清空对话，准备下一个需求

六、输入提示技巧

  1. 需求尽量写清楚：技术栈、约束、预期输出
  2. 可以使用 @文件名，直接引用指定文件上下文
  3. 一次只处理一个功能，避免任务过大
  4. 上下文消耗过高时，执行 /compact 压缩对话

七、查看资源与状态

  1. /cost：查看Token消耗统计
  2. /status：查看账号、模型、连接状态
  3. /doctor：一键检测环境、权限、配置问题

常见问题

  1. 修改 CLAUDE.md 不生效

已经打开的会话不会自动加载，需要 /clear 新建会话。

  1. Claude 读取到敏感文件

在 .claude/ignore 添加敏感文件，新建会话。

  1. 执行命令一直等待审批

当前为 Manual 模式，所有操作必须手动确认；可临时切换 Accept Edits。

  1. 会话内容太多，模型忘记前面需求

使用 /compact 压缩对话，或者 /clear 开启新对话。

安全提示

  • 生产仓库优先使用 Manual 模式，每处变更人工审核
  • 不要让 Claude 读取密钥、证书、数据库密码
  • Auto模式风险较高，仅本地测试项目使用
标签：

0 条笔记