ClaudeCode 项目实战操作指南

---

📑 目录

• 一、将 ClaudeCode 关联到项目
• 二、常用命令详解
• 三、核心模式：按需切换
• 四、会话管理
• 五、批量执行任务

---

一、将 ClaudeCode 关联到项目

第一步：进入项目路径

打开命令行终端，定位到你的项目目录下：

cd /你的/项目/路径
# 例如：cd /Users/username/projects/my-app

第二步：启动 ClaudeCode 并初始化

在项目路径下启动 ClaudeCode，然后输入 /init 命令并回车：

claude
/init

此时 ClaudeCode 会开始读取项目下的所有文件，并对项目进行全面分析。

系统会询问是否在项目根目录下创建 CLAUDE.md 文件，选择 yes 确认创建。

CLAUDE.md 文件说明

创建成功后，你会在项目根目录下看到生成的 CLAUDE.md 文件。初始内容为英文，包含：

• 项目结构说明
• 各文件功能概述
• 技术栈识别
• 关键代码片段分析

💡 转换为中文：你可以直接让 ClaudeCode 将 CLAUDE.md 文件内容转换成中文：

请将 CLAUDE.md 文件翻译成中文

它会自动完成翻译并更新文件内容。

---

二、常用命令详解

2.1 切换项目目录

当需要切换到其他项目时，使用以下命令：

/add-dir <文件夹路径>

执行后，ClaudeCode 的工作目录会切换到指定项目，并重新加载项目上下文。

2.2 清除对话历史

/clear

适用场景：

• ClaudeCode 出现思路偏差
• 需要开始一个全新的任务
• 想要重置对话上下文

2.3 压缩对话内容

/compact [可选指令]

当对话上下文过长时，使用此命令压缩历史记录。

示例：

/compact "保留尚未解决的问题"

这会让 Claude 在总结时侧重未解决的部分，避免上下文溢出导致对话中断。

2.4 打开并编辑 CLAUDE.md

/memory

执行后会显示选项：

选项	说明	用途
选择 1	项目级别的 CLAUDE.md	项目简介、架构要点、代码规范
选择 2	用户级别的 CLAUDE.md	个人偏好、常用配置、全局设置

选择对应文件后即可进入编辑模式，修改后保存即可自动生效。

2.5 查看和修改配置

/config

显示当前的所有配置项及其启用/禁用状态：

• 自动保存
• 详细日志
• 安全确认
• 等配置项

2.6 查看和切换模型

/model

查看当前使用的模型，并可在支持的模型之间进行切换。

2.7 显示会话与系统状态

/status

查看当前 ClaudeCode 会话的详细信息：

• 会话时长
• 文件数量
• 上下文使用率
• 系统资源占用

2.8 检测安装状态

/doctor

运行诊断检查，确认：

• ClaudeCode 安装状态
• 依赖项完整性
• 权限配置是否正确
• 网络连接状态

2.9 查看 Token 消耗与费用统计

/cost

显示当前会话累计的：

• Token 使用量
• 预估费用
• API 调用次数
• 历史消耗趋势

---

三、核心模式：按需切换

默认情况下，ClaudeCode 每次修改都需要手动确认，效率较低。
快捷键：Shift+Tab 或 Alt+m（不同版本可能略有差异）

3.1 自动编辑模式

项目	说明
特点	免确认批量操作
适用场景	需要连续创建或修改多个文件，无需逐次确认的操作
示例	批量重构、批量重命名、批量格式化

3.2 Plan 模式（规划模式）

项目	说明
特点	只规划不执行
适用场景	项目搭建初期、复杂问题处理、技术方案设计

工作流程：

1. 提出需求（例如：“开发一个像素风格的移动端 TodoList”）
2. Claude 自动规划技术栈、页面结构、适配方案
3. 确认规划符合预期后再开始执行
4. 若不满意，直接说"重新规划"直到方案完善

3.3 Yolo 模式（最高权限模式）

项目	说明
特点	完全放手，自动化执行
启动方式	claude --dangerously-skip-permissions
适用场景	自动化重构、复杂问题修复、新项目启动

启动确认：

$ claude --dangerously-skip-permissions
⚠️ 警告：您正在以最高权限模式启动
是否继续？(y/N)

选择接受后即可进入 Yolo 模式。进入后仍可使用 Shift+Tab 调整模式，灵活控制权限粒度。

3.4 模式总结对比

模式	权限级别	确认要求	适用场景
自动编辑模式	中等	无需逐次确认	批量文件操作
Plan 模式	低	需确认规划	方案设计、技术选型
Yolo 模式	最高	完全放手	自动化重构、紧急修复

---

四、会话管理：避免失控，快速回滚

4.1 暂停与回滚操作

操作	效果	适用场景
按一次 ESC 键	暂停当前操作	安装依赖超时、思路跑偏时及时停止
快速按两次 ESC 键	查看历史对话节点	需要回滚到之前某个状态

4.2 处理上下文溢出

当看到提示：

“Context left until auto-compact: 3%”

说明对话历史即将占满上下文窗口。

应对措施：

• 自动处理：系统会在约150秒后自动触发压缩
• 手动处理：立即执行 /compact 命令
• 预防措施：定期使用 /compact 或控制单次对话长度

4.3 恢复与查看历史对话

如果中途退出或意外关闭 ClaudeCode：

# 直接进入上次对话
claude -c

# 查看历史对话记录（常用）
claude -r

# 选择指定历史会话
claude -r 3  # 恢复第3条历史记录

---

五、批量执行任务

5.1 任务文件准备

在项目根目录下创建 TASK.md 文件，每行写入一个任务：

# 项目任务清单

- [ ] 优化登录页面的加载速度
- [ ] 修复用户注册时的邮箱验证Bug
- [ ] 添加单元测试覆盖率达到80%
- [ ] 更新API文档
- [ ] 重构数据访问层代码
- [ ] 添加错误日志记录功能

5.2 执行批量任务

使用提示词告诉 ClaudeCode：

“读取 TASK.md 中的内容，每一行是一个任务，请依次执行这些任务”

5.3 任务执行监控

ClaudeCode 会：

1. 按顺序读取任务列表
2. 逐一执行每项任务
3. 实时反馈执行进度
4. 记录执行结果和异常
5. 完成后生成任务报告

5.4 高级任务配置

可以在 TASK.md 中使用标记：

# 项目任务清单（带优先级）

## [高优先级]
- [ ] 修复生产环境崩溃Bug（立即执行）

## [中优先级]
- [ ] 优化数据库查询性能
- [ ] 添加新功能模块

## [低优先级]
- [ ] 更新文档
- [ ] 代码格式化

提示词示例：

"本文所有操作均在 weelinking上完成——国内直连 Claude，新用户注册即送额度

---

命令	功能	常用度
/init	初始化项目	⭐⭐⭐
/memory	编辑 CLAUDE.md	⭐⭐⭐
/clear	清除历史	⭐⭐
/compact	压缩上下文	⭐⭐
/cost	查看费用	⭐⭐
Shift+Tab	切换模式	⭐⭐⭐
claude -r	恢复历史	⭐⭐⭐

---

结语：掌握以上 ClaudeCode 的操作技巧，能够大幅提升你的开发效率。从项目初始化、模式切换到会话管理和批量任务执行，合理运用这些功能，让 ClaudeCode 成为你得力的开发助手。

如有问题或建议，欢迎交流探讨