Claude Code CLI 参考手册

简介

Claude Code CLI 是 Claude Code 的命令行客户端，无需图形编辑器，直接在终端运行。支持交互式会话、一次性查询、会话持久恢复、CI 脚本调用。

区分：

• 终端Shell命令：操作系统终端执行，用来启动、管理会话（claude xxx）
• 会话内斜杠命令：进入claude交互界面后使用，以 / 开头（如 /clear、/skill list）

前置条件

1. 已安装 Claude Code CLI
2. 完成登录 / 配置 API Key
3. 在项目根目录执行命令，自动加载 .claude 配置、CLAUDE.md

一、Shell 顶层命令（终端直接执行）

基础启动命令

命令	说明	示例
claude	启动交互式会话	claude
claude "提示词"	带初始任务，直接进入交互会话	claude "优化src工具函数"
claude -p "提示词"	一次性非交互模式，执行完成直接退出（适合脚本/CI）	claude -p "检查src代码规范"
claude -c	继续当前目录最近一次会话	claude -c
claude -r <会话ID>	恢复指定ID的历史会话	claude -r refactor-user
claude update	更新CLI到最新版本	claude update

常用参数（Flags）

• -p / --prompt：一次性任务，非交互
• -c / --continue：继续最近会话
• -r / --resume <id>：恢复指定会话
• --model <model-name>：指定模型，例如 sonnet、opus
• --no-memory：本次会话关闭记忆系统
• --no-mcp：本次会话禁用全部MCP服务

示例组合：

# 使用opus模型，一次性任务，关闭记忆
claude --model opus --no-memory -p "生成用户模块单元测试"

管道输入

支持管道传入文件内容，适合脚本处理

cat src/utils/validator.ts | claude -p "分析这段代码潜在问题"

二、会话内斜杠命令（进入claude交互界面使用）

这部分命令在 claude 交互终端内执行，以 / 开头。

会话与上下文

/help          # 查看帮助
/exit          # 退出交互会话
/clear         # 清空当前会话，新建会话，重载CLAUDE.md
/compact       # 压缩会话历史，减少token占用
/status        # 查看会话状态、token使用量
/context       # 可视化上下文占用情况

模型与账号

/login         # 登录账号
/logout        # 退出登录
/model         # 切换模型版本
/usage /cost   # 查询用量与费用

技能、子代理、MCP、钩子

/skill list /skill reload /skill describe     # 技能管理
/subagent list /subagent reload               # 子代理管理
/mcp list /mcp restart                        # MCP服务管理
/hook list /hook reload /hook disable         # 钩子管理

记忆系统

/memory list /memory add /memory search /memory delete /memory clear

三、配置文件加载规则

CLI读取配置优先级（从低到高）：

1. 全局配置 ~/.claude/settings.json（Mac/Linux）、%USERPROFILE%\.claude\settings.json（Windows）
2. 项目目录 .claude/settings.json（覆盖全局配置）
3. 启动命令行参数（最高优先级，临时覆盖）

项目配置会自动加载：CLAUDE.md、.claude/ignore、.claude/rules、skills、subagents、hooks、mcpServers

四、退出与快捷键

• Ctrl + D：退出交互会话
• /exit：退出会话
• Ctrl + C：终止当前正在执行的任务（不退出会话）

五、CI/自动化脚本示例

非交互模式，适合接入流水线：

# 代码评审，输出报告
claude -p "调用技能 code-review，评审 src目录代码，输出markdown报告" > code-review-report.md

六、会话持久化规则

1. 会话保存在项目目录，不同目录会话互相隔离
2. 使用 claude -c 恢复当前目录上次会话
3. 使用 claude -r <id> 恢复任意历史会话
4. 会话上下文与记忆相互独立：会话上下文随 /clear 清空；记忆保存在本地，跨会话持久存在

七、诊断命令

# 终端执行，诊断项目权限、配置、MCP、CLAUDE.md
claude doctor

八、最佳实践

1. 日常开发：直接 claude 进入交互式会话；长会话定期 /compact
2. 脚本/CI：使用 -p 一次性模式，避免交互式阻塞
3. 切换电脑：记忆文件在本机全局memory目录，会话文件在项目目录，可手动迁移
4. 多人协作：提交 .claude 配置目录到Git，不要提交会话缓存、memory目录
5. 敏感任务：启动时增加 --no-memory，关闭自动记忆

常见问题

1. 终端输入 claude 提示命令不存在

• 确认CLI已经正确安装；检查环境变量PATH；重启终端。

2. -p 一次性模式无法调用技能/MCP

• 一次性模式依然加载项目配置；检查语法，技能调用写法和交互模式一致。

3. 切换目录后，会话丢失
   会话是按目录隔离；回到原目录使用 claude -c 恢复。
4. 修改settings.json后，CLI不生效

• 交互会话：执行 /clear；
• 一次性 -p：每次执行都会重新加载配置。

安全提示

1. CLI拥有本地文件读写与终端执行权限，生产环境默认使用Manual交互模式
2. CI脚本中不要硬编码API Key，使用环境变量注入
3. 执行未知MCP、钩子、技能前，先通过 claude doctor 检查权限风险