快速开始

安装与启动

# 启动 Claude Code
claude

# 危险模式(跳过权限确认):
claude --dangerously-skip-permissions

# 查看版本
claude --version

# 更新到最新版
claude update
# 或
npm update -g @anthropic-ai/claude-code

# 继续上次会话
claude --continue

# 恢复指定会话
claude --resume <n>

# Headless 模式执行
claude -p "提示词"

设置中文（4种方法）

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

nano ~/.claude/settings.json

添加语言配置：

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

方法二：命令行设置

claude config set -g language Chinese

方法三：修改全局记忆

nano ~/.claude/CLAUDE.md

添加：

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

方法四：使用 /memory 命令

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

所有对话使用中文回复

实用技巧

基础操作技巧

1. 项目初始化(/init)

# 自动生成 CLAUDE.md
/init

2. 快速引用上下文(@提及)

# 引用单个文件
@src/auth.ts

# 引用整个目录
@src/components/

# 引用多个文件
@src/auth.ts @src/user.ts @src/database.ts

# 引用 MCP 服务器
@mcp:github

# 模糊匹配
@auth  # 自动匹配 auth.ts, auth.controller.ts 等

3. 即时执行 Bash 命令(!前缀)

# 查看状态
!git status

# 查看node版本
!node -v

# 查看进程
!ps aux | grep node

# 组合使用
!git diff && echo "=== Changes Summary ==="

4. 回退操作(双击 ESC)

斜杠命令

命令	说明
/help	查看所有可用指令
/clear	清除当前对话上下文，开始一个全新的话题
/compact	压缩上下文，保留总结，然后清除掉具体的对话细节
/context	可视化上下文，显示当前 token 使用情况、上下文占用百分比、各文件占用大小、建议优化方向
/resume	恢复之前的会话
/add-dir	让 Claude 看到当前项目文件夹之外的文件夹，适用于跨项目开发
/exit / /quit	退出 Claude Code
/status	查看系统状态
/cost	查看当前会话成本
/doctor	诊断系统问题
/memory	管理项目记忆（CLAUDE.md）
/init	初始化项目，生成 CLAUDE.md
/config	打开配置面板
/permissions	管理权限规则
/model	切换 AI 模型
/ide	连接代码编辑器
/review	审查代码变更
/install-github-app	召唤“GitHub 智能助理”，安装后，你就可以在 Pull Request （PR） 和 Issue 的评论区里，通过 @claude 来召唤它干活
/vim	切换 Vim 编辑模式
/mcp	管理 MCP 服务器
/hooks	设置自动化钩子
/plugin	管理插件
/rename	重命名当前会话
/rewind	回退到之前的状态
/login	切换登录账户

其他命令&快捷键

1. 换行：Option + Enter
2. 恢复最后一次会话：claude -c或claude --continue
3. 恢复任意历史会话：claude -r或claude --resume
4. 规划模式：探索实施计划（只读）

# 方式一：启动时指定
claude --permission-mode plan

# 方式二：会话中切换
按 Shift+Tab

5. 使用免确认模式（在当前会话不再询问授权）：claude --dangerously-skip-permissions
6. 打断工作：如果你想让它停止，只需要按 ESC 键即可

---

Skills

Skills 是 Claude Code 的扩展能力系统，是别人已经编写好的、可直接使用的功能模块，提供专业领域的预置知识和工具。

Skills 与 Plugins 的区别：

• Plugins - 功能型扩展，添加新的工作流和命令
• Skills - 知识型扩展，为 Claude 提供特定领域的专业能力

使用场景：

• 添加文档处理能力（PDF、DOCX、PPTX）
• 增强特定编程语言的支持
• 集成行业专业知识

创建skills

方法一：自然语言安装（推荐）

直接告诉 Claude Code 你想安装的 Skill：

> 帮我安装这个 skill，地址：
> https://github.com/anthropics/skills/blob/main/skills/pptx

Claude 会自动下载并安装该 Skill。

方法二：手动安装

步骤：

