Claude Code 命令使用指南

本文整理自飞书文档《Claude Code快速入门实战指南》，重点介绍 Claude Code 的核心命令使用方法。

一、Claude Code 简介

Claude Code 是 Anthropic 官方推出的专业级代码智能体（Agent），与通用型 Agent OpenClaw 不同，Claude Code 定位于"专业纵深"——深度集成代码编辑、终端操作、Git 管理等开发工作流。

三种运行模式

模式	载体	核心特点	适用场景
Terminal（终端命令行）	系统终端（PowerShell / Bash / Zsh）	功能最完整、灵活度最高，支持全部 CLI 命令、Hooks、MCP、管道操作	日常开发、自动化脚本、CI/CD 集成、专业开发者首选
IDE Extension（编辑器扩展）	VS Code / JetBrains 全系列	图形化界面，支持内联 Diff 预览、@ 提及文件、代码选中即问	习惯 IDE 工作流的开发者
Web（浏览器云端）	浏览器访问 claude.ai/code	零安装、云端运行，可处理本地没有的远程仓库	临时使用、移动端查看

💡 推荐：对于国内开发者，Terminal 模式是最佳选择，因为：

1. 功能最完整，支持所有 CLI 能力
2. 终端代理配置简单（export 代理环境变量即可）
3. 可以直接看到 Agent 调用的工具和执行的命令，便于理解工作原理

二、安装与验证

2.1 安装命令

macOS / Linux（推荐）：

curl -fsSL https://claude.ai/install.sh | bash

安装稳定版（比最新版延迟约一周）：

curl -fsSL https://claude.ai/install.sh | bash -s stable

通过 Homebrew 安装：

brew install --cask claude-code

Windows（推荐 PowerShell）：

irm https://claude.ai/install.ps1 | iex

Windows CMD：

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

⚠️ 注意：Windows 用户需要先安装 Git for Windows（提供 Git Bash 环境）。

2.2 验证安装

claude --version

输出版本号（如 claude v2.1.x）则安装成功。

2.3 基础环境依赖

依赖	说明
Git	最关键依赖，没有 Git 则 Checkpoint 回滚机制无法工作，/diff 命令无法使用
ripgrep (rg)	通常随 Claude Code 自动安装，如需手动安装：macOS brew install ripgrep，Windows winget install BurntSushi.ripgrep.MSVC
Xcode Command Line Tools	仅 macOS 需要，如已安装完整版 Xcode 则无需重复安装

三、核心命令使用

3.1 启动 Claude Code

# 进入项目目录
cd ~/my-project

# 启动 Claude Code
claude

首次运行会提示进行身份认证。

3.2 认证方式

方式一：OAuth 订阅登录

claude
# 浏览器跳转 Anthropic 账户授权

• 计费：包含在 Pro/Max 订阅套餐内
• 适用：个人开发者、轻度使用

方式二：API Key 登录

export ANTHROPIC_API_KEY="sk-ant-..."
claude

• 计费：按 Token 用量付费
• 适用：团队/企业、重度使用、需要精细成本控制

3.3 更新命令

自动更新：

• 默认开启后台静默更新
• 新版本修复 Bug 和安全问题，建议保持开启

手动更新：

claude update

切换更新通道（在 ~/.claude/settings.json 中配置）：

{
  "autoUpdatesChannel": "stable"
}

3.4 Doctor 诊断命令

遇到问题时，第一个应该运行的命令：

claude doctor

或在 Claude Code 会话内部：

/doctor

Doctor 检查的核心项目：

检查项	能发现的典型问题
安装类型与版本	还在用旧的 npm 安装方式，应迁移到原生安装器
自动更新状态	当前版本过旧，已知 Bug 在新版中已修复
配置文件有效性	settings.json 里多了个逗号导致 JSON 解析失败
MCP 服务器配置	MCP Server 路径错误或 Node.js 版本不对
快捷键配置	自定义快捷键与系统默认键冲突
上下文使用情况	CLAUDE.md 文件过长，每次对话消耗大量 Token
插件与 Agent 加载	某个 Plugin 与当前版本不兼容

四、本地数据与配置

4.1 配置文件位置

Claude Code 所有数据保存在 ~/.claude/ 目录（Windows: C:\Users\<用户名>\.claude\）：

路径	内容	说明
~/.claude/settings.json	全局配置文件	更新通道、API Key、环境变量、MCP Server 等所有全局设置
~/.claude/CLAUDE.md	全局记忆文件	跨项目生效的指令和偏好
~/.claude/projects/	项目级数据	每个项目的会话记录、自动记忆、本地配置等
~/.claude/credits.json	用量与额度	API 调用次数、Token 消耗统计

4.2 会话存储机制

Claude Code 采用"项目级隔离"设计，每个项目目录对应独立的会话空间：

项目路径	编码后的文件夹名
/Users/alice/code/myapp (macOS)	-Users-alice-code-myapp
C:\Users\Bob\dev\project (Windows)	C--Users-Bob-dev-project

💡 核心认知：Claude Code 不是"通用对话工具碰巧能写代码"，而是"项目级 Agent 碰巧通过对话交互"。每个项目目录是一个独立的工作空间。

4.3 恢复会话

Claude Code 的会话与项目目录绑定：

