用 Claude Code 开发学生管理系统:Vue3 + SpringBoot + MySQL 全流程配置指南
1. 从零跑通学生管理系统为什么我把 Claude Code 放进了 VS Code学生管理系统几乎是每个后端和前端开发者都会碰到的练手项目但真正动手时麻烦往往不在业务逻辑而在“把 Vue3、SpringBoot、MySQL 三端串起来”这件事上前端要建工程、配路由、写页面后端要建 Maven 项目、写实体和接口数据库要设计表、对字段、调外键。任何一环卡住项目就停在半路。Claude Code 的价值就在这里。它不是单纯补全代码而是能在 VS Code 里读取你的工作目录、理解项目结构、按你的自然语言指令生成页面、接口文档和建表语句。我实测下来用它搭一个学生管理系统的骨架比纯手写快很多尤其是“登录注册页 后台首页 接口文档 数据库设计”这一整套链路。这篇内容聚焦一个完整场景在 VS Code 中通过 Claude Code 辅助搭建 Vue3 前端、SpringBoot 后端与 MySQL 数据库并交付一份可直接复制的settings.json配置骨架以及用 TaoToken 统一 Key 接入的步骤。适合刚接触 Claude Code、想快速跑通项目骨架的开发者也适合已经在用但配置总出问题的同学。核心检索词先摆出来Claude Code 是什么、能做什么、适合谁。它是 Anthropic 推出的命令行/编辑器内 AI 编程助手能在 VS Code 里以插件形式工作适合需要“边写边生成、边生成边联调”的全栈开发场景。下面按“问题场景 → 前置配置 → 可复制配置 → 验证请求 → 排错 → 接入入口”的顺序展开。2. 原问题与场景三端联调到底卡在哪先说清楚痛点不然配置再顺也只是照抄。学生管理系统的典型开发链路是这样的前端用 Vue3 Vite 建工程写登录页、后台首页、学生/教职工/管理员三类角色的菜单和表格后端用 SpringBoot 提供 REST 接口处理登录鉴权、分页查询、增删改数据库用 MySQL 存学生、班级、部门、教职工、管理员等表。三端要能对上前端请求的字段名、后端返回的结构、数据库表的列必须一致。我踩过的坑主要集中在三处。第一前端工程创建时vue create报错因为没装vue/cli得先npm install -g vue/cli。第二Claude Code 生成页面后接口文档和数据库设计是分开的 md 文件字段对不上联调时前端拿不到数据。第三后端 Maven 仓库没改依赖下载慢到怀疑人生。所以这篇的写法是先把 Claude Code 在 VS Code 里配好再用它生成前端页面和文档最后用 SpringBoot 对接每一步都给可复制的命令和配置。你跟着做能跑出一个能登录、能看列表、能调接口的骨架。3. TaoToken 前置统一 Key 接入 Claude CodeClaude Code 要能工作核心是有一个可用的 API Key 和正确的接入地址。这里用 TaoToken 做统一接入好处是一个 Key 可以覆盖模型对话、编码计划、控制台等多个入口不用在多个平台之间来回切换。先明确几个地址后面配置会用到官网入口https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentAPI 地址https://taotoken.net/api模型对话https://taotoken.net/api/chatCoding Planhttps://taotoken.net/coding-plan控制台https://taotoken.net/consoleAPI Keyshttps://taotoken.net/api-keys接入文档https://taotoken.net/docClaude Code 接入说明https://taotoken.net/ClaudeCodeAnthropic操作顺序建议这样先进控制台确认账号状态再去 API Keys 页面创建一个 Key复制保存。注意Key 只在创建时完整显示一次关掉页面就看不到了所以一定要先存到安全的地方。然后打开接入文档对照 Claude Code 的配置说明把 API 地址和 Key 填进配置文件。这里有个关键点Claude Code 的配置不是写在 VS Code 的图形界面里而是写在一个 JSON 文件里通常是用户目录下的.claude/settings.json。这个文件决定了它用哪个 API 地址、哪个 Key、哪个模型。下面直接给骨架。4. 可复制配置settings.json 骨架与 VS Code 插件4.1 安装 Claude Code 插件在 VS Code 的插件市场搜索 Claude Code认准 Anthropic 官方产品点击安装。安装完成后VS Code 侧边栏会出现 Claude Code 的图标点开就能对话。如果你同时用 IDEA也可以在 IDEA 插件市场搜同样的名字安装配置方式一致。安装后先别急着写代码先确认工作目录。在 Claude Code 对话框输入/init它会读取当前打开文件夹的结构并告诉你它识别到的工作目录是哪里。这一步很重要因为后面生成的文件都会落在当前目录下如果目录不对文件就散到别处了。4.2 settings.json 配置骨架在用户目录下创建或编辑.claude/settings.json填入下面的骨架。注意把your_api_key_here换成你在 TaoToken 控制台创建的真实 Key{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_API_KEY: your_api_key_here }, model: claude-sonnet-4-20250514, permissions: { allow: [ Read, Write, Edit, Bash(npm:*), Bash(mvn:*), Bash(mysql:*) ] } }几个参数说明一下。ANTHROPIC_BASE_URL指向 TaoToken 的 API 地址这是统一入口ANTHROPIC_API_KEY填你的 Keymodel指定默认模型你可以按接入文档里列出的可用模型替换permissions.allow是允许 Claude Code 执行的操作这里放开了读、写、编辑和 npm、mvn、mysql 命令方便它直接帮你建工程、跑依赖、连数据库。注意Key 不要提交到 Git 仓库建议把.claude/settings.json加进.gitignore或者用环境变量方式注入。4.3 创建 Vue3 前端工程配置好后在 VS Code 里新建一个文件夹存放前端项目用 VS Code 打开这个文件夹然后打开终端。先装 Vue CLInpm install -g vue/cli装完后创建项目我建的是 Vue3 项目vue create student-admin-frontend创建过程中会让你选 Vue 版本和配置项选 Vue3 即可。等它跑完进入项目目录cd student-admin-frontend npm run serve浏览器打开http://localhost:8080看到 Vue 默认页就说明前端工程通了。这一步是后面所有页面生成的基础。5. 验证请求让 Claude Code 生成页面并联调5.1 生成登录注册页与数据库设计前端工程跑起来后在 Claude Code 对话框输入指令。我当时的指令是这样的请帮我生成一个学生管理系统的登录和注册页面需要分为学生登录、教职工登录和管理员登录注册也要区分不同角色。学生用学号密码教职工用教职工号密码。同时帮我生成对应的表设计把数据库的生成代码写在登录和注册页面的数据库.md中。Claude Code 会先问你后端用什么技术对接我选的是 SpringBoot MySQL。它生成完页面后会在项目目录下多出一个登录和注册页面的数据库.md里面是建表语句。这里要提醒一句确保你的 API Key 账号有余额生成过程中会持续消耗额度余额不足会中断。5.2 生成后台首页与接口文档接着生成后台首页。如果你有原型图可以直接把图发给它如果当前模型不支持图片就把页面结构用文字描述清楚。我的指令是参考图片请帮我生成一个这样的管理系统首页尽量美观精致。左边菜单栏设计为首页 / 学生管理班级信息、学生信息/ 教职工管理部门信息、教职工信息/ 管理员管理员信息。 班级管理页面显示班级名称、班主任、班主任电话、最后更新时间、操作编辑/删除。 学生信息页面显示姓名、学号、头像、班级名称、性别、手机号、最后操作时间、操作编辑/删除。 部门信息页面显示部门名称、最后操作时间、操作编辑/删除。 教职工信息页面显示姓名、教职工号、性别、头像、所属部门、职位、入职时间、最后操作时间、操作编辑/删除。 管理员信息页面显示用户名、头像、最后操作时间、操作编辑/删除。 帮我生成对应的页面同时想好需要哪些接口、哪些表生成接口文档和数据库表设计分别命名为 xx接口文档.md 和 xx数据库表设计.md。等它生成完你会看到页面组件、路由配置、接口文档和数据库设计文件。页面可能不是特别精致但结构是完整的后续可以通过对话继续调整。比如我后来又让它改成三类用户登录、去掉注册页、按角色控制可见数据范围它都能在原有基础上改。5.3 用 MySQL 建表并验证拿到数据库设计 md 后打开 MySQL 客户端把建表语句复制进去执行。先建库CREATE DATABASE student_admin DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; USE student_admin;然后把 md 里的建表语句逐条执行。执行完用SHOW TABLES;确认表都建好了。这一步验证的是数据库设计和实际表结构是否一致如果字段类型或长度有问题现在改还来得及。5.4 搭建 SpringBoot 后端并联调后端用 Maven 建项目。在 IDEA 或 VS Code 里新建 Maven 项目创建成功后记得改settings.xml里的 Maven 仓库地址换成国内镜像不然依赖下载会很慢。然后把前面生成的接口文档.md和数据库表设计.md一起给 Claude Code让它按文档生成 SpringBoot 的实体类、Mapper、Service 和 Controller。后端启动后默认端口 8080前端如果也是 8080 会冲突改一下前端端口或后端端口。前端在vue.config.js里配代理把/api转发到后端module.exports { devServer: { proxy: { /api: { target: http://localhost:8081, changeOrigin: true } } } }然后在前端调用登录接口用浏览器开发者工具看 Network确认请求发出、后端返回、数据渲染三步都通。如果登录成功跳转到后台首页说明三端联调跑通了。6. 本篇常见错排查报错一vue create提示 command not found。原因是没装 Vue CLI。执行npm install -g vue/cli装完再试。如果还不行检查 npm 全局路径是否在环境变量里。报错二Claude Code 生成的文件不在当前目录。用/init确认工作目录如果不对重新用 VS Code 打开正确的文件夹再对话。报错三API 请求返回 401 或余额不足。检查settings.json里的 Key 是否填对、是否有多余空格去控制台确认账号余额。Key 只在创建时显示一次如果丢了就重新创建一个。报错四后端启动报数据库连接失败。检查application.yml里的数据库地址、端口、用户名、密码以及数据库是否已建库建表。MySQL 8 还要注意驱动类名和时区参数。报错五前端请求跨域。开发阶段用vue.config.js的 proxy 解决不要在前端硬编码后端地址。生产环境用 Nginx 反向代理。报错六Maven 依赖下载慢或失败。改settings.xml的 mirror 地址换成国内镜像然后执行mvn clean install重新拉取。7. 接入入口与后续建议整套流程跑下来最花时间的其实不是写代码而是配置和联调。Claude Code 帮你省掉的是“从零写页面和文档”的部分但配置和验证还是得自己动手。如果你在排障或接入阶段卡住优先看 API Keys 和接入文档API Keyshttps://taotoken.net/api-keys接入文档https://taotoken.net/docClaude Code 接入说明https://taotoken.net/ClaudeCodeAnthropic如果你主要是验证模型效果、试不同模型的生成质量可以去模型对话页面https://taotoken.net/api/chat如果你打算长期用 Claude Code 做编码和 Agent 任务Coding Plan 更合适https://taotoken.net/coding-plan最后给一个实用建议生成页面和文档时尽量把需求拆成小步一次只让它做一件事比如先生成登录页确认没问题再生成首页再生成接口文档。这样即使某一步生成得不对也容易回退不会一次性把整个项目搞乱。数据库设计 md 和接口文档 md 一定要对齐字段名这是三端联调最容易出问题的地方。