Claude Code 命令完整文档

Claude Code 命令完整文档

📚 目录


基础命令

1. claude

启动 Claude Code 的交互式 REPL(Read-Eval-Print Loop)环境,进入对话模式。

语法

bash 复制代码
claude

说明

  • 启动后会进入交互式命令行界面
  • 可以持续与 Claude Code 对话
  • 支持多轮对话,保留上下文信息
  • 输入 exitquit 退出

示例

bash 复制代码
$ claude
> 你好,我想了解一下这个项目的结构
[Claude Code 会分析项目并给出回答]
> 帮我优化这个函数的性能
[Claude Code 提供优化建议]
> exit

2. claude "查询内容"

使用初始提示启动 REPL,Claude Code 会根据提供的提示开始会话。

语法

bash 复制代码
claude "查询内容"

说明

  • 可以立即开始对话,无需等待进入交互模式
  • 适合快速查询场景

示例

bash 复制代码
# 询问项目结构
claude "解释这个Spring Boot项目的架构"

# 分析代码
claude "分析 UserController 类的功能"

# 生成代码
claude "帮我创建一个 RESTful API 控制器"

3. claude -p "查询内容" / claude --prompt "查询内容"

运行一次性查询,处理完成后直接退出,不进入交互模式。

语法

bash 复制代码
claude -p "查询内容"
claude --prompt "查询内容"

说明

  • -p--prompt 功能相同,可以互换使用
  • 适合脚本调用或自动化场景
  • 处理完查询后立即退出,不保留会话

示例

bash 复制代码
# 一次性查询
claude -p "检查代码中的语法错误"

# 在脚本中使用
claude -p "生成单元测试" > test_output.txt

4. cat 文件 | claude -p "查询内容"

通过管道(pipe)将文件内容传递给 Claude Code 处理。

语法

bash 复制代码
cat <文件路径> | claude -p "查询内容"

说明

  • 利用 Unix/Linux 的管道机制传递数据
  • 适合处理大文件或日志文件
  • Claude Code 会基于传入的内容进行分析

示例

bash 复制代码
# 分析日志文件
cat app.log | claude -p "找出错误信息并总结"

# 分析代码文件
cat UserService.java | claude -p "解释这个类的功能"

# 分析多个文件
cat *.java | claude -p "检查代码风格一致性"

Windows 等效命令

cmd 复制代码
type app.log | claude -p "分析错误"

会话管理

5. claude -c / claude --continue

继续最近的对话,会话上下文得以保留。

语法

bash 复制代码
claude -c
claude --continue

说明

  • 恢复最近一次对话的上下文
  • 适合在中断后继续之前的对话
  • 保留之前的对话历史

示例

bash 复制代码
# 之前的对话
$ claude
> 帮我重构 UserService 类
[Claude Code 提供重构方案]
> exit

# 继续对话
$ claude -c
> 按照你的建议,我已经修改了代码,请检查一下
[Claude Code 会基于之前的上下文进行检查]

6. claude -c -p "查询内容"

在继续最近对话的基础上,运行新的查询。

语法

bash 复制代码
claude -c -p "查询内容"

说明

  • 结合了 -c-p 的功能
  • 恢复上下文但不进入交互模式
  • 适合在脚本中继续之前的对话

示例

bash 复制代码
# 一次性继续对话并查询
claude -c -p "刚才的重构是否完整?"

7. claude -r "<会话ID>" "查询内容" / claude --resume "<会话ID>" "查询内容"

通过指定会话 ID 恢复之前的会话,并运行新的查询。

语法

bash 复制代码
claude -r "<会话ID>" "查询内容"
claude --resume "<会话ID>" "查询内容"

说明

  • -r--resume 功能相同
  • 需要提供会话 ID(通常在使用过程中会显示)
  • 可以恢复任意历史会话

示例

bash 复制代码
# 恢复指定会话
claude -r "abc123def456" "继续完成之前的任务"

# 在脚本中使用
claude -r "$SESSION_ID" "检查代码质量"

如何获取会话 ID

  • 在交互式会话中,会话 ID 通常会显示在提示符中
  • 查看历史会话列表(如果支持)

