基于Claude code 的 AI 项目开发实战（一）—— 项目环境初始化

本系列文章以开源项目 chinese-poetry-api-main 为例进行Claude AI编程实战。Claude 命令行的常用指令主要分为两大类Claude Code编程助手的交互命令与启动参数以及AntAPI 客户端的资源操作命令。下面我把这两类工具的实操常用指令整理成了表格方便你查阅。‍ 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 CodeCLI 启动命令与参数这些是在终端启动claude程序时使用的命令和参数用于控制会话如何启动。命令 / 参数用途示例claude启动一个全新的交互式会话。claudeclaude query使用初始提示词直接启动交互式会话。claude 帮我解释一下这个项目的架构claude -p query非交互式打印模式执行单次查询后退出适合脚本调用。claude -p 总结这个函数的逻辑 app.jsclaude -c在当前目录下继续最近一次未完成的对话。claude -cclaude -r session通过会话ID或名称恢复一个特定的历史会话。claude -r auth-refactorclaude update将 Claude Code 更新到最新版本。claude updateclaude install [version]安装或重新安装特定版本的 Claude Code。claude install stableclaude auth login登录你的 Anthropic 账户。claude auth loginclaude doctor在 CLI 中直接运行诊断检查。claude doctor⚙️ AntAPI 资源操作命令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 updateupdate是命令和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形式展示效果如下