用途:自动识别当前项目类型,确定正确的启动命令,找到不与现有进程冲突的可用端口,并在 localhost 上启动应用,随后在默认浏览器中打开。
主要能力:从配置文件检测 20 多种项目与框架,包括 Node.js(React、Next.js、Vite、Express、Astro、Remix、Nuxt、SvelteKit、Gatsby、Create React App)、Python(Streamlit、Flask、Django、FastAPI、Uvicorn)、Go、Rust、Ruby(Rails、Sinatra、Rack)、Java(Maven、Gradle)、PHP(Laravel)以及静态站点;从 package.json 脚本或框架约定推断启动命令;自动安装缺失依赖;清理框架专属缓存;按需用端口覆盖参数在各框架上指定端口。
使用方式:以 /start-app 或 start-app 调用。工作流为检测项目类型、解析启动命令与端口、寻找可用端口、清理缓存、启动服务器并打开浏览器。可用命令示例:npm run dev、npm start、streamlit run <file>、python manage.py runserver、uvicorn main:app --reload、go run .、cargo run、rails server、php artisan serve、npx serve。该项目说明要求通过 Claude Code CLI 订阅环境运行,不使用按量付费 API key,并建议在 .claude/settings.local.json 中配置允许相关命令的权限。
适用场景:本地开发时快速启动各类项目的开发服务器,尤其是需要避开已占用端口、同时运行多个服务的场景。
限制:不终止已有进程,只寻找下一个可用端口;检测到的端口为默认值,若应用启动时输出其他端口则以应用日志为准;缓存清理只针对已检测框架;node_modules 已存在时不会重装依赖,除非用户要求;不修改任何项目文件;无法检测项目类型时会询问用户而非猜测。