配置管理

8. claude config

查看或修改 Claude Code 的配置设置。

语法

bash 复制代码
# 查看所有配置
claude config

# 查看特定配置项
claude config get <配置项>

# 设置配置项(当前会话)
claude config set <配置项> <值>

# 设置全局配置项
claude config set --global <配置项> <值>

# 删除配置项
claude config unset <配置项>

常用配置项

配置项 说明 可选值 示例
theme 界面主题 dark, light, auto claude config set theme dark
model 使用的模型 claude-3-5-sonnet, claude-3-opus claude config set model claude-3-5-sonnet
max-tokens 最大令牌数 数字 claude config set max-tokens 4096
temperature 温度参数 0.0-1.0 claude config set temperature 0.7
locale 语言设置 zh-CN, en-US claude config set locale zh-CN

示例

bash 复制代码
# 查看当前所有配置
claude config

# 查看主题设置
claude config get theme

# 设置暗色主题(仅当前会话)
claude config set theme dark

# 全局设置暗色主题
claude config set --global theme dark

# 设置使用中文
claude config set locale zh-CN

# 删除某个配置项
claude config unset theme

配置文件位置

  • 全局配置:~/.claude/config.json%USERPROFILE%\.claude\config.json(Windows)
  • 项目配置:.claude/config.json(项目根目录)

9. claude update

更新 Claude Code 到最新版本。

语法

bash 复制代码
claude update

说明

  • 检查并下载最新版本
  • 可能需要管理员权限
  • 更新后建议重启终端

示例

bash 复制代码
# 更新到最新版本
claude update

# 可能需要管理员权限(macOS/Linux)
sudo claude update

斜杠命令(交互式命令)

以下命令需要在交互式会话中使用(即先执行 claude 进入交互模式)。

10. /add-dir <目录路径>

将指定目录添加到 Claude Code 的上下文中,方便其访问和理解该目录下的文件。

语法

bash 复制代码
/add-dir <目录路径>

说明

  • 必须在交互式会话中使用
  • 添加后,Claude Code 可以更好地理解该目录下的代码
  • 支持相对路径和绝对路径
  • 可以多次使用添加多个目录

示例

shell 复制代码
> /add-dir src/main/java
已添加目录: src/main/java

> /add-dir ./common-starter
已添加目录: ./common-starter

> /add-dir C:\Users\dale\Desktop\项目\src
已添加目录: C:\Users\dale\Desktop\项目\src

使用场景

  • 让 Claude Code 了解项目结构
  • 添加特定模块进行分析
  • 限制 Claude Code 的关注范围

注意事项

  • 添加大目录可能会消耗更多令牌
  • 建议只添加相关的源代码目录,避免添加 node_modulestarget 等编译产物目录

11. /cost

显示当前会话的令牌使用统计,帮助您了解资源消耗情况。

语法

bash 复制代码
/cost

说明

  • 显示已使用的输入令牌数
  • 显示已使用的输出令牌数
  • 显示总令牌数
  • 可能显示预估费用(如果有)

示例输出

makefile 复制代码
> /cost
当前会话令牌使用统计:
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
输入令牌: 2,345
输出令牌: 1,567
总令牌数: 3,912
预估费用: $0.012
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

使用场景

  • 监控 API 使用量
  • 优化提示词以减少令牌消耗
  • 控制使用成本

12. /config

在交互式会话中查看或修改当前会话的配置设置。

语法

bash 复制代码
# 查看配置
/config

# 设置配置(在交互模式中直接输入)
/config theme dark

说明

  • 在交互式会话中快速修改配置
  • 配置仅对当前会话有效
  • 等同于 claude config 的交互式版本

示例

markdown 复制代码
> /config
当前配置:
- theme: light
- model: claude-3-5-sonnet
- locale: zh-CN

> /config theme dark
已设置主题为: dark

13. /clear

清除当前对话历史,开始新的会话。

语法

arduino 复制代码
/clear

说明

  • 清除当前会话的所有历史记录
  • 重置上下文
  • 不退出交互模式,继续对话

示例

shell 复制代码
> 帮我分析 UserService 类
[Claude Code 分析...]

> /clear
对话历史已清除

> 现在帮我分析 OrderService 类
[Claude Code 开始新的分析,不受之前影响]

使用场景

  • 切换不同的任务主题
  • 避免上下文混淆
  • 重新开始对话

14. /help

获取可用命令的帮助信息。

语法

bash 复制代码
/help
/help <命令名>

说明

  • 显示所有可用命令列表
  • 可以查看特定命令的详细说明

示例

bash 复制代码
> /help
可用命令:
  /add-dir    添加目录到上下文
  /cost       显示令牌使用统计
  /config     查看/修改配置
  /clear      清除对话历史
  /help       显示帮助信息
  ...

> /help add-dir
/add-dir <目录路径>
将指定目录添加到上下文中

15. /init

使用 CLAUDE.md 指南初始化项目,生成项目说明文件。

语法

bash 复制代码
/init

说明

  • 在项目根目录生成或更新 CLAUDE.md 文件
  • 基于当前项目结构生成项目说明
  • 帮助 Claude Code 更好地理解项目

示例

shell 复制代码
> /init
正在分析项目结构...
已生成 CLAUDE.md 文件

> /init
CLAUDE.md 已存在,是否更新?(y/n)

生成的 CLAUDE.md 通常包含

  • 项目概述
  • 技术栈
  • 项目结构
  • 开发规范
  • 常用命令

16. /login

登录您的 Anthropic 账户。

语法

bash 复制代码
/login

说明

  • 提示输入 API Key 或通过浏览器登录
  • 保存认证信息以便后续使用
  • 必需步骤才能使用 Claude Code

示例

shell 复制代码
> /login
请输入您的 API Key: sk-ant-...
登录成功!

或

> /login
正在打开浏览器进行登录...
请在浏览器中完成登录
登录成功!

17. /logout

登出当前 Anthropic 账户。

语法

bash 复制代码
/logout

说明

  • 清除本地保存的认证信息
  • 下次使用时需要重新登录

示例

shell 复制代码
> /logout
已登出

18. /memory

编辑 CLAUDE.md 记忆文件,管理 Claude Code 的记忆内容。

语法

bash 复制代码
/memory

说明

  • 打开 CLAUDE.md 文件进行编辑
  • 可以添加项目特定的知识
  • Claude Code 会在后续对话中参考这些记忆

示例

shell 复制代码
> /memory
正在打开编辑器...
[编辑 CLAUDE.md 文件]
保存后,记忆已更新

19. /review

请求代码审查,Claude Code 会对当前代码进行评审并提供反馈。

语法

bash 复制代码
/review
/review <文件路径>

说明

  • 分析代码质量、安全性、性能等
  • 提供改进建议
  • 可以指定特定文件或目录

示例

shell 复制代码
> /review
正在审查当前代码...
[Claude Code 提供审查意见]

> /review UserService.java
正在审查 UserService.java...
[针对该文件的审查意见]

审查内容通常包括

  • 代码风格
  • 潜在 bug
  • 性能优化建议
  • 安全漏洞
  • 最佳实践建议

20. /terminal-setup

安装 Shift+Enter 键绑定,用于在终端中换行(仅限 iTerm2 和 VSCode)。

语法

arduino 复制代码
/terminal-setup

说明

  • 配置终端快捷键
  • 支持 iTerm2(macOS)和 VSCode 集成终端
  • 方便输入多行文本

示例

shell 复制代码
> /terminal-setup
正在配置终端...
✓ Shift+Enter 键绑定已安装
现在可以使用 Shift+Enter 进行换行

21. /vim

进入 Vim 模式,允许在插入和命令模式之间切换。

语法

bash 复制代码
/vim

说明

  • 启用 Vim 键绑定
  • 适合熟悉 Vim 的用户
  • 提供更好的文本编辑体验

示例

shell 复制代码
> /vim
已启用 Vim 模式
按 ESC 进入命令模式,按 i 进入插入模式

常用 Vim 命令

  • i: 进入插入模式
  • ESC: 退出插入模式
  • :w: 保存(如果适用)
  • :q: 退出(如果适用)

高级功能

22. claude mcp

