solar:terminal-bold-duotone

Claude Code 是 Anthropic 官方推出的 AI 编程助手,以命令行界面(CLI)运行,支持代码搜索、读取、编辑、文件创建、执行 Shell 命令等能力,直接与 Claude 模型交互,适合开发者在终端中完成编程任务。

Slash 命令(斜杠命令)

在 Claude Code 对话中输入 / 开头即可触发。

基础命令

命令功能使用案例
/help显示帮助信息/help — 列出所有可用命令及说明
/clear清空当前对话历史长对话后觉得混乱,输入 /clear 重新开始,不删除已生成的文件
/exit / /quit退出 Claude Code完成工作后输入 /exit 安全退出会话

模型与设置

命令功能使用案例
/config查看和修改配置输入 /config 弹出配置面板,修改默认模型、权限、环境变量等
/model切换使用的模型/model sonnet — 切换到 Sonnet 模型;/model opus — 切换到更强大的 Opus 模型处理复杂任务
/theme切换界面主题/theme dark — 切换到暗黑模式;/theme light — 切换到亮色模式
/verbose切换详细输出模式/verbose — 开启后显示工具调用的详细参数和返回结果,适合调试

上下文与 Token

命令功能使用案例
/context查看上下文使用量长对话后输入 /context 查看已用了多少 Token,决定是否压缩
/compact压缩对话上下文/compact — 将早期对话压缩摘要,释放空间同时保留关键信息
/cost查看 API 费用统计/cost — 查看当前会话花了多少钱,监控预算
/stats显示会话统计信息/stats — 显示 Token 使用、工具调用次数等综合统计

编辑器与模式

命令功能使用案例
/vim切换 Vim 编辑模式/vim — Vim 用户开启后可以用 Vim 键位编辑输入
/keys查看快捷键绑定/keys — 列出所有可用快捷键
/output控制输出格式/output compact — 精简输出,减少冗余信息

工具与权限

命令功能使用案例
/tools查看可用工具列表/tools — 列出 Read、Write、Edit、Bash 等所有内置工具
/trust管理工具权限/trust — 设置某些工具自动允许,无需每次确认
/hooks查看 Hooks 配置/hooks — 查看当前配置的钩子(工具调用前后自动触发的命令)

项目规则与 MCP

命令功能使用案例
/rules查看项目级规则/rules — 显示当前加载的 CLAUDE.md 规则文件内容
/mcp管理 MCP 服务器/mcp — 查看、添加、删除 Model Context Protocol 服务器连接
/composer打开 Composer 模式/composer — 进入多文件编辑界面,可同时对多个文件进行修改

撤销与回滚

Claude Code 本身没有内置的 /undo/rollback 命令,但可以通过以下方式实现撤销:

用 Git 回滚文件变更(推荐)

Claude Code 对文件的修改都是普通文件变更,可以通过 Git 回滚:

1
2
3
4
5
6
7
8
# 撤销未暂存的文件修改
! git restore 文件名
# 撤销未暂存的所有修改
! git restore .
# 撤销已暂存的文件
! git restore --staged 文件名
# 回退上一次 Claude Code 的提交
! git reset --soft HEAD~1
案例

Claude Code 修改了 main.py 但改错了,立即执行 ! git restore main.py 即可恢复。

对话层面的撤销

`/compact` — 无法撤销,但可以压缩上下文释放空间
`/clear` — 不可逆操作,清空后无法恢复对话历史
Claude 的代码编辑 — 如果你不满意,直接回复"恢复回去"或"撤销刚才的修改",Claude 会重新编辑文件

核心原则:Claude Code 没有 Ctrl+Z,Git 就是你的撤销按钮。
在让 Claude Code 做重大修改前先提交:

1
2
3
4
5
6
# 修改前创建快照
! git add . && git commit -m "before refactor"
# 改完后检查 diff
! git diff
# 不满意就回滚
! git checkout HEAD -- .

Shell 命令交互

使用 ! 前缀可在 Claude Code 中直接执行 Shell 命令:

1
2
3
4
5
! ls -la                    # 列出当前目录文件
! git status # 查看 Git 状态
! npm install # 安装依赖
! curl -s https://api.example.com/data # 调用 API
! cat /etc/hosts # 查看系统文件

可用工具(Tools)

文件操作

