Claude Code 使用手册

# Claude Code 使用手册

完整的 Claude Code CLI 工具使用指南

# 目录

核心斜杠命令
文件操作命令
搜索命令
Git 操作命令
代码审查与优化
项目管理命令
自定义技能
快捷键指南
配置文件说明
MCP 服务器集成
IDE 集成方式
使用技巧与最佳实践
常见问题解答

# 核心斜杠命令

# 基础命令

命令	功能描述	示例
`/help`	显示所有可用的斜杠命令和简要说明	`/help`
`/status`	显示 Claude Code 当前状态和配置信息	`/status`
`/version`	显示 Claude Code 版本信息	`/version`
`/clear`	清除当前对话历史	`/clear`
`/exit`	退出 Claude Code	`/exit`

# 调试命令

命令	功能描述	示例
`/debug`	启用调试模式，显示详细的调试信息	`/debug`
`/trace`	显示命令执行追踪信息	`/trace`
`/log <level>`	设置日志级别（debug/info/warn/error）	`/log debug`

# 文件操作命令

# 读取与编辑

命令	功能描述	示例
`/read <file-path>`	读取文件内容（支持路径自动补全）	`/read src/app.ts`
`/edit <file-path>`	打开文件编辑器进行编辑	`/edit package.json`
`/write <file-path>`	创建新文件并写入内容	`/write new-file.ts`
`/cat <file-path>`	快速查看文件内容	`/cat .env`

# 目录操作

命令	功能描述	示例
`/ls [path]`	列出目录内容（默认当前目录）	`/ls src/`
`/tree [path]`	以树形结构显示目录	`/tree src/components`
`/pwd`	显示当前工作目录	`/pwd`
`/cd <path>`	切换工作目录	`/cd src`

# 搜索命令

# 文件搜索

命令	功能描述	示例
`/find <pattern>`	在文件名中搜索匹配的文件	`/find "*.tsx"`
`/glob <pattern>`	使用 glob 模式搜索文件	`/glob "*/.test.ts"`

# 内容搜索

命令	功能描述	示例
`/grep <pattern> [file-type]`	在文件内容中搜索匹配的文本	`/grep "TODO" --type ts`
`/search <term>`	全局搜索（文件名和内容）	`/search "useState"`
`/ripgrep <pattern>`	使用 ripgrep 进行高级搜索	`/ripgrep "^import.*React"`

# Git 操作命令

# 状态查看

命令	功能描述	示例
`/git status`	显示当前 Git 状态	`/git status`
`/git log`	显示 Git 提交历史	`/git log --oneline`
`/git branch`	显示分支列表	`/git branch -a`
`/git diff`	显示文件变更差异	`/git diff`

# Git 操作

命令	功能描述	示例
`/git add <file>`	添加文件到暂存区	`/git add .`
`/git commit -m "msg"`	创建 Git 提交	`/git commit -m "feat: add feature"`
`/git push`	推送到远程仓库	`/git push origin main`
`/git pull`	拉取远程更新	`/git pull`

# 代码审查与优化

# 代码审查

命令	功能描述	示例
`/review`	审查当前分支的更改	`/review`
`/security-review`	进行安全审查	`/security-review`
`/diff <branch>`	与指定分支进行差异对比	`/diff master`

# 代码优化

命令	功能描述	示例
`/refactor <file-path>`	重构指定的文件	`/refactor src/utils.ts`
`/optimize <file-path>`	优化指定的文件	`/optimize src/app.ts`
`/simplify`	审查并简化代码	`/simplify`
`/analyze <file-path>`	分析指定的文件或代码库	`/analyze src/`

# 项目管理命令

# 项目初始化

命令	功能描述	示例
`/init`	初始化新的 CLAUDE.md 文件	`/init`
`/project`	显示当前项目信息	`/project`
`/config`	查看和修改配置	`/config`

# 状态与报告

命令	功能描述	示例
`/insights`	生成 Claude Code 会话分析报告	`/insights`
`/report`	生成项目报告	`/report`

# 自定义技能

# `/show-task-tables`

根据任务ID查看任务对应的数据源和表列表信息。

/show-task-tables [task-id|all]

参数说明：

task-id - DTS 任务ID
all - 显示所有任务的数据源和表信息
无参数 - 默认显示所有任务