配置模型上下文协议(Model Context Protocol)服务器,允许 Claude Code 连接外部数据源或工具。

语法

bash 复制代码
# 查看 MCP 配置
claude mcp

# 添加 MCP 服务器
claude mcp add <服务器名称> <配置>

# 移除 MCP 服务器
claude mcp remove <服务器名称>

# 列出所有 MCP 服务器
claude mcp list

说明

  • MCP 允许 Claude Code 连接数据库、API、文件系统等
  • 扩展 Claude Code 的能力
  • 适合企业级集成场景

示例

bash 复制代码
# 查看当前 MCP 配置
claude mcp

# 添加数据库连接
claude mcp add database "postgresql://localhost:5432/mydb"

# 列出所有服务器
claude mcp list

使用示例

示例 1: 快速代码审查

bash 复制代码
# 一次性审查代码
claude -p "审查 UserService.java 的代码质量" < UserService.java

示例 2: 持续开发会话

bash 复制代码
# 开始会话
claude
> /add-dir src/main/java
> 帮我重构 UserController 类

# 中断后继续
claude -c
> 按照你的建议修改后,请检查一下

示例 3: 批量文件处理

bash 复制代码
# 分析多个文件
for file in *.java; do
  echo "=== $file ===" >> analysis.txt
  cat "$file" | claude -p "分析这个文件" >> analysis.txt
done

示例 4: 配置和使用

bash 复制代码
# 配置
claude config set --global theme dark
claude config set locale zh-CN

# 使用
claude
> /config
> 用中文解释这个项目的架构

常见问题

Q1: 如何查看所有可用命令?

bash 复制代码
claude --help
# 或
claude -h

在交互模式中:

bash 复制代码
/help

Q2: 如何重置配置?

bash 复制代码
# 删除配置文件
rm ~/.claude/config.json  # macOS/Linux
del %USERPROFILE%\.claude\config.json  # Windows

# 重新配置
claude config set theme auto

Q3: 令牌使用过多怎么办?

  • 使用 /cost 监控使用情况
  • 优化提示词,避免冗余内容
  • 使用 /clear 清除不必要的历史
  • 限制 /add-dir 添加的目录大小

Q4: 如何在脚本中使用?

bash 复制代码
#!/bin/bash
RESULT=$(claude -p "分析代码质量" < code.java)
echo "$RESULT" > result.txt

Q5: 支持哪些操作系统?

  • macOS
  • Linux
  • Windows (通过 WSL 或原生支持)

Q6: 如何更新到最新版本?

bash 复制代码
claude update

如果失败,可能需要:

  • 检查网络连接
  • 使用管理员权限
  • 手动下载最新版本

命令速查表

命令 类型 说明
claude 基础 启动交互式会话
claude -p "查询" 基础 一次性查询
claude -c 会话 继续最近对话
claude -r "ID" "查询" 会话 恢复指定会话
claude config 配置 配置管理
claude update 配置 更新软件
/add-dir 交互 添加目录
/cost 交互 查看令牌统计
/config 交互 查看/修改配置
/clear 交互 清除历史
/help 交互 显示帮助
/init 交互 初始化项目
/login 交互 登录账户
/logout 交互 登出账户
/memory 交互 编辑记忆文件
/review 交互 代码审查
/vim 交互 启用 Vim 模式
相关推荐
wjcroom2 小时前
web版进销存的设计到实现一
前端
无知的前端2 小时前
Flutter常见问题以及解决方案
前端·flutter·dart
BD_Marathon2 小时前
Vue3_Vite构建工程化前端项目
前端
武清伯MVP2 小时前
CSS Grid布局全解析:从基础到实战的二维布局方案
前端·css·grid
xfq2 小时前
typescript泛型枚举以及NaN传染处理
前端·typescript
ErMao2 小时前
开始搭建第一个React项目吧~
前端·react.js
Yanni4Night2 小时前
JavaScript打包器大奖赛:谁是构建速度之王? 🚀
前端·javascript
默海笑3 小时前
VUE后台管理系统:项目架构之搭建Layout架构解决方案与实现
前端·javascript·vue.js
咸鱼加辣3 小时前
【前端脚手架】node
前端