☰
基于Claude code 的 AI 项目开发实战(一)—— 项目环境初始化
2026/10/23 14:38:31 网站建设 项目流程

本系列文章以开源项目 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"}'

💡 实操小贴士

  1. 善用帮助命令:任何不确定的时候,都可以在命令后加--help查看详细用法,例如claude --help或ant messages create --help。

  2. 分清命令与参数:如claude update(update是命令)和claude -p "query"(-p是参数/标志),这在查阅文档时非常重要。

  3. 组合使用:很多参数可以组合,例如claude -c -p "检查类型错误"表示“在最近的会话中,以非交互模式执行一次检查”。

  4. 管道操作: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形式展示,效果如下:

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询