Claude Code 完全使用指南：从入门到精通

一、快速开始

安装与启动

# 启动 Claude Code
claude

# 查看版本
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，添加规则：

所有对话使用中文回复

命令速查表

斜杠命令

其他命令&快捷键

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

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

二、Skills

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

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

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

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

方法二：手动安装

步骤：

示例：

# 创建 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

验证 Skills 安装

# 安装后验证
> /status

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

# 测试 Skill 功能（以 pptx 为例）
> 帮我创建一个演示文稿，主题是 AI 发展历程

创建自定义 Skill

你也可以创建自己的 Skill：

示例结构：

~/.claude/skills/my-custom-skill/
├── README.md # Skill 说明
├── instructions.md # Claude 使用指令
└── examples/ # 使用示例

三、核心命令详解

一、会话控制与对话管理

这些指令是你与 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

典型工作流：

/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”。

Skills – 技能扩展系统

功能： Skills 是 Claude Code 的扩展能力系统，提供专业领域的预置知识和工具。

Skills 与 Plugins 的区别：

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

使用场景：

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

四、配置与最佳实践

配置文件结构

# 全局配置（所有项目）
~/.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 调用必须有错误处理
– 敏感信息从环境变量读取