本系列文章以开源项目 chinese-poetry-api-main 为例进行Claude AI编程实战。
Claude 命令行的常用指令,主要分为两大类:Claude Code(编程助手)的交互命令与启动参数,以及Ant(API 客户端)的资源操作命令。
下面我把这两类工具的实操常用指令整理成了表格,方便你查阅。
🧑💻 Claude Code:会话内斜杠命令 (/)
在 Claude Code 的交互会话中输入/即可使用,用于控制会话、管理上下文和执行任务。
| 类别 | 命令 | 用途 |
|---|---|---|
| 会话管理 | /clear | 清空当前对话历史,开始新会话,但保留项目记忆。 |
/resume | 恢复之前的某个对话会话。 | |
/branch//fork | 分支或复刻一个早期的对话,用于探索不同方案。 | |
/rename <name> | 重命名当前会话,方便后续识别和恢复。 | |
/exit | 退出当前会话。 | |
| 上下文与记忆 | /compact | 压缩对话上下文,用总结代替冗长历史,解决响应变慢问题。 |
/context | 显示当前对话窗口的填充情况。 | |
/memory | 编辑或完善项目记忆(CLAUDE.md文件)。 | |
/rewind | 将代码和对话回退到某个检查点,或总结对话的一部分。 | |
| 代码与审查 | /diff | 显示当前所有未提交的更改。 |
/code-review | 对代码差异进行多维度审查,查找错误和需要清理的地方。 | |
/security-review | 专门对代码差异进行安全漏洞审查。 | |
| 任务与模型 | /model | 切换当前使用的 Claude 模型。 |
/effort | 调整 Claude 在推理任务上投入的“努力”程度。 | |
/plan | 在进行大规模更改前切换到“计划模式”。 | |
/btw | 发送一条“顺便说一下”的旁注,不会加入主对话历史。 | |
/tasks | 列出当前会话中所有后台运行的任务(如子代理)。 | |
| 工具与配置 | /init | 在项目中初始化 Claude Code,生成CLAUDE.md配置文件。 |
/config | 修改 Claude Code 的配置,如权限设置。 | |
/add-dir <path> | 为当前会话添加一个额外的文件访问目录。 | |
/doctor | 运行诊断检查,帮助解决安装或配置问题。 | |
/feedback | 向 Anthropic 报告错误,并附上当前会话的上下文。 |
🚀 Claude Code:CLI 启动命令与参数
这些是在终端启动claude程序时使用的命令和参数,用于控制会话如何启动。
| 命令 / 参数 | 用途 | 示例 |
|---|---|---|
claude | 启动一个全新的交互式会话。 | claude |
claude "query" | 使用初始提示词直接启动交互式会话。 | claude "帮我解释一下这个项目的架构" |
claude -p "query" | 非交互式(打印)模式:执行单次查询后退出,适合脚本调用。 | claude -p "总结这个函数的逻辑" < app.js |
claude -c | 在当前目录下,继续最近一次未完成的对话。 | claude -c |
claude -r "<session>" | 通过会话ID或名称恢复一个特定的历史会话。 | claude -r "auth-refactor" |
claude update | 将 Claude Code 更新到最新版本。 | claude update |
claude install [version] | 安装或重新安装特定版本的 Claude Code。 | claude install stable |
claude auth login | 登录你的 Anthropic 账户。 | claude auth login |
claude doctor | 在 CLI 中直接运行诊断检查。 | claude doctor |
⚙️ Ant:API 资源操作命令
ant是官方 API 的命令行客户端,其命令结构为ant <资源>[:<子资源>] <动作> [参数]。
| 类别 | 命令 | 用途 |
|---|---|---|
| 模型管理 | ant models list | 列出所有可用的 Claude 模型。 |
ant models retrieve --model-id <ID> | 查看特定模型的详细信息。 | |
| 消息发送 | ant messages create | 向 Claude 发送消息,这是最核心的命令。 |
| Beta 功能 | ant beta:agents list | 列出所有代理(Agent)。 |
ant beta:sessions:events list | 列出特定会话的事件。 | |
| 通用参数 | --format | 指定输出格式,如json,yaml,pretty等。 |
--transform | 使用 GJSON 路径过滤或重塑响应数据。 | |
-r, --raw-output | 输出纯字符串,不带引号,类似jq -r。 | |
--debug | 打印完整的 HTTP 请求和响应信息,用于调试。 |
ant messages create命令示例:
ant messages create \ --model claude-opus-4-8 \ --max-tokens 1024 \ --message '{role: user, content: "Hello, Claude"}'💡 实操小贴士
善用帮助命令:任何不确定的时候,都可以在命令后加
--help查看详细用法,例如claude --help或ant messages create --help。分清命令与参数:如
claude update(update是命令)和claude -p "query"(-p是参数/标志),这在查阅文档时非常重要。组合使用:很多参数可以组合,例如
claude -c -p "检查类型错误"表示“在最近的会话中,以非交互模式执行一次检查”。管道操作:Claude Code 和 Ant 都支持管道,方便与其他命令行工具结合,例如
cat logs.txt | claude -p "解释这些日志"。
要分析一个项目,最推荐的方法是在项目根目录启动 Claude Code 交互式会话,然后使用自然语言或特定的斜杠(/)命令。
这里为你整理了几种最实用、最直接的分析方法。
🚀 方法一:自然语言提问(最通用)
这是最灵活的方式。进入项目目录后,直接启动 Claude Code 并提出你的分析需求。
cd /path/to/your/project claude在会话中,你可以这样提问:
快速上手新项目:
"分析这个项目结构,告诉我:1. 技术栈 2. 目录职责 3. 如何运行测试"获取高层级概览:
"give me an overview of this codebase"深入理解架构:
"explain the main architecture patterns used here"查找特定功能代码:
"find the files that handle user authentication"梳理业务流程:
"trace the login process from front-end to database"
提示:从宏观问题开始,然后根据回答逐步深入,是理解新代码库的高效方式。
🎯 方法二:使用内置分析命令
Claude Code 提供了一些专为分析设计的斜杠命令,在交互会话中直接输入即可。
| 命令 | 用途 | 说明 |
|---|---|---|
/init | 项目初始化与分析 | 分析当前代码库,并在项目根目录创建或完善CLAUDE.md文件。这个文件会成为 Claude 后续理解项目的“记忆”,非常推荐首先运行。 |
/project-health | 项目健康度评估 | 从代码质量、测试、文档和项目活跃度等多个维度,全面评估项目的健康状况。 |
/code-review | 代码审查 | 检查代码更改(diff),查找正确性错误和需要清理的地方。可加--fix参数自动应用修复。 |
/security-review | 安全漏洞审查 | 专门针对代码更改(diff)进行安全漏洞审查。 |
/tech-debt | 技术债务扫描 | 扫描并优先排序项目中的技术债务。 |
💡 方法三:其他实用技巧
非交互式快速分析:如果只想执行一次性的分析任务而不进入交互界面,可以使用
-p参数。例如:
分析特定文件或目录:你可以在提问时直接指定要分析的文件或目录,让分析更聚焦。
claude /analyze src/main.js and src/utils.js[reference:24]先规划再行动:对于复杂项目或改动,可以先使用
/plan命令进入计划模式。在此模式下,Claude 只进行只读分析并生成计划,不会修改任何文件。这在你希望先看到分析结果和改动方案,再进行操作时非常有用。
简单来说,对于首次分析,建议进入项目目录后输入claude,然后依次尝试/init和/project-health命令,再配合自然语言提问深入了解细节。
/plan
输入对话指令:“分析这个项目结构,告诉我:1. 技术栈 2. 目录职责 3. 如何运行测试”,输出:
trace the login process from front-end to database
通过分析,这个项目只有后端服务没有前端页面,同时给出了几种替代的访问方案。
选择通过接口1的方式显示 静夜思 诗词。
如果本地环境数据库、接口等还不具备,claude会提示进行从远程GITHUB下载安装,根据提示选择即可。
要求查询结果以HTML形式展示,效果如下: