5.1 claude - 启动交互式 REPL

claude 是 Claude Code 的主命令,用于启动交互式 REPL(Read-Eval-Print Loop)环境。这是与 Claude Code 进行日常交互的最常用方式,提供了一个流畅的对话式编程体验。

命令语法

claude [options] [prompt]

命令选项与参数

参数:

参数 描述
prompt 你的提示内容

选项:

选项 描述 示例
--verbose 覆盖配置中的详细模式设置 --verbose
-p, --print 打印响应并退出(对管道有用)。注意:当 Claude 以 -p 模式运行时,工作区信任对话框会被跳过。只在你信任的目录中使用此标志。 --print
--output-format <format> 输出格式(仅适用于 --print):"text"(默认)、"json"(单一结果)或 "stream-json"(实时流) --output-format json
--dangerously-skip-permissions 绕过所有权限检查。仅推荐在没有互联网访问的沙箱中使用。 --dangerously-skip-permissions
-c, --continue 继续最近的对话 --continue
-r, --resume [sessionId] 恢复对话 - 提供会话 ID 或交互式选择要恢复的对话 --resume session-id-123
--model <model> 当前会话使用的模型。提供最新模型的别名(例如 'sonnet' 或 'opus')或模型的全名 --model claude-sonnet-4-5
-v, --version 输出版本号 --version
-h, --help 显示命令帮助 --help

子命令:

命令 描述
update 检查更新并在可用时安装

功能描述

启动 Claude Code 的交互式 REPL 环境后,您可以:

核心功能

  • 自然语言对话:与 Claude 进行流畅的自然语言交互
  • 代码生成:根据需求生成各种编程语言的代码
  • 代码理解:解释现有代码的功能和工作原理
  • 代码优化:改进代码质量、性能和可读性
  • 问题排查:诊断代码中的错误和潜在问题

高级功能

  • 工具调用:使用内置工具(如文件读写、搜索、执行命令)
  • 会话管理:保存和恢复对话历史

使用示例

基本用法

claude

这会启动 Claude Code 的交互式 REPL,您将看到类似以下的提示符:

Claude Code v1.0.0
Type '/help' for available commands.
>

现在您可以开始与 Claude 进行交互:

> 生成一个 Python 快速排序算法

使用初始提示启动

claude "解释这个项目的架构"

这会使用指定的初始提示启动 REPL,Claude 会立即开始处理该提示并返回结果。这种方式适用于快速执行一次性任务。

指定模型

claude --model claude-sonnet-4-5

这会使用指定的模型启动 REPL。您可以根据需要选择不同的模型,平衡性能和质量。

恢复之前的会话

claude --continue

这会恢复最近的对话会话,让您可以继续之前的工作。您也可以使用 --resume 标志恢复特定会话:

claude --resume session-id-123

常用选项

选项 描述 示例
--model 指定使用的模型 --model claude-sonnet-4-5
--continue 恢复最近的会话 --continue
--resume 恢复特定会话 --resume session-id
--verbose 启用详细日志 --verbose
--help 显示帮助信息 --help

最佳实践

1. 选择合适的模型

根据任务复杂度选择合适的模型,平衡性能和质量。

2. 保存会话

定期保存重要的会话,以便后续恢复和参考。

故障排除

问题:无法启动 REPL

可能原因

  • 网络连接问题
  • 许可证无效
  • 依赖缺失

解决方案

  1. 检查网络连接
  2. 验证许可证状态
  3. 重新安装依赖

问题:响应速度慢

可能原因

  • 模型选择不当
  • 网络延迟
  • 系统资源不足

解决方案

  1. 尝试使用更快的模型
  2. 检查网络连接
  3. 关闭其他占用资源的程序

问题:权限错误

可能原因

  • 尝试执行敏感操作

解决方案

  1. 使用 --dangerously-skip-permissions 标志(谨慎使用)

通过以上信息,您应该能够熟练使用 claude 命令启动和配置交互式 REPL 环境,享受高效的对话式编程体验。