Claude Code CLI 使用指南

基于日常使用经验总结，帮助你高效地用 Claude Code 进行工作、学习和编程。

一、什么是 Claude Code

Claude Code 是 Anthropic 推出的命令行 AI 编程助手，运行在终端中。它能：

读懂整个代码库，帮你写代码、修 bug
执行 shell 命令、管理文件、操作 git
通过 Skills（技能）和 Slash Commands（斜杠命令）扩展能力
支持 Plan Mode（计划模式），先规划再执行

二、核心概念

2.1 斜杠命令

在对话中直接输入 / 开头的命令：

命令	作用	常用场景
`/help`	查看帮助	忘记命令时
`/clear`	清空对话上下文	话题切换、上下文太长时
`/compact`	压缩上下文	Token 快用完时自动触发
`/login`	登录/切换账号	首次使用或换账号
`/logout`	退出登录	切换账号
`/config`	打开配置界面	修改主题、模型等
`/model`	切换模型	切换 opus/sonnet/haiku
`/cost`	查看消耗统计	关注花费时
`/todos`	查看任务列表	跟踪多步骤任务
`/doctor`	诊断环境问题	出问题时排查
`/output-style`	切换输出风格	修改输出格式
`/add-dir`	添加工作目录	多项目同时工作
`/init`	初始化项目 CLAUDE.md	新项目入门
`/statusline`	配置状态栏	自定义终端显示

2.2 Skills（技能）

Skills 是 Claude Code 的可插拔能力模块，输入 /技能名 即可触发。常用 Skill：

Skill	用途
`/review`	审查 PR（Pull Request）
`/code-review`	代码审查，检查 bug 和优化点
`/simplify`	代码简化，消除冗余
`/security-review`	安全检查，发现潜在漏洞
`/init`	初始化项目文档 CLAUDE.md
`/run`	启动项目应用
`/verify`	验证代码变更是否生效
`/loop`	定时循环执行任务
`/deep-research`	深度调研，多源搜索 + 验证
`/pr-comments`	在 PR 中逐行评论
`/create-hook`	创建自动化 Hook
`/keybindings-help`	自定义键盘快捷键

2.3 CLAUDE.md —— 项目记忆

CLAUDE.md 是项目的"记忆文件"，放在项目根目录。Claude 会在对话中自动加载它。

示例 CLAUDE.md：

markdown

# My Project

## 技术栈
- 前端：Vue 3 + Vite
- 后端：Express + TypeScript
- 数据库：PostgreSQL

## 常用命令
- `npm run dev` 启动开发服务器
- `npm test` 运行测试
- `npm run build` 构建生产版本

## 代码风格
- 使用 Prettier 格式化
- 变量名用 camelCase
- 每行不超过 100 字符

## 注意事项
- 不要直接修改 `dist/` 目录
- API 请求需要加 `Authorization` header

有了 CLAUDE.md，每次对话 Claude 都清楚你的项目结构。

2.4 Memory（全局记忆）

除了项目级的 CLAUDE.md，Claude Code 还支持跨会话持久化记忆。你可以告诉 Claude：

记住我偏爱 TypeScript，缩进用 2 空格

Claude 会将这类偏好存入记忆，之后的所有对话都会遵循。

三、工作流程

3.1 新功能开发

你：我想给项目加一个用户登录功能

Claude 会自动进入 Plan Mode，先分析代码库，输出实现方案等你确认。

最佳实践：

先描述需求 → Claude 出计划
审核计划 → 确认无误
Claude 逐步实现 → 你在旁边观察
验证结果 → 确认功能正常

3.2 Bug 修复

你：点击登录按钮后页面空白，帮我排查

Claude 会：

读代码找可能的原因
检查日志和错误信息
提出修复方案
修改代码

3.3 代码审查

/review

或直接说：

帮我审查一下刚才的改动

3.4 学习提问

bash

# 直接问技术问题
你：这段代码为什么用 useMemo 而不是 useEffect？

# 让 Claude 解释原理
你：解释一下 Docker 的网络模式

# 看代码解释
你：解释一下 src/auth/login.ts 的逻辑

3.5 日常任务

bash

# 重构
你：把 utils.js 重构为 TypeScript

# 写测试
你：给 auth 模块写单元测试

# 写文档
你：给这个 API 写接口文档

# 部署
你：帮我部署到生产环境

四、项目管理技巧

4.1 多项目切换

bash

# 在不同目录启动 Claude
cd ~/project-a && claude
cd ~/project-b && claude

# 或使用 /add-dir 命令
/add-dir ~/project-b

4.2 用好 CLAUDE.md

每个项目都应该有 CLAUDE.md，内容建议：

1. 项目简介（一句话）
2. 技术栈
3. 目录结构
4. 常用命令（启动、测试、构建、部署）
5. 代码规范
6. 注意事项（坑、特殊配置）

4.3 Hook 自动化

在 .claude/settings.json 中配置 Hook，实现自动化：

json

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Write|Edit",
        "hooks": [{
          "type": "command",
          "command": "npx prettier --write ${CLAUDE_FILES}"
        }]
      }
    ]
  }
}

这样每次写入文件后，自动运行 Prettier 格式化。

4.4 任务跟踪

复杂任务使用任务列表：

/todos

Claude 会自动创建分步骤的任务，逐步完成并标记状态。

五、实用技巧

5.1 `--resume` 恢复会话

程序崩溃或关闭终端后，重新打开相同目录运行 claude --resume 恢复上次对话：