# 在项目目录下恢复上一次会话
cd ~/my-project
claude -c

# 恢复指定会话
claude --resume

⚠️ 注意：在 project-B 目录下无法恢复 project-A 的会话，这是刻意为之的设计，避免 Claude 按 A 项目的规范修改 B 项目代码。

五、斜杠命令大全

在 Claude Code 会话内部，使用斜杠命令（/）可以快速执行各种操作。

5.1 会话管理

命令	功能	别名
/clear	清空当前对话历史，释放上下文	/reset、/new
/compact [指示]	压缩对话历史，可指定保留重点	—
/resume [会话]	恢复指定历史会话（按 ID 或名称）	/continue
/fork [名称]	从当前对话点创建分支副本	—
/rename [名称]	重命名当前会话	—
/export [文件名]	导出对话为纯文本文件	—
/exit	退出 CLI	/quit

5.2 模型与模式

命令	功能	别名
[模型名]	切换 AI 模型（左右箭头调整 Effort Level）	—
/plan	进入 Plan Mode（先规划后执行）	—
[on|off]	切换快速输出模式	—
/output-style [风格]	切换输出风格（Default / Explanatory / Learning）	—
/vim	切换 Vim / Normal 编辑模式	—

5.3 项目与上下文

命令	功能	别名
/init	初始化项目，生成 CLAUDE.md	—
/add-dir <路径>	向当前会话添加额外的工作目录	—
/context	可视化当前上下文使用情况（彩色网格）	—
/diff	打开交互式 Diff 查看器，查看未提交的变更	—
/rewind	回滚对话和/或代码到历史检查点	/checkpoint
/pr-comments [PR]	获取 GitHub PR 的评论	—
/review	对 Pull Request 进行代码审查	—
/security-review	分析当前分支的变更是否存在安全漏洞	—
/copy	复制上一条 AI 回复到剪贴板	—

5.4 配置与状态

命令	功能	别名
/config	打开配置界面	/settings
/permissions	查看/修改工具权限	/allowed-tools
/memory	编辑 CLAUDE.md 记忆文件，管理自动记忆	—
/doctor	诊断安装和配置状态	—
/status	显示版本、模型、账户和连接状态	—
/cost	显示当前会话 Token 用量和费用（API 用户）	—
/stats	可视化每日用量、会话历史和使用模式	—
/usage	显示订阅套餐限额和速率限制状态	—
/theme	更换颜色主题（含深色/浅色/色盲友好版本）	—
/statusline	配置终端状态栏信息	—
/keybindings	打开快捷键配置文件	—
/terminal-setup	配置终端快捷键（如 Shift+Enter）	—

5.5 扩展与 Agent

命令	功能	别名
/mcp	管理 MCP Server 连接和 OAuth 认证	—
/skills	列出可用的 Skills	—
/plugin	管理 Plugin 插件	—
/agents	管理自定义 Agent 配置	—
/tasks	列出和管理后台任务	—
/hooks	管理 Hook 事件配置	—

5.6 账户与平台

命令	功能	别名
/login	登录 Anthropic 账户	—
/logout	登出 Anthropic 账户	—
/upgrade	打开套餐升级页面	—
/extra-usage	配置超额使用（限额触达后继续工作）	—
/privacy-settings	查看/修改隐私设置（Pro/Max 用户）	—
/desktop	将当前会话转移到桌面应用	/app
/mobile	显示移动端 App 下载二维码	/ios、/android
/chrome	配置 Chrome 集成设置	—
/ide	管理 IDE 集成状态	—
/remote-control	允许从 claude.ai 远程控制此会话	/rc
/remote-env	配置远程环境默认值	—
/install-github-app	安装 Claude GitHub Actions App	—
/install-slack-app	安装 Claude Slack App	—

5.7 信息与反馈

命令	功能	别名
/help	显示帮助信息和可用命令	—
/feedback [报告]	提交使用反馈或 Bug 报告	/bug
/release-notes	查看版本更新日志	—
/insights	生成使用分析报告（项目领域、交互模式、摩擦点）	—
/stickers	订购 Claude Code 贴纸	—
/passes	分享免费试用周（符合条件的账户可见）	—

5.8 内置 Skills

命令	功能
/simplify	审查近期变更代码的复用性、质量和效率，自动修复发现的问题
/batch <指令>	将大规模代码变更分解为 5-30 个独立子任务，并行派发给 Agent 在隔离的 Git Worktree 中执行
/debug [描述]	读取会话调试日志，诊断 Claude Code 自身的运行问题

六、注意事项

1. 保持自动更新开启：新版本经常修复关键 Bug 和安全问题
2. Git 是必须的：没有 Git，Checkpoint 回滚和 /diff 命令无法工作
3. 会话与项目绑定：切换项目目录后，会话会自动切换
4. 国内网络问题：Terminal 模式下配置代理最简单（export HTTP_PROXY/HTTPS_PROXY）
5. 配置文件语法：修改 settings.json 时注意 JSON 格式，多余的逗号会导致配置失效

七、参考链接

• Claude Code 官方文档 (opens new window)
• Claude Code 快速入门实战指南（飞书） (opens new window)
• OpenClaw GitHub (opens new window)

---

最后更新：2026-06-22