Claude Code CLI 常用命令

Claude Code CLI 常用命令

安装与启动

Linux / macOS

1
2
3
4
5
6
# 安装 Claude Code(需要 Node.js 18+)
npm install -g @anthropic-ai/claude-code

# 进入项目目录后启动
cd your-project
claude

Windows

1
2
3
4
5
# 方式一:winget 安装(推荐)
winget install --id Anthropic.ClaudeCode

# 方式二:npm 安装
npm install -g @anthropic-ai/claude-code

启动方式

普通启动

1
2
3
4
5
claude                        # 交互式 REPL 会话,按需询问权限
claude "帮我写个函数" # 直接提问并进入交互
claude -p "解释这段代码" # 单次问答,输出后退出
claude -c # 继续当前目录最近一次会话
claude -r # 打开历史会话列表选择恢复

完全权限启动

1
2
claude --permission-mode bypassPermissions           # 跳过所有权限确认,直接执行
claude --dangerously-skip-permissions # 同上(别名,仅限无网络沙箱)

管理命令

1
2
3
4
5
6
7
8
claude update                      # 检查并安装更新
claude doctor # 诊断环境健康
claude auth # 管理认证
claude setup-token # 设置长期认证 Token(需订阅)
claude mcp # 配置 MCP 服务器
claude plugin # 管理插件
claude agents # 管理后台 Agent
claude ultrareview # 云端多 Agent 代码审查

会话内斜杠命令

会话管理

命令 说明
/clear 清空当前会话上下文
/compact 压缩上下文(保留摘要,释放窗口)
/resume 查看并恢复历史会话
/doctor 诊断环境问题

工作模式

命令 说明
/plan 进入计划模式(先设计方案,批准后执行)
/fast 切换快速模式(Opus 更快输出)

Git 与代码

命令 说明
/add-dir 添加目录到上下文
/init 初始化项目 CLAUDE.md
/pr-comments 查看当前分支的 PR 评论

审查与安全

命令 说明
/review 审查 PR/代码
/code-review 代码审查(查 bug 和优化点)
/simplify 简化/重构代码
/security-review 安全审查

记忆与配置

命令 说明
/memory 打开记忆文件编辑器
/config 打开设置面板(主题/模型/权限)
/permissions 管理工具权限
/hooks 管理 hooks
/stats 查看使用统计
/context 查看当前上下文使用情况
/status 查看 Claude Code 状态
/upgrade 检查并升级版本
/login 登录 Anthropic 账号
/logout 退出登录

IDE 与输出

命令 说明
/ide 连接到 IDE(VS Code / JetBrains)
/export 导出对话记录

终端命令

命令 说明
!command 在会话内直接执行终端命令
/terminal-setup 配置终端集成

自定义技能

命令 说明
/skill-name 执行自定义技能(.claude/skills/ 下)

常用工作流

1. 快速查代码

1
claude -p "解释 src/auth/login.ts 的登录流程"

2. 计划后执行

1
2
/plan
# 描述需求 → Claude 设计方案 → 批准后自动实现

3. 代码审查

1
2
/review
# 或 /code-review 针对当前变更

4. 生成 CLAUDE.md

1
2
/init
# 自动分析项目结构,生成项目文档供后续会话使用

5. 恢复历史会话

1
2
/resume
# 列表选择之前的会话继续

项目配置文件

CLAUDE.md(项目根目录)

项目级别的指令文件,Claude 每次会话会自动读取。包含:

  • 项目技术栈
  • 构建/测试命令
  • 代码风格规范
  • 架构约定

.claude/settings.json

1
2
3
4
5
{
"permissions": {
"allow": ["Bash(npm:*)", "Bash(git:*)", "Read", "Write"]
}
}

.claude/skills/

自定义技能目录,每个技能是一个 Markdown 文件,通过 /skill-name 调用。

记忆系统

Claude Code 有持久化记忆能力,存储在 ~/.claude/projects/<项目路径>/memory/ 下:

  • 项目偏好、用户习惯、架构决策等会自动记录
  • 使用 /memory 手动编辑
  • 每次会话自动加载相关记忆

快捷操作

操作 说明
Ctrl+C 中断当前生成
Ctrl+D 退出会话
Ctrl+R 搜索历史命令
Esc 取消当前操作
↑/↓ 浏览历史输入
Tab 自动补全路径/命令

常用参数速查

1
2
3
4
5
6
7
claude --help                  # 查看完整帮助
claude --version # 查看版本
claude -p "..." --model opus # 指定模型(fable/opus/sonnet/haiku)
claude -p "..." --output-format json # JSON 输出
claude -p "..." --output-format stream-json # 流式输出
claude -p "..." --max-budget-usd 5 # 费用上限
claude --dangerously-skip-permissions # 跳过权限(仅限无网络沙箱)