​
入门

Claude Code 提供两种主要的交互方式：

  • 交互模式：运行 claude 启动 REPL 会话
  • 一次性模式：使用 claude -p "查询" 进行快速命令
# 启动交互模式
claude

# 以初始查询启动
claude "解释这个项目"

# 运行单个命令并退出
claude -p "这个函数做什么？"

# 处理管道内容
cat logs.txt | claude -p "分析这些错误"

​
CLI 命令

命令描述示例
claude启动交互式 REPLclaude
claude "查询"以初始提示启动 REPLclaude "解释这个项目"
claude -p "查询"运行一次性查询，然后退出claude -p "解释这个函数"
cat 文件 | claude -p "查询"处理管道内容cat logs.txt | claude -p "解释"
claude -c继续最近的对话claude -c
claude -c -p "查询"在打印模式下继续claude -c -p "检查类型错误"
claude -r "<会话ID>" "查询"通过 ID 恢复会话claude -r "abc123" "完成这个 PR"
claude update更新到最新版本claude update
claude mcp配置 Model Context Protocol 服务器查看教程中的 MCP 部分

​
CLI 标志

使用这些命令行标志自定义 Claude Code 的行为：

标志描述示例
--add-dir添加额外的工作目录供 Claude 访问（验证每个路径是否存在为目录）claude --add-dir ../apps ../lib
--allowedTools除了settings.json 文件之外，无需提示用户许可即可允许的工具列表"Bash(git log:*)" "Bash(git diff:*)" "Write"
--disallowedTools除了settings.json 文件之外，无需提示用户许可即可禁止的工具列表"Bash(git log:*)" "Bash(git diff:*)" "Write"
--print, -p不使用交互模式打印响应（有关程序化使用详情，请参阅 SDK 文档）claude -p "查询"
--output-format指定打印模式的输出格式（选项：text、json、stream-json）claude -p "查询" --output-format json
--verbose启用详细日志记录，显示完整的逐轮输出（在打印和交互模式下对调试有帮助）claude --verbose
--max-turns限制非交互模式下的代理轮数claude -p --max-turns 3 "查询"
--model使用最新模型的别名（sonnet 或 opus）或模型的完整名称设置当前会话的模型claude --model claude-sonnet-4-20250514
--permission-prompt-tool指定在非交互模式下处理权限提示的 MCP 工具claude -p --permission-prompt-tool mcp_auth_tool "查询"
--resume通过 ID 恢复特定会话，或在交互模式下选择claude --resume abc123 "查询"
--continue加载当前目录中最近的对话claude --continue
--dangerously-skip-permissions跳过权限提示（谨慎使用）claude --dangerously-skip-permissions

--output-format json 标志对脚本编写和自动化特别有用，允许您以编程方式解析 Claude 的响应。

有关打印模式（-p）的详细信息，包括输出格式、流式传输、详细日志记录和程序化使用，请参阅 SDK 文档。

​
斜杠命令

在交互式会话期间控制 Claude 的行为：

命令用途
/bug报告错误（将对话发送给 Anthropic）
/clear清除对话历史
/compact [instructions]使用可选的焦点指令压缩对话
/config查看/修改配置
/cost显示令牌使用统计
/doctor检查 Claude Code 安装的健康状况
/help获取使用帮助
/init使用 CLAUDE.md 指南初始化项目
/login切换 Anthropic 账户
/logout从 Anthropic 账户登出
/memory编辑 CLAUDE.md 记忆文件
/model选择或更改 AI 模型
/permissions查看或更新权限
/pr_comments查看拉取请求评论
/review请求代码审查
/status查看账户和系统状态
/terminal-setup安装 Shift+Enter 键绑定用于换行（仅限 iTerm2 和 VSCode）
/vim进入 vim 模式，用于交替插入和命令模式

​
特殊快捷方式

​
使用 # 快速记忆

通过以 # 开始输入即可即时添加记忆：

# 始终使用描述性变量名

系统将提示您选择要将此存储在哪个记忆文件中。

​
终端中的换行

使用以下方法输入多行命令：

  • 快速转义：输入 \ 后跟 Enter
  • 键盘快捷键：Option+Enter（如果已配置，则为 Shift+Enter）

在终端中设置 Option+Enter：

对于 Mac Terminal.app：

  1. 打开 设置 → 配置文件 → 键盘
  2. 勾选”将 Option 键用作 Meta 键”

对于 iTerm2 和 VSCode 终端：

  1. 打开 设置 → 配置文件 → 按键
  2. 在”常规”下，将左/右 Option 键设置为”Esc+”

iTerm2 和 VSCode 用户提示：在 Claude Code 中运行 /terminal-setup 自动配置 Shift+Enter 作为更直观的替代方案。

有关配置详情，请参阅设置中的终端设置。

​
Vim 模式

Claude Code 支持一部分 Vim 键绑定，可以通过 /vim 启用或通过 /config 配置。

支持的部分包括：

  • 模式切换：Esc（到 NORMAL），i/I，a/A，o/O（到 INSERT）
  • 导航：h/j/k/l，w/e/b，0/$/^，gg/G
  • 编辑：x，dw/de/db/dd/D，cw/ce/cb/cc/C，.（重复）