功能：

查询任务的基本信息（ID、名称、类型、状态）
获取源数据源和目标数据源信息
显示任务配置的表列表

示例：

/show-task-tables           # 显示所有任务
/show-task-tables all       # 显示所有任务详细信息
/show-task-tables 12345     # 显示任务ID为12345的信息

1
2
3

# `/update-config`

配置 Claude Code harness 通过 settings.json。

功能：

配置自动化行为（hooks）
设置权限（permissions）
配置环境变量（env）
设置钩子故障排除

使用场景：

设置"从现在开始当X时"这类自动化行为
配置命令执行前后的钩子
管理环境变量

# `/keybindings-help`

键盘快捷键和键绑定帮助。

功能：

自定义键盘快捷键
重新绑定按键
添加组合快捷键
修改 ~/.claude/keybindings.json

示例：

/keybindings-help           # 查看帮助
/keybindings rebind ctrl+s  # 重新绑定快捷键

1
2

# `/loop`

定期执行命令。

/loop [interval] [command]

参数说明：

interval - 时间间隔（支持 m=分钟, h=小时）
command - 要执行的命令或斜杠命令

示例：

/loop 5m /status            # 每5分钟检查状态
/loop 10m /git log          # 每10分钟查看Git日志
/loop 1h npm test           # 每小时运行测试

1
2
3

# `/batch`

大规模变更的批处理。

功能：

研究和规划大规模变更
在 5-30 个隔离的 worktree 代理中并行执行
每个代理自动创建一个 PR

使用场景：

跨多个文件的重构
批量修复代码问题
大规模代码更新

# `/claude-api`

构建、调试和优化 Claude API / Anthropic SDK 应用。

触发条件：

代码导入 anthropic 或 @anthropic-ai/sdk
用户要求使用 Claude API、Anthropic SDKs 或 Managed Agents

功能：

添加 Claude 功能
修改 Claude 功能
调试 Claude API 调用
优化 Claude API 使用

注意： 构建的应用应包含 prompt caching 以提高性能。

# `/debug`

启用当前会话的调试日志。

功能：

帮助诊断问题
显示详细的执行信息
追踪命令执行过程

# `/simplify`

代码简化审查。

功能：

检查变更代码的可重用性
检查代码质量和效率
修复发现的问题

# 快捷键指南

# 基本快捷键

快捷键	功能	说明
`Enter`	提交命令	执行当前输入的命令
`Ctrl+C`	取消操作	中断当前正在执行的命令
`Ctrl+D`	退出 Claude Code	退出程序
`Tab`	自动补全	补全路径、命令等

# 导航快捷键

快捷键	功能	说明
`Ctrl+L`	清屏	清除屏幕内容
`Ctrl+R`	反向搜索	在命令历史中搜索
`Ctrl+N`	下一个命令	浏览命令历史的下一个
`Ctrl+P`	上一个命令	浏览命令历史的上一个
`Ctrl+A`	行首	跳转到行首
`Ctrl+E`	行尾	跳转到行尾

# 编辑快捷键

快捷键	功能	说明
`Ctrl+S`	保存文件	保存当前编辑的文件
`Ctrl+Z`	撤销操作	撤销上一次操作
`Ctrl+Y`	重做操作	重做被撤销的操作
`Ctrl+K`	删除到行尾	删除光标到行尾的内容
`Ctrl+U`	删除到行首	删除光标到行首的内容

# 查找快捷键

快捷键	功能	说明
`Ctrl+F`	向前搜索	在当前内容中向前搜索
`Ctrl+G`	跳转到行	跳转到指定行号
`Ctrl+/`	切换注释	切换代码注释状态

# 系统快捷键

快捷键	功能	说明
`Ctrl+T`	新建标签页	打开新的标签页
`Ctrl+W`	关闭标签页	关闭当前标签页
`Ctrl+Tab`	切换标签页	在标签页之间切换

# 配置文件说明

# 配置文件位置

文件路径	作用域	用途
`~/.claude/settings.json`	全局	所有项目的通用配置
`.claude/settings.local.json`	项目	当前项目的特定配置
`.claude/keybindings.json`	全局	键盘快捷键绑定配置
`CLAUDE.md`	项目	项目文档和说明
`MEMORY.md`	项目	项目记忆和上下文信息