工具功能使用案例
Read读取文件内容读取 src/index.ts 第 10-20 行:Read → src/index.ts, offset:10, limit:10
Write写入/创建文件创建新文件 Write → src/utils.ts,写入完整的 TypeScript 代码
Edit精确替换字符串function foo() 改为 function bar():指定 file_pathold_stringnew_string
Glob按文件名模式搜索搜索所有 TSX 文件:Glob → "**/*.tsx"
NotebookEdit编辑 Jupyter 笔记本替换单元格代码:NotebookEdit → notebook.ipynb, cell_id:"abc", new_source:"print('hello')"

代码搜索

工具功能使用案例
Grep按内容搜索代码搜索所有 console.logGrep → "console\.log", glob:"*.ts", output_mode:"content"

终端执行

工具功能使用案例
Bash执行 Shell 命令运行构建:Bash → npm run build;后台运行:Bash → npm start, run_in_background:true

Git 操作

通过 Bash 工具执行:

1
2
3
4
5
6
7
8
! git status                    # 查看当前状态
! git diff # 查看未提交的变更
! git add src/main.py # 添加指定文件
! git commit -m "fix: 修复 bug" # 提交
! git push # 推送到远程
! git log --oneline -10 # 查看最近 10 条提交
! git checkout -b feature/auth # 创建并切换分支
! git merge main # 合并 main 分支

键盘快捷键

Ctrl+C
中断当前操作
Claude 正在执行一个很慢的命令,按 Ctrl+C 中止。

Ctrl+D
退出 Claude Code
结束工作,按 Ctrl+D 等同于 /exit。

Tab
自动补全
输入 /co 后按 Tab,自动补全为 /compact/config

↑ / ↓
浏览历史输入
按 ↑ 快速翻到之前输入的命令,避免重复输入。


Agent(子代理)

Claude Code 支持启动专门的子代理处理复杂任务:

子代理类型

子代理类型功能使用案例
general-purpose通用代理“帮我完成数据库迁移、API 更新和测试修改这一系列任务”
Explore快速探索代码库“搜索项目中所有使用了 localStorage 的文件”
Plan软件架构代理“帮我设计一个用户认证系统的实现方案,需要哪些模块和接口”
claude-code-guide查询文档“Claude Code 支持哪些 MCP 服务器?怎么配置?”
案例

同时启动多个 Explore 代理并行搜索:代理 1 搜索所有 API 路由定义、代理 2 搜索所有数据库模型、代理 3 搜索所有前端组件中的 API 调用。


配置文件

配置文件位于 settings.json

配置示例

1
2
3
4
5
6
7
8
9
{
"permissions": {
"allow": ["Read", "Grep", "Glob"],
"deny": ["Bash"]
},
"env": {
"API_KEY": "your-key"
}
}
案例

只读模式下,允许 Read/Grep/Glob,禁止 Bash 执行任何命令。

通过 `/config` 命令可弹出交互界面,可视化修改配置。

Hooks(钩子)

在特定事件时自动触发 Shell 命令。

支持的事件

工具调用前(PreToolUse)
工具调用后(PostToolUse)
对话开始/结束

示例

1
2
3
4
5
6
7
{
"hooks": {
"PostToolUse": {
"Bash": "git diff --stat"
}
}
}
案例

每次 Claude Code 编辑文件后自动运行 git diff 查看变更。


最佳实践

用专用工具替代 Shell

不推荐:`! cat file.txt` 或 `! grep -r pattern src/`
推荐:使用内置 `Read → file.txt` 或 `Grep → pattern in src/`
内置工具提供更好的用户体验,操作更便于审查。

管理上下文与费用

查看用量:`/context`
超过 70% 时压缩:`/compact`
检查费用:`/cost`

项目级规则

.claude/CLAUDE.md 中定义规则,每次对话自动加载:

1
2
3
4
# 本项目规则
- 使用 TypeScript 严格模式
- 所有 API 响应必须有错误处理
- 注释用中文

常见问题

Claude Code 和本地 Claude 有什么区别

Claude Code 是运行在终端的独立应用,专门面向编程任务,拥有文件读写、代码搜索、Shell 执行等专用工具。网页版 Claude 是通用对话界面。

如何更新 Claude Code

1
npm update -g @anthropic-ai/claude-code

支持哪些模型

Claude Sonnet、Claude Opus、Claude Haiku 等,用 /model 命令切换。

如何离线使用

Claude Code 需要联网调用 API,暂不支持离线使用。

有没有撤销功能

Claude Code 没有内置 /undo 命令。代码变更通过 Git 回滚(! git restore 文件),对话层面的操作(如 /clear)不可逆。最安全的方式是在重大操作前先用 Git 创建快照。


参考资料