Laravel Claude代码设置🚀
一个命令设置 用于Laravel开发的Claude Code。自动配置所有MCP服务器，以获得终极AI驱动的Laravel开发体验 Figma集成.
🎯 这有什么作用
使用完整的开发生态系统安装和配置Claude Code：
🌐 全局MCP服务器（在所有项目中共享）
- ✅ GitHub集成 -访问所有存储库，管理PR（使用自动令牌配置！）
- ✅ GitLab集成 -访问所有存储库，管理MR、问题和项目（使用自动令牌配置！）
- ✅ 记忆系统 -记住所有项目的决策
- ✅ 背景7 -最新Laravel/PHP文档访问
- ✅ Web获取 -访问外部API和资源
- ✅ Figma集成 -具有自动设计令牌提取功能的设计到代码工作流
📁 特定于项目的MCP服务器
- ✅ 文件系统访问 -读/写特定的Laravel项目文件
- ✅ 数据库集成 -直接访问项目的数据库
- ✅ Laravel调试栏 -实时调试（如果已安装）
🎨 新：Figma设计集成
- 从设计到编码的工作流程 -将Figma设计直接转换为Laravel/Livewire组件
- 自动设计令牌提取 -Tailwind CSS的颜色、排版和间距
- 组件规格 -从Figma设计中获取精确的实施细节
- 无缝集成 -适用于您现有的Laravel+Livewire+Filament+Tailwind堆栈
安装程序智能地设置全局服务器一次，并为每个Laravel项目添加特定于项目的服务器。
🚀 快速安装
选项1：直接安装（推荐）
从Laravel项目根目录运行以下命令：
curl -fsSL https://raw.githubusercontent.com/laraben/laravel-claude-code-setup/main/install.sh | bash选项2：预配置代币
如果要跳过交互式提示：
export GITHUB_TOKEN="your_github_personal_access_token"
export GITLAB_TOKEN="your_gitlab_personal_access_token"
export FIGMA_ACCESS_TOKEN="your_figma_access_token"
curl -fsSL https://raw.githubusercontent.com/laraben/laravel-claude-code-setup/main/install.sh | bash选项3：下载并运行
为了获得更多控制权，或者如果您更喜欢先查看脚本：
# Download the script
curl -fsSL https://raw.githubusercontent.com/laraben/laravel-claude-code-setup/main/install.sh -o setup.sh
# Make it executable
chmod +x setup.sh
# Run it
./setup.sh📋 先决条件
在运行安装程序之前，请确保您已经：
- 克劳德代码 已安装(点击此处下载)
- Node.js和npm 安装
- 转到1.22+ 已安装（用于数据库MCP服务器）
- Laravel项目 随着
.env文件已配置 - GitHub个人访问令牌 （安装程序将指导您）
- GitLab个人访问令牌 （可选，用于GitLab集成）
- Figma 个人访问令牌 （可选，用于设计集成）
🔑 令牌设置
GitHub令牌设置
您需要一个GitHub个人访问令牌才能访问私有存储库：
- 首选
- 点击“生成新令牌（经典）”
- 选择这些范围：
- ✅ repo （完全控制私有存储库） - ✅ read:user （读取用户配置文件数据） - ✅ user:email （访问用户电子邮件地址）
- 在安装程序提示时复制生成的令牌
GitLab令牌设置（可选）
对于GitLab集成和私有存储库访问：
- 首选 GitLab设置→ 访问令牌
- 点击“添加新令牌”
- 给它一个描述性的名称（例如，“克劳德代码MCP”）
- 选择这些范围：
- ✅ api （完成API访问） - ✅ read_user （读取用户配置文件数据） - ✅ read_repository （读取存储库数据）
- 设置到期日期（可选）
- 点击“创建个人访问令牌”
- 在安装程序提示时复制生成的令牌
🎨 Figma令牌设置（可选）
对于从设计到编码的工作流：
- 首选 Figma设置→ 个人访问令牌
- 点击“创建新令牌”
- 给它一个描述性的名称（例如，“克劳德代码MCP”）
- 在安装程序提示时复制生成的令牌
🎮 安装后使用
安装后，只需在Laravel项目中打开Claude Code：
cd /path/to/your/laravel/project
claude然后测试一切是否正常：
📊 数据库和项目分析
- “显示数据库结构”
- “这个项目使用的是哪个Laravel版本？”
- “阅读我的.env文件并提出优化建议”
🐙 GitHub集成
- “列出我的私有GitHub仓库中的最近提交”
- “显示打开的拉取请求”
- “当前分行状态如何？”
🦊 GitLab集成
- “显示我GitLab项目的最新提交”
- “列出打开的合并请求”
- “分配给我什么问题？”
- “创建新的合并请求”
🎨 Figma设计集成
- “分析此Figma设计：https://www.figma.com/design/ABC123/MyProject"
- “将此Figma按钮组件转换为Livewire组件”
- “从这个Figma文件中提取Tailwind CSS的调色板”
🧠 记忆与学习
- “请记住，我们使用Filament作为管理面板”
- “我们在这个项目中遵循什么编码标准？”
- “我们对身份验证系统做出了哪些决定？”
🔧 发展的捷径
# Load helpful aliases
source .claude/shortcuts.sh
# Quick commands
pa migrate # php artisan migrate
make-livewire Button # php artisan make:livewire Button
serve # php artisan serve🛠️ 安装什么
该脚本智能地管理全局资源与项目特定资源：
全局MCP服务器（安装一次，由所有项目共享）
- GitHub MCP服务器 -跨所有项目的存储库访问
- GitLab MCP服务器 -GitLab项目访问和管理
- 内存MCP服务器 -共享知识库
- 背景7 -文档访问
- Web提取 -外部API访问
- Figma MCP服务器 -设计文件访问和分析
特定于项目的MCP服务器（每个Laravel项目）
- 文件系统MCP服务器 -访问您的项目文件
- 数据库MCP服务器 -已连接到项目的数据库
- Laravel调试栏MCP （如果可用）
项目文件（创建于 .claude/)
- 说明.md -基于Figma使用指南的AI优化开发说明
- project_context.md -项目特定背景和技术栈
- coding_standards.md -Laravel/Livewire/Filament最佳实践
- memory_prompts.md -AI学习的内存初始化
- shortcuts.sh -开发别名和快捷方式
- README.md -安装文档
MCP服务器二进制文件和依赖关系
- 背景7 -使用npm从源代码构建
- 数据库MCP -从Go源代码构建
- Web提取 -基于TypeScript源代码构建
- 所有其他服务器 -通过npm全球安装
安装程序会根据Laravel自动配置所有内容 .env 文件。
🎨 Figma集成功能
设计到代码工作流
graph LR
A[Figma Design] --> B[Share URL with Claude]
B --> C[Analyze Design Structure]
C --> D[Extract Design Tokens]
D --> E[Generate Laravel Components]
E --> F[Apply Tailwind Styling]
F --> G[Add Alpine.js Interactions]Figma命令示例
# Analyze a complete design
> Please analyze this Figma design and create the corresponding Laravel views
# Extract design system
> Extract all colors, typography, and spacing from this Figma file for our Tailwind config
# Create specific components
> Convert this Figma card component to a Livewire component with proper validation
# Generate admin interface
> Create a Filament resource based on this Figma admin panel design支持的Figma功能
- ✅ 设计令牌提取 -颜色、排版、间距
- ✅ 组件分析 -按钮、表单、卡片、布局
- ✅ 版面理解 -网格系统，响应式设计
- ✅ 自动布局解释 -Flexbox和网格生成
- ✅ 风格指南创建 -一致的设计系统实施
🔧 高级配置
多个项目
安装程序可以在多个Laravel项目中运行。全局MCP服务器是共享的，而特定于项目的服务器对每个项目都是唯一的。
自定义数据库连接
支持MySQL、PostgreSQL和SQLite。安装程序会自动检测您的数据库配置 .env.
团队协作
所有团队成员都可以使用相同的设置。分享你的 .claude/ 文件夹（敏感令牌除外），以便在整个团队中提供一致的AI帮助。
🐛 故障排除
交互模式不起作用？
如果你正在跑步 curl | bash 交互式提示不起作用：
# Download and run directly for interactive mode
curl -fsSL https://raw.githubusercontent.com/laraben/laravel-claude-code-setup/main/install.sh -o setup.sh
chmod +x setup.sh
./setup.shGitHub私有存储库访问问题？
安装程序应自动进行配置。如果您仍然无法访问私有仓库：
- 检查您的令牌是否已配置：
claude mcp list- 手动更新Claude配置中的令牌：
# Edit the config file
nano ~/.claude.json
# Add your token to the GitHub MCP server configurationFigma集成不起作用？
- 验证您的Figma令牌是否有效
- 检查您尝试访问的文件是否不是私有文件（除非您有访问权限）
- 使用完整的Figma URL格式：
https://www.figma.com/design/FILE_KEY/File-Name
数据库连接失败？
确保你的Laravel .env 在运行安装程序之前，文件具有有效的数据库凭据。
缺少依赖关系？
安装程序会告诉你缺少什么，但你可以手动检查：
# Check Claude Code
claude --version
# Check Node.js
node --version
# Check Go
go version
# Check npm
npm --version🆕 v1.0中有什么
🎨 Figma集成
- 完成从设计到编码的工作流程 使用Framelink Figma MCP服务器
- 自动设计令牌提取 顺风CSS
- 交互式令牌管理 有适当的更新提示
- Laravel特有的设计模式 组件生成
🔧 增强的用户体验
- 改进的交互式检测 -正确使用
curl | bash - 更好的令牌管理 -令牌更新的正确提示
- 优雅的错误处理 -即使某些组件出现故障，也会继续安装
- 智能回退 -多种安装方法，确保可靠性
🧠 AI优化指令
- Figma使用指南 -设计集成详细说明
- 错误处理文档 -针对常见问题的明确指导
- Laravel特定工作流 -针对Laravel+Livewire+Filament+Tailwind进行了优化
🛠️ 技术改进
- 强大的配置管理 -更好地处理现有设置
- 跨平台兼容性 -增强了对不同环境的支持
- 性能优化 -更快的安装和启动时间
🔗 链接和资源
- 仓库:
- 克劳德代码: claude.ai/code
- Figma MCP文档: framelink.ai
- Laravel文档: laravel.com/docs
🤝 贡献
发现错误或想添加功能？欢迎PR！
- 分叉存储库
- 创建要素分支
- 进行更改
- 如果适用，添加测试
- 提交拉取请求
📝 许可证
麻省理工学院许可证-请在您的项目中自由使用！
🙏 致谢
- 克劳德代码团队 令人惊叹的人工智能开发平台
- Laravel社区 令人难以置信的框架和生态系统
- Figma团队 用于设计工具和API
- MCP服务器开发人员 用于各种集成工具
______________________________________________________________________
制作❤️ Laravel社区 @拉拉本
在人工智能的帮助下改变你的Laravel开发！ 🚀