# 全局配置示例

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "your-token-here",
    "ANTHROPIC_BASE_URL": "https://api.anthropic.com",
    "API_TIMEOUT_MS": "120000",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  },
  "permissions": {
    "allow": [
      "Bash(cat:*)",
      "Bash(grep:*)",
      "Bash(find:*)",
      "Bash(ls:*)",
      "Bash(npm:*)"
    ]
  },
  "hooks": {
    "PreRead": ["run prettier check"],
    "PostEdit": ["run eslint fix"]
  }
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21

# 键绑定配置示例

{
  "bindings": {
    "ctrl+s": "save",
    "ctrl+p": "command-palette",
    "ctrl+shift+f": "format-document"
  }
}

1
2
3
4
5
6
7

# 环境变量说明

变量名	说明
`ANTHROPIC_AUTH_TOKEN`	Anthropic API 认证令牌
`ANTHROPIC_BASE_URL`	API 基础 URL
`API_TIMEOUT_MS`	API 请求超时时间（毫秒）
`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`	禁用非必要流量
`ANTHROPIC_DEFAULT_HAIKU_MODEL`	默认 Haiku 模型
`ANTHROPIC_DEFAULT_SONNET_MODEL`	默认 Sonnet 模型
`ANTHROPIC_DEFAULT_OPUS_MODEL`	默认 Opus 模型

# MCP 服务器集成

# 什么是 MCP

MCP (Model Context Protocol) 是一个协议，允许 Claude Code 与外部服务和工具集成。

# 配置 MCP 服务器

在 settings.json 中配置 MCP 服务器：

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-server-filesystem", "/path/to/allowed/files"]
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-server-github"]
    }
  }
}

1
2
3
4
5
6
7
8
9
10
11
12

# 常用 MCP 服务器

服务器	功能	安装命令
`filesystem`	文件系统访问	`npx @anthropic/mcp-server-filesystem`
`github`	GitHub 集成	`npx @anthropic/mcp-server-github`
`postgres`	PostgreSQL 数据库	`npx @anthropic/mcp-server-postgres`
`sqlite`	SQLite 数据库	`npx @anthropic/mcp-server-sqlite`
`brave-search`	Brave 搜索	`npx @anthropic/mcp-server-brave-search`

# IDE 集成方式

# VS Code 集成

安装步骤：

在 VS Code 扩展市场搜索 "Claude Code"
安装官方扩展
配置 API 密钥
使用 Ctrl+Shift+P 打开命令面板
搜索 "Claude Code" 相关命令

常用命令：

Claude Code: Start New Session - 开始新会话
Claude Code: Attach to Session - 附加到现有会话
Claude Code: Quick Chat - 快速聊天

# JetBrains 集成

支持的 IDE：

IntelliJ IDEA
PyCharm
WebStorm
PhpStorm
CLion
GoLand
Rider

安装步骤：

在插件市场搜索 "Claude Code"
安装插件
配置设置
使用 Alt+ 或自定义快捷键激活

# 终端集成

Claude Code 可以直接在终端中使用：

# 安装
npm install -g @anthropic-ai/claude-code

# 启动
claude

# 在特定目录启动
claude /path/to/project

1
2
3
4
5
6
7
8

# 使用技巧与最佳实践

# 1. 项目初始化流程

# 1. 创建项目文档
/init

# 2. 查看项目信息
/project

# 3. 配置状态行
/statusline

# 4. 更新配置
/update-config

1
2
3
4
5
6
7
8
9
10
11

# 2. 代码审查流程

# 1. 查看当前状态
/git status

# 2. 启用调试模式
/debug

# 3. 进行代码审查
/review

# 4. 安全审查
/security-review

# 5. 简化代码
/simplify

1
2
3
4
5
6
7
8
9
10
11
12
13
14

# 3. 文件操作技巧

# 读取文件
/read /path/to/file.ts

# 搜索文件内容
/grep "function" --type ts

# 查找文件
/find "*.tsx"

# 分析代码
/analyze src/

1
2
3
4
5
6
7
8
9
10
11

# 4. 定时任务设置

# 每5分钟检查状态
/loop 5m /status

# 每10分钟同步Git
/loop 10m /git pull

# 每小时运行测试
/loop 1h npm test

