Claude Code 命令完整文档
📚 目录
基础命令
1. claude
启动 Claude Code 的交互式 REPL(Read-Eval-Print Loop)环境,进入对话模式。
语法:
bash
claude
说明:
- 启动后会进入交互式命令行界面
- 可以持续与 Claude Code 对话
- 支持多轮对话,保留上下文信息
- 输入
exit或quit退出
示例:
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_modules、target等编译产物目录
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 模式 |