Claude Code 完整使用指南

tiantian_cool
13 阅读7分钟

版本：v2.1.x | 更新时间：2026年1月

一、常用命令

斜杠命令

命令说明
/help查看帮助
/config配置设置（语言、模型等）
/model切换模型
/memory管理全局记忆（CLAUDE.md）
/init初始化项目，生成 CLAUDE.md
/clear清除当前对话上下文
/compact压缩上下文，节省 token
/exit退出 Claude Code
/bug报告 bug
/doctor诊断问题
/usage查看用量
/stats查看统计信息
/permissions管理权限
/terminal-setup终端设置优化
/export导出对话
/resume恢复会话
/rename重命名会话
/rewind回退到之前的代码状态
/plugin管理插件
/mcp管理 MCP 服务器
/agents管理自定义代理
/context管理上下文

终端命令

命令说明
claude启动 Claude Code
claude --version查看版本
claude --help查看帮助
claude update更新到最新版
claude --continue继续上次会话
claude --resume <n>恢复指定会话
claude -p "提示词"Headless 模式执行
claude config set -g language Chinese设置语言

二、设置中文

方法一：修改配置文件（推荐）

nano ~/.claude/settings.json

添加 "language": "Chinese"：

{
  "language": "Chinese",
  "enabledPlugins": {
    ...
  }
}

方法二：修改 CLAUDE.md

nano ~/.claude/CLAUDE.md

添加：

## 语言规范
- 所有对话和文档都使用中文
- 代码注释使用中文

方法三：/memory 命令

在 Claude Code 中输入 /memory，添加规则：

所有对话使用中文回复

方法四：命令行设置

claude config set -g language Chinese

三、快捷键

快捷键说明
Ctrl + C中断当前操作
Ctrl + Z暂停 Claude Code（fg 恢复）
Ctrl + B后台运行任务
Ctrl + R搜索历史提示词
Ctrl + L清屏
Tab接受提示建议
Shift + TabPlan 模式中选择自动接受编辑
Alt + P / Option + P切换模型
Alt + T切换思考模式
Esc Esc快速回退到上一个检查点
@文件名引用文件

四、隐藏技巧

1. 思考模式

# 深度思考
think harder

# 超深度思考（复杂架构问题）
ultrathink

2. 并行任务（Subagent）

使用 4 个并行任务分别检查：
1. 网络模块
2. 数据库模块
3. UI 模块
4. 测试覆盖

3. 后台运行

# 在 Web 端用 & 开头发送后台任务
& 运行测试并生成报告

# 终端中按 Ctrl+B 将任务发送到后台

4. Plan 模式

# 进入计划模式，先规划再执行
Shift + Tab

或输入：

进入 plan 模式，先分析再执行

5. 文件引用技巧

@src/main.swift      # 引用单个文件
@src/               # 引用整个目录
@CLAUDE.md          # 引用记忆文件

6. 检查点回退

/rewind              # 回退代码和对话
Esc Esc              # 快速回退

7. 隐藏账户信息（直播/录屏）

export CLAUDE_CODE_HIDE_ACCOUNT_INFO=true
claude

8. 权限模式

# 自动接受编辑
claude --permission-mode acceptEdits

# 跳过所有权限检查（仅沙箱环境）
claude --dangerously-skip-permissions

9. 自定义 Slash 命令

在 .claude/commands/ 创建 markdown 文件：

mkdir -p .claude/commands
echo "请检查代码规范并修复问题" > .claude/commands/lint.md

使用：/lint

10. 会话管理

# 命名当前会话
/rename 功能开发-用户登录

# 恢复指定会话
claude --resume 1

# 继续上次会话
claude --continue

五、实用插件

插件安装方法

# 1. 添加官方插件市场
/plugin marketplace add anthropics/claude-code

# 2. 安装插件
/plugin install <插件名>@claude-code-plugins

# 3. 重启 Claude Code 生效
/exit
claude

推荐插件列表

插件安装命令用途
feature-dev/plugin install feature-dev@claude-code-plugins7 阶段功能开发工作流
superpowers/plugin install superpowers@superpowers-marketplaceTDD、计划、执行完整流程
ralph-wiggum/plugin install ralph-wiggum@claude-code-plugins自主循环执行任务
frontend-design/plugin install frontend-design@claude-code-plugins前端设计
code-review/plugin install code-review@claude-code-plugins代码审查
pr-review-toolkit/plugin install pr-review-toolkit@claude-code-pluginsPR 审查工具包

Superpowers 安装

/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace

命令：

  • /superpowers:brainstorm - 头脑风暴
  • /superpowers:write-plan - 编写计划
  • /superpowers:execute-plan - 执行计划

六、代码审查

code-review 插件

# 安装
/plugin install code-review@claude-code-plugins

# 本地审查（输出到终端）
/code-review

# 作为 PR 评论发布
/code-review --comment

pr-review-toolkit 插件（6 个专业代理）

# 安装
/plugin install pr-review-toolkit@claude-code-plugins

# 完整审查（所有代理）
/pr-review-toolkit:review-pr

# 仅审查测试
/pr-review-toolkit:review-pr tests

# 仅审查错误处理
/pr-review-toolkit:review-pr errors

# 仅审查注释和文档
/pr-review-toolkit:review-pr comments

# 审查类型设计
/pr-review-toolkit:review-pr types

# 代码简化建议
/pr-review-toolkit:review-pr simplify

