2026西湖龙井茶官网DTC发售:茶农直供,政府溯源防伪到农户家
您的 Next.js 项目配备了一位人工智能助手。问题不在于是否使用人工智能,而在于它生成的代码是否符合您项目的规范。
这是一份动手实践指南。在不到 30 分钟内(通过命令行界面操作需 10 分钟,手动操作需 20 分钟),您将使用 Claude Code 将 AI Dev OS 安装到现有的 Next.js 项目中。最终,您的人工智能将始终如一地应用您的命名规范、安全模式和架构规则——无需您在每次提示时都反复提醒它。
所有示例均展示代码修改前后的对比,以便您确切了解更改内容。
安装内容概览(5 分钟)
AI Dev OS 采用四层模型。对于 Next.js 项目,各层级的分布如下:
CLAUDE.md ← 第 1 层 + 第 2 层:始终加载,包含项目理念
.claude/guidelines/
nextjs.md ← 第 3 层:应用路由、服务器动作、中间件
typescript.md ← 第 3 层:类型约定、命名规则
security.md ← 第 3 层:认证模式、输入验证
.claude/commands/ ← 第 4 层:用于常见任务的可复用技能
您日常最关心的规则位于 guidelines/ 目录中。它们仅在相关时加载,而非在每次提示时都加载,因此不会分散 Claude 对您实际任务的注意力。
前置要求
Node.js >= 18
Next.js >= 14(应用路由)
已安装 Claude Code 命令行界面
TypeScript(强烈建议启用严格模式)
已经有一个正在运行的 Next.js 项目?很好——直接基于该项目进行操作。从头开始创建新项目也同样适用。
选项 A:命令行界面设置(10 分钟)
最快的路径:
npx ai-dev-os init --rules typescript --plugin claude-code
这将生成:
-
CLAUDE.md— 指南索引(3 行指令 + 文件引用) -
docs/ai-dev-os/— 规则子模块,包含针对 TypeScript/Next.js 的第 1 层至第 3 层指南 -
.claude/plugins/ai-dev-os/— 技能、代理和钩子(第 4 层) - 用于自动规则验证的预提交钩子
运行完成后,打开 CLAUDE.md 并将您项目特定的指南文件添加到 ## Project-Specific Guidelines(项目特定指南)部分(建议以 3 个文件作为起点)。
验证设置:
npx ai-dev-os doctor
输出结果应显示所有指南文件均已检测到,且无配置冲突。
选项 B:手动设置(20 分钟)
手动设置耗时较长,但能让您清晰地理解每个文件的作用。如果您希望大幅调整规则,推荐采用此方式。
步骤 1:添加规则子模块并复制 CLAUDE.md 模板
# 为 TypeScript/Next.js 添加第 1 层至第 3 层规则
git submodule add https://github.com/yunbow/ai-dev-os-rules-typescript.git docs/ai-dev-os
git submodule update --init
# 添加 Claude Code 插件(技能、代理和钩子)
git submodule add https://github.com/yunbow/ai-dev-os-plugin-claude-code.git .claude/plugins/ai-dev-os
# 复制 CLAUDE.md 模板
cp docs/ai-dev-os/templates/nextjs/CLAUDE.md.template ./CLAUDE.md
免责声明:本文内容来自互联网,该文观点不代表本站观点。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌抄袭侵权/违法违规的内容,请到页面底部单击反馈,一经查实,本站将立刻删除。