1. 从 GitHub 或其他来源下载 Skill 文件
2. 将 Skill 放到指定目录：
   • 全局 Skills：~/.claude/skills/
   • 项目 Skills：项目根目录/.claude/skills/
3. 重启 Claude Code 使其生效

示例：

# 创建 skills 目录
mkdir -p ~/.claude/skills

# 下载 skill（示例）
cd ~/.claude/skills
git clone https://github.com/anthropics/skills/tree/main/skills/pptx

# 重启 Claude Code
/exit
claude

方法三：插件市场安装

通过插件市场安装官方 Skills 包：

# 1. 添加官方 Skills 市场
> /plugin marketplace add anthropics/skills

# 2. 安装 Skills 包
> /plugin install document-skills@anthropic-agent-skills

# 3. 重启 Claude Code
> /exit
claude

方法四、创建自定义 Skill

你也可以创建自己的 Skill：

1. 在 ~/.claude/skills/ 创建新目录
2. 添加 Skill 定义文件（通常是 Markdown 格式）
3. 定义 Skill 的能力和使用说明
4. 重启 Claude Code

示例结构：

my-skill/
├── skill.json          # Skill 元数据
├── skill.md            # Skill 文档
├── api/                # API 定义(可选)
└── tools/              # 自定义工具(可选)

使用Skills

# 安装后验证
> /status

# 查看可用 Skills：
claude /skills

# 查看 Skills 目录
ls ~/.claude/skills/

# 使用 Skill 功能
> 使用 frontend-design skill创建一个贪吃蛇网页小游戏
> 帮我创建一个演示文稿，主题是 AI 发展历程

---

Subagents(子代理)

Subagents 是可以并行处理任务的独立 AI 代理，可以给每个子代理分配不同任务以提高效率。

配置文件

在.claude/agents.json 中配置：

  "agents": {
    "code-reviewer": {
      "description": "专门负责代码审查的子代理",
      "model": "claude-opus-4-5",
      "instructions": "你是一个专业的代码审查专家,专注于检查代码质量、安全漏洞和性能问题。",
      "tools": ["read", "search", "git"],
      "permissions": {
        "allowWrite": false
      }
    },
    "test-writer": {
      "description": "专门负责编写测试的子代理",
      "model": "claude-sonnet-4-5",
      "instructions": "你是一个测试工程师,专注于编写全面的单元测试和集成测试。",
      "tools": ["read", "write", "bash"]
    },
    "doc-generator": {
      "description": "专门负责生成文档的子代理",
      "model": "claude-sonnet-4-5",
      "instructions": "你是一个技术文档专家,专注于生成清晰、准确的技术文档。",
      "tools": ["read", "write"]
    }
  }
}

Subagent 使用示例

完成一个功能开发：我需要完成用户认证功能,请帮我:
1. 使用 code-reviewer agent 审查现有认证代码
2. 使用 test-writer agent 编写测试用例
3. 使用 doc-generator agent 更新 API 文档

这三个任务并行执行

Claude Code 会自动：
创建三个独立的子代理；分配各自的上下文；并行执行任务；汇总结果返回。

来自 Claude Code 创始人 Boris Cherny 的实际使用案例:
code-simplifier:

# .claude/agents/code-simplifier.md

你是一个代码精简专家。在 Claude 完成工作后,你的任务是:
1. 分析代码的复杂度和可读性
2. 识别可以简化的逻辑
3. 提供优化建议但保持功能不变
4. 优先考虑性能和可维护性

verify-app:

# .claude/agents/verify-app.md

你是一个端到端测试专家。你的任务是验证应用功能:
1. 运行完整的测试套件
2. 检查所有关键路径
3. 验证边界情况
4. 确保用户体验"感觉对劲"
5. 如果发现问题,提供详细的修复步骤

使用方式：

使用 code-simplifier agent 优化刚才写的代码

使用 verify-app agent 验证应用是否正常工作

参考链接：https://juejin.cn/post/7592079304923824138#heading-36

核心命令详解

一、会话控制与对话管理

这些指令是你与 Claude 进行流畅对话的基石，负责会话的生命周期管理。

