命令行界面参考

概述

Claude Code 命令行界面（CLI）是与 Claude Code 交互的主要方式。它提供强大的选项用于运行查询、管理会话、配置模型以及将 Claude 集成到你的开发工作流中。

架构

graph TD
    A["用户终端"] -->|"claude [options] [query]"| B["Claude Code CLI"]
    B -->|交互式| C["REPL 模式"]
    B -->|"--print"| D["打印模式（SDK）"]
    B -->|"--resume"| E["会话恢复"]
    C -->|对话| F["Claude API"]
    D -->|单次查询| F
    E -->|加载上下文| F
    F -->|响应| G["输出"]
    G -->|text/json/stream-json| H["终端/管道"]

CLI 命令

命令	描述	示例
claude	启动交互式 REPL	claude
claude "query"	带初始提示词启动 REPL	claude "explain this project"
claude -p "query"	打印模式 - 查询后退出	claude -p "explain this function"
cat file | claude -p "query"	处理管道内容	cat logs.txt | claude -p "explain"
claude -c	继续最近的对话	claude -c
claude -c -p "query"	在打印模式下继续	claude -c -p "check for type errors"
claude -r "<session>" "query"	通过 ID 或名称恢复会话	claude -r "auth-refactor" "finish this PR"
claude update	更新到最新版本	claude update
claude mcp	配置 MCP 服务器	参见 MCP 文档
claude mcp serve	将 Claude Code 作为 MCP 服务器运行	claude mcp serve
claude agents	列出所有已配置的子代理（Subagent）	claude agents
claude auto-mode defaults	将自动模式默认规则打印为 JSON	claude auto-mode defaults
claude remote-control	启动远程控制服务器	claude remote-control
claude plugin	管理插件（Plugin）（安装、启用、禁用）	claude plugin install my-plugin
claude auth login	登录（支持 --email、--sso）	claude auth login --email user@example.com
claude auth logout	登出当前账户	claude auth logout
claude auth status	检查认证状态（已登录返回 0，未登录返回 1）	claude auth status

核心标志

标志	描述	示例
-p, --print	打印响应，不进入交互模式	claude -p "query"
-c, --continue	加载最近的对话	claude --continue
-r, --resume	通过 ID 或名称恢复特定会话	claude --resume auth-refactor
-v, --version	输出版本号	claude -v
-w, --worktree	在隔离的 Git 工作树（Worktree）中启动	claude -w
-n, --name	会话显示名称	claude -n "auth-refactor"
--from-pr <number>	恢复与 GitHub PR 关联的会话	claude --from-pr 42
--remote "task"	在 claude.ai 上创建 Web 会话	claude --remote "implement API"
--remote-control, --rc	带远程控制的交互式会话	claude --rc
--teleport	在本地恢复 Web 会话	claude --teleport
--teammate-mode	代理（Agent）团队显示模式	claude --teammate-mode tmux
--bare	最小模式（跳过钩子（Hook）、技能（Skill）、插件、MCP、自动记忆（Memory）、CLAUDE.md）	claude --bare
--enable-auto-mode	解锁自动权限模式	claude --enable-auto-mode
--channels	订阅 MCP 频道插件	claude --channels discord,telegram
--chrome / --no-chrome	启用/禁用 Chrome 浏览器集成	claude --chrome
--effort	设置思考力度等级	claude --effort high
--init / --init-only	运行初始化钩子	claude --init
--maintenance	运行维护钩子并退出	claude --maintenance
--disable-slash-commands	禁用所有技能和斜杠命令（Slash Command）	claude --disable-slash-commands
--no-session-persistence	禁用会话保存（打印模式）	claude -p --no-session-persistence "query"