`claude "query"` — 使用初始提示启动 REPL

claude 命令是使用 Claude Code 的基础。掌握它的各种启动方式，能让你更快进入工作状态。

最基本的用法

直接运行，进入交互式对话：

claude

启动后会出现 > 提示符，可以开始和 Claude Code 对话。退出用 Ctrl+C 或输入 /exit。

---

带初始问题启动

如果你已经知道要问什么，可以直接把问题带进去：

claude "帮我看看 src/index.ts 有什么问题"

等效于启动后再输入那个问题，但省去了等待启动界面的步骤，适合已经想好问题的场景。

# 多个词的问题记得加引号
claude "这个项目的测试覆盖率怎么样？有什么建议？"

# 也可以是具体的任务
claude "找出 src/ 目录下所有没有处理错误的 async 函数"

---

非交互模式：执行后退出

用 -p 或 --print 标志，Claude Code 完成后会直接退出，不进入交互模式：

claude -p "解释 main.go 这个文件的作用"

这种模式适合：

• 在脚本里调用 Claude Code
• 只需要一次性答案，不想进入交互
• CI/CD 流程中自动化执行

# 结合管道使用
cat error.log | claude -p "分析这个错误日志，找出根本原因"

# 处理文件内容
claude -p "代码审查" < src/utils/helpers.ts

---

继续上次的对话

-c 或 --continue 恢复最近一次对话：

claude -c

适合场景：上次没处理完，或者想在上次讨论的基础上继续。

Claude Code 会恢复之前的对话上下文，包括讨论过的代码、做出的决策等。

# 继续上次并带上新问题
claude -c "刚才写的那个缓存函数，帮我加上单元测试"

---

按 ID 恢复特定会话

每次对话都有唯一 ID。如果你想恢复某个特定的历史会话（不是最近一次），用 --resume：

# 先查看历史会话列表
claude --list-sessions

# 按 ID 恢复
claude --resume abc123def456

适合场景：你有多个并行进行的任务，想切换到之前某个特定任务的对话。

---

在特定目录启动

默认情况下，Claude Code 在当前目录工作。可以明确指定：

# 在另一个目录启动，不需要 cd
claude --cwd ~/projects/my-app

# 或者用绝对路径
claude --cwd /path/to/project "帮我分析这个项目"

---

常用的启动组合

# 用 Opus 模型做复杂任务
claude --model claude-opus-4-7 "帮我设计一个分布式缓存方案"

# 安静模式，允许自动编辑文件（不需要每次确认）
claude --permission-mode acceptEdits

# 完全自动化（适合 CI，慎用）
claude --dangerously-skip-permissions

# 指定模型 + 追加系统提示
claude --model claude-haiku-4-5 \
  --append-system-prompt "只回答和 Python 相关的问题"

---

在 REPL 里的基本操作

进入交互模式后：

操作	说明
直接输入	发送消息给 Claude Code
Enter	发送（单行模式）
Shift+Enter	换行（不发送，用于多行输入）
Ctrl+C	中止当前操作或退出
Ctrl+L	清屏（不清历史）
↑ / ↓	浏览历史输入
/help	查看可用的斜杠命令

---

进入 Vim 模式

如果你习惯 Vim 操作：

# 启动时就开启 Vim 模式
claude --vim

或者在交互界面里：

> /vim

开启后可以用 Vim 快捷键编辑输入内容（i 进入插入模式，Esc 退出，等等）。

---

常见问题

claude 命令找不到

# 确认安装
npm list -g @anthropic-ai/claude-code

# 重新安装
npm install -g @anthropic-ai/claude-code

启动后 API Key 认证失败

# 检查 Key 是否配置
echo $ANTHROPIC_API_KEY

# 重新登录
claude /logout
claude  # 重新启动时会要求登录

想看到更多运行细节

# 详细日志模式
claude --verbose