/help - 随身说明书

功能： 列出所有可用的斜杠指令及其说明。

使用场景：

• 忘记某个指令的具体写法
• 探索 Claude Code 的所有功能

示例：

> /help

# 输出所有可用指令列表
# /clear   - Clear conversation history
# /compact - Compress context
# /memory  - Manage project memory
# ...

/clear - 彻底清空记忆

功能： 清除当前会话的所有上下文，开始全新对话。

使用场景：

• 切换到完全不相关的任务
• 对话混乱，需要重新开始

示例：

> 把这个按钮的边框改成圆角

> /clear

# (终端清空，就像重新启动)
> 帮我解释一下什么是 git rebase

/compact - 智能压缩上下文

功能： 总结当前对话的核心内容，清除细节，释放上下文空间。

使用场景：

• 长任务的阶段性总结
• 上下文即将满载时

示例：

> /compact

# Claude 输出总结：
# 已压缩对话。要点：使用 Redis 缓存热门数据，缓存时间 5 分钟。

> 现在帮我编写实现这个缓存的代码

高级用法：

# 自定义总结方式
> /compact 请重点总结我们确定的技术选型和架构决策

/resume - 恢复历史会话

功能： 加载之前的对话记录，继续未完成的工作。

使用场景：

• 继续昨天未完成的功能
• 恢复意外关闭的会话

示例：

> /resume

# 显示可选择的会话列表
# Select a conversation:
# > 1. 2025-07-08 10:30 - "修复登录页面 Bug" (5 messages)
#   2. 2025-07-07 15:00 - "数据库迁移" (28 messages)

快捷方式：

# 命令行启动时继续上次会话
claude --continue

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

/rename - 重命名会话

功能： 给当前会话起一个有意义的名字，方便后续查找。

示例：

> /rename 功能开发-用户登录模块

/exit - 退出程序

功能： 安全退出 Claude Code。

快捷键： Ctrl+D

---

二、状态诊断与监控

这些指令是你的"仪表盘"，帮助你了解 Claude 的运行状态。

/status - 系统状态报告

功能： 显示 Claude Code 的版本、模型、账户、API 连接等状态。

使用场景：

• 响应变慢时检查网络
• 确认当前使用的模型
• 验证 IDE 集成状态

示例：

> /status

# 输出：
# Version: 1.7.0
# Model: claude-3-5-sonnet-20240620
# Account: user@example.com
# API: Connected
# IDE: VSCode Connected
# MCP Servers: 2 connected

/cost - 查看费用

功能： 显示当前会话的 token 消耗和估算费用。

注意： 只计算当前会话，/clear 后重置。

示例：

> /cost

# Session Cost:
# Input Tokens: 12,345
# Output Tokens: 8,765
# Total Cost: ~$0.05 USD

/doctor - 系统自检

功能： 深度检查 Claude Code 的安装环境和配置。

使用场景：

• 启动失败或频繁崩溃
• 某些功能无法正常使用
• 系统环境变化后验证兼容性

示例：

> /doctor

# ✅ Node.js version: OK
# ✅ npm permissions: OK
# ✅ Config files: OK
# ✅ API connection: OK
# All systems healthy!

---

三、记忆与上下文管理

Claude Code 的强大之处在于可配置的"长期记忆"。

/memory - 编辑项目记忆

功能： 打开 CLAUDE.md 文件，这是 Claude 的项目专属记忆。

使用场景：

• 定义项目的编码规范
• 记录重要的架构决策
• 指定常用命令和工作流

示例：

> /memory

# 打开编辑器，可以添加：
# ---
# # 本项目编码规范
#
# - 所有 Python 函数必须有类型提示
# - commit 遵循 Conventional Commits 格式
# - 测试命令：pytest
# - 禁止直接操作生产数据库
# ---

/init - 自动生成项目记忆

功能： 让 Claude 分析项目，自动生成 CLAUDE.md 模板。

使用场景：

• 新项目首次配置
• 快速创建团队共享的 AI 指导文件

示例：

> /init