bash

cd ~/my-project && claude --resume

5.2 `--continue` 继续执行

让 Claude 从上一次中断的地方继续工作：

bash

claude --continue

5.3 管道输入

直接把文件内容传给 Claude：

bash

cat error.log | claude "分析这个日志"
git diff | claude "审查改动"
npm test 2>&1 | claude "定位失败原因"

5.4 使用 `!` 前缀

在对话中直接运行 shell 命令：

! git log --oneline -5
! npm run build

5.5 背景任务

耗时操作放在后台：

你：在后台安装依赖，然后继续做其他事

5.6 拖拽文件

直接把文件拖到终端窗口，Claude 会读取它。

5.7 善用 Plan Mode

复杂任务先让 Claude 出计划，确认后再执行，避免走弯路：

你计划一下：把单体应用拆成微服务

六、Skills 进阶用法

6.1 `/deep-research` 深度调研

适用于需要查证多源信息的场景：

/deep-research React 19 相比 18 有哪些破坏性变更

Claude 会：

同时发起多个 Web 搜索
抓取相关页面
交叉验证信息
输出结构化的调研报告

6.2 `/loop` 定时任务

bash

# 每 5 分钟检查一次部署状态
/loop 5m 检查部署是否完成

# 每 30 分钟检查 CI 状态
/loop 30m 检查 CI pipeline 状态

6.3 `/code-review` 多层次审查

bash

# 快速审查
/code-review

# 深度审查
/code-review --effort max

# 审查后自动修复
/code-review --fix

6.4 `/security-review` 安全检查

每次上线前跑一下：

/security-review

七、配置与定制

7.1 设置全局默认模型

bash

/claude-config

或直接编辑 ~/.claude.json：

json

{
  "model": "claude-sonnet-4-6"
}

7.2 主题切换

/theme dark   # 暗色模式
/theme light  # 亮色模式

7.3 权限管理

在 .claude/settings.json 中预授权常用操作，减少弹窗：

json

{
  "permissions": {
    "allow": [
      "Bash(npm test)",
      "Bash(npm run build)",
      "Bash(git diff)",
      "Bash(git status)"
    ]
  }
}

八、常见问题

问题	解决方法
上下文太长	`/compact` 压缩
回答不准确	提供更多上下文，或 `/clear` 重来
权限弹窗太多	在 settings.json 中配置 allow 列表
忘记做过什么	`/cost` 查看本次消耗
Claude 不理解项目	检查 `CLAUDE.md` 是否存在且内容完善
网络超时	检查代理设置，或等一会儿重试

九、总结

场景	推荐方式
新建项目	`/init` 生成 CLAUDE.md，然后描述需求
修改代码	直接描述，Claude 先读代码再改
代码审查	`/code-review` 或 `/review`
安全审查	`/security-review`
学习新技术	直接提问，复杂问题用 `/deep-research`
重复任务	`/loop` 定时执行
部署	描述部署流程，Claude 逐步执行
遇到 bug	把错误信息贴过来

核心就一条：把 Claude 当作一个随时在线的资深同事，该问的问，该让它做的做。

Claude Code CLI 使用指南 ​

一、什么是 Claude Code ​

二、核心概念 ​

2.1 斜杠命令 ​

2.2 Skills（技能） ​

2.3 CLAUDE.md —— 项目记忆 ​

2.4 Memory（全局记忆） ​

三、工作流程 ​

3.1 新功能开发 ​

3.2 Bug 修复 ​

3.3 代码审查 ​

3.4 学习提问 ​

3.5 日常任务 ​

四、项目管理技巧 ​

4.1 多项目切换 ​

4.2 用好 CLAUDE.md ​

4.3 Hook 自动化 ​

4.4 任务跟踪 ​

五、实用技巧 ​

5.1 --resume 恢复会话 ​

5.2 --continue 继续执行 ​

5.3 管道输入 ​

5.4 使用 ! 前缀 ​

5.5 背景任务 ​

5.6 拖拽文件 ​

5.7 善用 Plan Mode ​

六、Skills 进阶用法 ​

6.1 /deep-research 深度调研 ​

6.2 /loop 定时任务 ​

6.3 /code-review 多层次审查 ​

6.4 /security-review 安全检查 ​

七、配置与定制 ​

7.1 设置全局默认模型 ​

7.2 主题切换 ​

7.3 权限管理 ​

八、常见问题 ​

九、总结 ​

Claude Code CLI 使用指南

一、什么是 Claude Code

二、核心概念

2.1 斜杠命令

2.2 Skills（技能）

2.3 CLAUDE.md —— 项目记忆

2.4 Memory（全局记忆）

三、工作流程

3.1 新功能开发

3.2 Bug 修复

3.3 代码审查

3.4 学习提问

3.5 日常任务

四、项目管理技巧

4.1 多项目切换

4.2 用好 CLAUDE.md

4.3 Hook 自动化

4.4 任务跟踪

五、实用技巧

5.1 `--resume` 恢复会话

5.2 `--continue` 继续执行

5.3 管道输入

5.4 使用 `!` 前缀

5.5 背景任务

5.6 拖拽文件

5.7 善用 Plan Mode

六、Skills 进阶用法

6.1 `/deep-research` 深度调研

6.2 `/loop` 定时任务

6.3 `/code-review` 多层次审查

6.4 `/security-review` 安全检查

七、配置与定制

7.1 设置全局默认模型

7.2 主题切换

7.3 权限管理

八、常见问题

九、总结