Claude Code 入门指南
一、上下文管理
/compact— 局部压缩上下文 当对话过长、token 即将耗尽时，Claude Code 会自动提醒压缩。你也可以手动触发，将历史对话压缩为摘要，释放上下文空间。建议在长 session 中主动使用，避免被动截断丢失关键信息。
例：/compact 保留核心业务逻辑，移除不重要的辅助和测试相关逻辑
/context— 上下文用量监控 实时查看当前会话已用 token 数、剩余 token 数、缓存命中率等指标。建议每次执行大操作前先/context看一眼，心里有数。
例：context 查看当前上下文体积，超过一定空间则使用compact 清理
-
/cost— 费用统计 查看当前会话和累计的 API 费用。适合需要控制成本的用户。 -
/btw（by the way）— 临时提问不占上下文 用法：/btw 那个配置文件叫什么名字来着？。这个命令启动一个独立的轻量问答，不会污染当前 session 的上下文。非常适合在主流程中突然想到的零碎问题。
二、IDE 与 Shell 集成
-
/ide— 连接 IDE 将 Claude Code 连接到 VS Code / JetBrains 等 IDE。连接后：- IDE 中选中的代码行数会回显到 Claude Code
- Claude Code 可以直接操作 IDE 中打开的文件
- 配合
@file引用，定位代码效率极高
-
!（叹号）— 命令行中执行 shell 命令 用法：在对话中输入! <command>，比如! npm test。Claude Code 会执行该命令并将输出纳入上下文分析。和 Bash 工具调用的区别是：!执行结果直接显示在对话中，适合你主动想让它分析某条命令输出时使用。 -
@文件路径— 引用文件 在对话中用@src/App.tsx引用文件，Claude Code 会自动读取该文件内容作为上下文。支持通配符和目录引用。
三、配置与模型
-
/model— 查看并切换模型 查看当前使用的模型，可以切换到其他可用模型（如 Opus、Sonnet、Haiku 等）。切换后会自动保存为默认设置。 -
/config— 配置管理 修改 Claude Code 的各项配置：主题、模型、权限、环境变量等。 -
/init— 初始化项目 CLAUDE.md 为当前项目生成 CLAUDE.md 文件，记录项目结构、技术栈、编码规范等。这是让 Claude Code 理解项目的最佳方式，强烈建议每个项目都做一次。 -
/theme— 主题设置 切换终端的显示主题（dark/light 等）。 -
/thinking— 思维链模式开关 开启/关闭 Claude 的深度思考（extended thinking）模式。复杂逻辑任务建议开启，简单任务关闭以节省 token。 -
/output-style— 输出风格 调整 Claude 的回复风格：默认、简洁、详细等。 -
/statusline— 状态栏配置 定制终端底部的状态栏显示内容。 -
/permissions— 权限管理 管理哪些工具/操作需要用户确认（如 Bash 执行、文件写入等）。可以按项目或全局设置。
四、代码审查与质量
-
/review— PR 审查 对当前分支的改动进行代码审查，输出问题清单和改进建议。 -
/simplify— 简化代码 等同于/code-review --fix，审查当前 diff 并自动应用修复建议。 -
/security-review— 安全审查 对当前分支的改动进行安全审查，检查潜在的安全漏洞。 -
/verify— 验证改动 启动项目并验证代码改动是否实际生效，通过真实运行来确认功能正确性。
五、自动化与循环
-
/loop— 循环执行 用法：/loop 5m /review。每隔指定时间自动执行某个命令或提示词。适合持续监控、定期检查等场景。 -
/run— 启动项目 启动并运行当前项目，可以通过浏览器或其他方式验证功能。 -
/cron— 定时任务 调度定时任务，支持一次性提醒和周期性任务。比/loop更持久，可以跨 session 保留。
六、会话管理
-
/clear— 清空对话 清空当前会话历史，开始全新的对话。相当于”重启”。 -
/resume— 恢复会话 恢复之前中断的会话，可以按编号或时间选择。 -
/export— 导出对话 将当前会话导出为文件（Markdown / JSON 等格式），方便存档或分享。 -
/login//logout— 账号登录/登出 管理 Claude Code 的 API 账号认证。 -
/upgrade— 升级版本 升级 Claude Code 到最新版本。 -
/doctor— 诊断 检查 Claude Code 的运行环境是否正常（Node 版本、网络连接、配置合法性等）。
七、高级功能
-
/mcp— MCP 服务器管理 管理 MCP（Model Context Protocol）服务器，用于扩展 Claude Code 的能力（如连接数据库、外部 API 等）。 -
/agents— 子代理管理 管理子代理的配置和行为。 -
/skills— 技能管理 管理自定义技能（skills），即可以在对话中通过/skill-name调用的预设能力。 -
/hooks— 钩子管理 配置事件钩子（如对话开始前、文件保存后、对话结束后触发的脚本）。 -
/memory— 记忆管理 管理 Claude Code 的持久化记忆系统，让 Claude 在不同 session 之间记住你的偏好和项目信息。 -
/add-dir— 添加工作目录 将额外目录添加到当前工作空间，让 Claude Code 可以访问多个项目目录。
八、快捷键
| 快捷键 | 作用 |
|---|---|
Ctrl+C |
中断当前生成 / 退出当前操作 |
Ctrl+D |
退出 Claude Code |
Ctrl+O |
在编辑器中打开当前代码 |
Ctrl+R |
搜索历史命令 |
Shift+Enter |
在输入框中换行（默认 Enter 是发送） |
实用提示
-
新项目第一步永远是
/init，生成的 CLAUDE.md 直接影响后续所有回答的质量。 -
长 session 主动
/compact，被动触发时可能已经截断了你关心的关键信息。建议 token 超过 70% 就手动压缩。 -
临时问题用
/btw，不要在主流程中插入无关问题，否则会占用宝贵的上下文窗口，影响主任务的连贯性。 -
!和 Bash 工具的区别：!是你主动想让我看某个命令的输出（结果直接显示在对话中）；Bash 工具是我在执行任务时自动调用。日常开发中，你执行命令后想让我分析，用!最直接。 -
IDE 连通后效率翻倍：用
/ide连接后，在编辑器里选中代码 → Claude Code 直接就能看到，不需要手动粘贴或描述文件路径。 -
/context常看常新：就像开车看油表，别等到 token 耗尽才发现。尤其在处理大文件或多个文件时，先看一眼上下文余量。 -
权限分级管理：善用
/permissions对不同目录设置不同权限级别。例如对~/.ssh严格限制，对项目目录放宽 Bash 和文件写入权限。 -
/cost配合/model：如果发现费用过高，可以临时切换到 Haiku 做简单任务，需要深度分析时再切回 Opus。 -
安全敏感项目务必
/security-review：尤其涉及认证、数据库查询、用户输入处理时，安全审查能在提交前拦截大部分常见漏洞。 -
记忆系统用起来：通过
/memory让 Claude 记住你的技术栈偏好、命名约定、项目架构决策等，后续 session 会自动加载，不用反复说明。
常见问题
-
ai 使用过程中发现经常偏离问题，答非所问， 使用 compact 压缩上下文，或者使用/clear 清理过多的上下文， 注意使用compact 也会消耗 token，某些场景下compact 消耗的 token 会比较大，如果是不太重要的上下文，可直接使用/clear
-
! 在使用claude 时如果有某些命令需要 claude 读取结果，但不方便复制粘贴， 则使用！执行命令，claude 会读取命令行的输出，