# ✅ 已创建 CLAUDE.md 文件
# 包含项目概述、文件结构、关键依赖
# 建议提交到代码仓库供团队使用

/add-dir - 扩展访问范围

功能： 授权 Claude 访问当前项目之外的文件夹。

注意： 仅在当前会话有效。

使用场景：

• 参考其他项目的代码
• 比较不同项目的实现

示例：

> /add-dir ../backend-project/src/api

# ✅ 目录已添加到上下文
# 现在可以访问该文件夹的文件

> 帮我看一下 ../backend-project/src/api/user.py 的 API 定义

---

四、配置与权限管理

成为 Claude Code 的"配置大师"。

/config - 配置面板

功能： 打开交互式配置菜单，调整各种设置。

可配置项：

• 主题颜色
• 默认模型
• Vim 模式
• 语言设置
• 其他高级选项

示例：

> /config

# Claude Code Configuration
# General:
#   Theme: [ dark | light | auto ]
#   Language: [ Chinese | English ]
#   Vim Mode: [ true | false ]
# Model:
#   Default: [ sonnet | opus | haiku ]

/permissions - 权限管理

功能： 管理"允许规则"和"拒绝规则"，定义 Claude 的行为边界。

核心原则： 拒绝规则优先级高于允许规则。

使用场景：

• 将常用命令加入白名单（如 npm test）
• 禁止危险操作（如 rm -rf、git push --force）
• 保护敏感文件

示例：

> /permissions

# Tool Permissions
#
# Allow Rules (无需确认):
#   - Bash(npm test)
#   - Read(src/**)
#
# Deny Rules (永久禁止):
#   - Bash(git push --force)
#   - Write(config/production.json)

/model - 切换 AI 模型

功能： 临时切换当前会话使用的 AI 模型。

可选模型：

• Sonnet - 平衡速度与质量，日常推荐
• Opus - 最强大，适合复杂问题
• Haiku - 最快速，适合简单任务

使用场景：

• 日常用 Sonnet，复杂架构问题切换到 Opus
• 比较不同模型的表现

示例：

> /model

# Select a model:
# > 1. claude-3-5-sonnet (推荐)
#   2. claude-3-opus (最强大)
#   3. claude-3-haiku (最快)

# 切换后：
# Now using claude-3-opus for this session

快捷键： Alt + P / Option + P

---

五、代码与工作流集成

打通 Claude Code 与开发工具链的连接。

/ide - 连接代码编辑器

功能： 让 Claude 与 VS Code / JetBrains 编辑器深度集成。

核心能力：

• 上下文共享：看到你选中的代码和打开的文件
• 代码变更预览：在 IDE 的 Diff 视图中预览修改
• 错误自动捕获：IDE 的错误信息自动分享给 Claude

最佳实践： 在 IDE 的内置终端中启动 Claude Code。

示例：

# 在 VS Code 内置终端启动
> claude

# 或连接外部终端
> /ide

# ✅ Successfully connected to Visual Studio Code
# 现在可以看到编辑器上下文和显示 Diff

典型工作流：

1. 在 VS Code 中选中一段代码
2. 在终端输入：重构这段选中的代码
3. VS Code 自动弹出 Diff 预览窗口
4. 逐行审查后应用修改

/review - 代码审查

功能： 让 Claude 审查所有未提交的代码改动。

使用场景：

• 提交前的最后质量检查
• 获取代码改进建议

示例：

> /review

# Claude 分析后输出：
# ### src/components/Login.tsx:
# - 建议：handleLogin 函数有重复逻辑，
#   可以提取验证部分到独立函数
# - 问题：新增的 isLoading 状态是否处理了 UI 显示？
#
# ### api/routes.py:
# - 小问题：第 42 行注释有拼写错误
#
# 总体逻辑没问题，修复这些会更好。

/install-github-app - GitHub 集成

功能： 将 Claude 能力注入 GitHub 仓库。

使用场景：

• 在 PR 评论中 @claude review this PR
• 在 Issue 中 @claude implement this feature

示例：

> /install-github-app