# 全部审查
/pr-review-toolkit:review-pr all

6 个代理功能：

代理功能评分
comment-analyzer注释准确性、文档完整性高置信度问题
pr-test-analyzer测试覆盖率、测试缺口1-10（10=必须添加）
silent-failure-hunter错误处理、静默失败严重程度
type-design-analyzer类型设计质量4 维度 1-10
code-reviewer代码质量、bug 检测0-100（91+=严重）
code-simplifier复杂度分析、简化建议-

推荐审查工作流

# 1. 写完代码后，暂存更改
git add .

# 2. 运行本地审查
/pr-review-toolkit:review-pr

# 3. 根据反馈修复问题

# 4. 再次审查确认
/code-review

# 5. 提交代码
git commit -m "feat: xxx"

七、环境变量

变量说明
CLAUDE_CODE_HIDE_ACCOUNT_INFO隐藏账户信息（直播用）
CLAUDE_CODE_SHELL指定 shell
ANTHROPIC_MODEL指定默认模型
ANTHROPIC_LOG=debug开启调试日志
CLAUDE_CODE_SHELL_PREFIXShell 命令前缀
CLAUDE_CODE_FILE_READ_MAX_OUTPUT_TOKENS文件读取 token 限制
CLAUDE_CODE_PROXY_RESOLVES_HOSTS代理 DNS 解析

八、配置文件结构

~/.claude/
├── settings.json      # 全局设置
├── CLAUDE.md          # 全局记忆
├── skills/            # 自定义技能
├── plugins/           # 插件缓存
└── commands/          # 全局命令

项目目录/.claude/
├── settings.json      # 项目设置
├── CLAUDE.md          # 项目记忆
├── commands/          # 项目命令
├── rules/             # 规则文件
├── skills/            # 项目技能
└── agents/            # 自定义代理

settings.json 示例

{
  "language": "Chinese",
  "enabledPlugins": {
    "feature-dev@claude-code-plugins": true,
    "superpowers@superpowers-marketplace": true,
    "ralph-wiggum@claude-code-plugins": true,
    "code-review@claude-code-plugins": true,
    "pr-review-toolkit@claude-code-plugins": true
  }
}

CLAUDE.md 示例

# 项目规范

## 语言规范
- 所有对话和文档使用中文
- 代码注释使用中文

## 代码规范
- 使用 Swift 5.9+
- 遵循 SwiftLint 规则
- 使用 MVVM 架构

## 项目结构
- /Sources - 源代码
- /Tests - 测试代码
- /Resources - 资源文件

九、并行开发

Git Worktree 方式

# 创建独立工作树
git worktree add ../feature-a feature-a
git worktree add ../feature-b feature-b

# 在不同终端分别启动
cd ../feature-a && claude
cd ../feature-b && claude

Subagent 方式（单会话内）

使用 4 个并行任务分别处理：
- 任务1：重构登录模块
- 任务2：优化数据库查询
- 任务3：添加日志系统
- 任务4：编写 API 文档
并行度设为 4，同时执行

Headless 模式批量执行

claude -p "任务1描述" &
claude -p "任务2描述" &
claude -p "任务3描述" &

十、Ralph Wiggum 自主循环

安装

/plugin marketplace add anthropics/claude-code
/plugin install ralph-wiggum@claude-code-plugins

使用格式

/ralph-wiggum:ralph-loop "任务描述" --max-iterations N --completion-promise "DONE"

完整示例

/ralph-wiggum:ralph-loop "实现用户登录功能，包含 JWT 认证。完成标准：登录接口可用，测试通过，完成后输出 DONE" --max-iterations 30 --completion-promise "DONE"

停止循环

/cancel-ralph

适用场景

✅ 适合❌ 不适合
大型代码重构需要判断力的决策
批量文件处理架构设计
测试覆盖生成安全敏感代码
文档自动生成需求模糊的探索性工作

Prompt 写法建议

/ralph-wiggum:ralph-loop "
## 任务
为 iOS 项目实现网络缓存模块

## 要求
1. 使用 URLCache 实现 HTTP 缓存
2. 支持自定义缓存过期时间
3. 编写单元测试

## 完成标准
- [ ] CacheManager 类实现完成
- [ ] 单元测试覆盖核心逻辑
- [ ] 代码编译无错误

## 完成后
当以上所有标准都满足时，输出 DONE
" --completion-promise "DONE" --max-iterations 25

附录：feature-dev vs superpowers 对比

对比项feature-devsuperpowers
来源Anthropic 官方社区（Jesse Vincent）
定位单一功能开发工作流完整软件开发方法论
命令/feature-dev/superpowers:brainstorm 等
流程7 阶段引导式开发头脑风暴 → 计划 → 执行
特色结构化、官方维护TDD、subagent 驱动、可扩展

常见问题

Q: 如何更新 Claude Code？

claude update
# 或
npm update -g @anthropic-ai/claude-code

Q: 如何查看当前版本？

claude --version

Q: 中文设置后偶尔还是英文回复？

这是正常现象，可以在对话中再次提醒"请用中文回答"，或在 CLAUDE.md 中强调语言规范。

Q: 如何恢复之前的会话？

# 继续上次会话
claude --continue

# 恢复指定会话
claude --resume 1

# 查看会话列表
/resume

Q: 插件安装后没生效？

重启 Claude Code：

/exit
claude
avatar
文章
阅读
粉丝