1
2
3
4
5
6
7
8

# 5. 批量处理

# 批量重构
/batch refactor "old-pattern" "new-pattern"

# 批量添加错误处理
/batch add-error-handling --async-only

1
2
3
4
5

# 6. 配置管理

# 更新配置
/update-config

# 查看键绑定
/keybindings-help

# 调试问题
/debug

1
2
3
4
5
6
7
8

# 7. 高级搜索技巧

# 多条件搜索
/grep "TODO|FIXME" --type ts --ignore-case

# 上下文搜索
/grep "function" -A 5 -B 5

# 递归搜索
/grep "import" --recursive src/

1
2
3
4
5
6
7
8

# 常见问题解答

# Q1: 如何更改默认模型？

在 settings.json 中设置环境变量：

{
  "env": {
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-6",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-6"
  }
}

1
2
3
4
5
6

# Q2: 如何配置权限？

在 settings.json 中配置权限：

{
  "permissions": {
    "allow": [
      "Bash(npm:*)",
      "Bash(git:*)",
      "Read(*)"
    ],
    "deny": [
      "Bash(rm:*)"
    ]
  }
}

1
2
3
4
5
6
7
8
9
10
11
12

# Q3: 如何使用钩子（hooks）？

在 settings.json 中配置：

{
  "hooks": {
    "PreRead": ["run prettier --check"],
    "PostEdit": ["run eslint --fix"],
    "PreCommit": ["run test"]
  }
}

1
2
3
4
5
6
7

# Q4: 如何提高响应速度？

使用 prompt caching
减少上下文大小
使用更快的模型（Haiku）
禁用非必要流量

# Q5: 如何调试问题？

# 启用调试模式
/debug

# 查看日志
/log debug

# 追踪执行
/trace

1
2
3
4
5
6
7
8

# Q6: 如何自定义快捷键？

# 查看当前绑定
/keybindings-help

# 编辑配置文件
/edit ~/.claude/keybindings.json

1
2
3
4
5

# 版本信息

Claude Code 版本: 基于 Claude 4.6 / 4.5
文档更新日期: 2026年4月12日
适用平台: macOS, Linux, Windows

# 获取帮助

官方文档: https://docs.anthropic.com
GitHub Issues: https://github.com/anthropics/claude-code/issues
快捷命令: /help

本文档由 Claude Code 自动生成

编辑

#Claude #AI #CLI #开发工具

上次更新: 2026/04/12, 23:32:01

← AI客户端安装流程 Claude Code 插件安装与使用指南→

Claude Code 使用手册

# Claude Code 使用手册

# 目录

# 核心斜杠命令

# 基础命令

# 调试命令

# 文件操作命令

# 读取与编辑

# 目录操作

# 搜索命令

# 文件搜索

# 内容搜索

# Git 操作命令

# 状态查看

# Git 操作

# 代码审查与优化

# 代码审查

# 代码优化

# 项目管理命令

# 项目初始化

# 状态与报告

# 自定义技能

# /show-task-tables

# /update-config

# /keybindings-help

# /loop

# /batch

# /claude-api

# /debug

# /simplify

# 快捷键指南

# 基本快捷键

# 导航快捷键

# 编辑快捷键

# 查找快捷键

# 系统快捷键

# 配置文件说明

# 配置文件位置

# 全局配置示例

# 键绑定配置示例

# 环境变量说明

# MCP 服务器集成

# 什么是 MCP

# 配置 MCP 服务器

# 常用 MCP 服务器

# IDE 集成方式

# VS Code 集成

# JetBrains 集成

# 终端集成

# 使用技巧与最佳实践

# 1. 项目初始化流程

# 2. 代码审查流程

# 3. 文件操作技巧

# 4. 定时任务设置

# 5. 批量处理

# 6. 配置管理

# 7. 高级搜索技巧

# 常见问题解答

# Q1: 如何更改默认模型？

# Q2: 如何配置权限？

# Q3: 如何使用钩子（hooks）？

# Q4: 如何提高响应速度？

# Q5: 如何调试问题？

# Q6: 如何自定义快捷键？

# 版本信息

# 获取帮助

# `/show-task-tables`

# `/update-config`

# `/keybindings-help`

# `/loop`

# `/batch`

# `/claude-api`

# `/debug`

# `/simplify`