# 引导安装过程：
# 1. 打开浏览器访问安装链接
# 2. 选择要安装的仓库
# 3. 完成后即可在 GitHub 中使用

/pr-comments - 获取 PR 评论

功能： 拉取 GitHub PR 的所有评论到终端。

使用场景：

• 集中查看和处理 PR 反馈
• 让 Claude 根据评论修改代码

示例：

> /pr-comments 123

# Fetching comments for PR #123...
#
# User: "colleague" on src/utils/auth.js:
# > 这个 token 没有过期时间，应该加 expiresIn
#
# User: "another" on README.md:
# > 请添加新环境变量的说明

> 根据第一条评论，给 JWT 加上 24 小时过期时间

---

六、账户与系统管理

处理账户切换、升级和系统维护。

/login - 切换账户

功能： 退出当前账户并重新登录。

使用场景：

• 在个人和工作账户之间切换
• 刷新过期的登录凭证

/logout - 安全登出

功能： 退出账户并删除本地凭证。

使用场景：

• 在共享电脑上使用后安全清除
• 解决认证问题时重置

/upgrade - 升级套餐

功能： 引导你到官网升级订阅计划。

使用场景：

• 使用额度不够，需要更高限额
• 想使用 Opus 等高级模型

---

七、高级扩展功能

为高级用户准备的强大功能。

/hooks - 自动化钩子

功能： 在 Claude 执行特定动作前后自动运行脚本。

使用场景：

• 代码修改后自动格式化（prettier、eslint）
• 提交前自动运行安全扫描
• 自定义通知（发送到 Slack、飞书）

示例：

> /hooks

# Event: PostToolUse (工具使用后)
# Matcher: Write|Edit (匹配写入/编辑)
# Hook: npx prettier --write $FILE

常见钩子：

# 自动格式化
PostToolUse: Write|Edit -> npx prettier --write $FILE

# 提交前扫描
PreToolUse: Bash(git commit) -> npm run security-scan

# 飞书通知
PreApprovalRequired -> curl -X POST $FEISHU_WEBHOOK

/mcp - MCP 服务器管理

功能： 通过 Model Context Protocol 连接外部数据源和工具。

使用场景：

• 连接数据库，直接查询数据
• 集成 Jira，管理任务
• 连接公司内部 API

示例：

> /mcp

# MCP Server Status:
#   - postgres_db: ✅ Connected
#   - jira_api: ⚠️ Needs Auth

> @postgres_db:schema://users 显示用户表结构

/vim - Vim 编辑模式

功能： 在输入框中启用 Vim 键位。

使用场景：

• Vim 用户保持习惯
• 编辑长段文本和多行命令

快捷键： 按 i 进入插入模式，Esc 退出插入模式。

设置默认： 在 /config 中启用 “Vim Mode by default”。

ultrathink 深度思考模式

当你需要设计复杂的缓存层或重构架构时，在提示词中加上 ultrathink。

# 标准模式
设计一个 Redis 缓存层

# ultrathink 模式
ultrathink: 设计一个高可用的 Redis 缓存层,考虑:
- 缓存穿透、缓存击穿、缓存雪崩
- 分布式锁
- 缓存更新策略
- 降级方案

效果:

• Claude 会分配高达 32k 的 Token 进行内部推理；
• 虽然反应慢一点,但逻辑准确率大幅提升；
• 适合架构设计、复杂重构等关键任务

配置与最佳实践

配置文件结构

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

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

settings.json 示例

{
  "language": "Chinese",
  "defaultModel": "claude-3-5-sonnet-20240620",
  "theme": "dark",
  "vimModeByDefault": false,
  "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 示例

# 项目规范

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

## 代码规范
- 语言版本：Swift 5.9+
- 架构模式：MVVM
- 代码风格：遵循 SwiftLint 规则
- 缩进：4 个空格

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

## 常用命令
- 运行测试：`swift test`
- 代码格式化：`swiftformat .`
- 代码检查：`swiftlint`

## 重要规则
- 禁止直接操作生产数据库
- 所有 API 调用必须有错误处理
- 敏感信息从环境变量读取