跳到主要内容

Skills 授权登录(免复制 Token)

用 Skills 操作 JeecgBoot 时,不用再去浏览器 F12 复制 Token:在浏览器里登录、点一下「授权」,Skills 就能以你的身份调用接口。


怎么用​

在 Claude Code 里说需求时带上系统的后端地址就行:

> JeecgBoot 后端地址 http://127.0.0.1:8080/jeecg-boot,在 Online 中创建一个请假单

第一次使用时,AI 会自动安装 jeecg 命令行工具,并在浏览器里打开登录页。输入账号、密码和验证码登录:

确认账号、选好租户后点「授权」(没特别指定租户时,Skills 就在这里选的租户下操作):

看到「授权成功」就可以关掉页面,回到 Claude Code 继续:

之后会自动续期,不用再管。30 天没用过、或者授权被撤销后,下次使用时会再打开登录页,重新登录一次即可。

也可以直接给 Token

不想在浏览器里登录,也可以照旧把 Token 直接发给 AI,例如「Token 是 eyJhbGciOi…,帮我……」,Skills 会直接用你给的 Token,不再打开登录页。Token 怎么取见 Token 获取方式。


手动登录(可选)​

想提前登录、换账号换租户,或者自己写脚本调接口时,可以手动操作。

1. 安装​

需要 Node.js 18 及以上(用一键安装装过 Claude Code 的已经有了):

npm i -g @jeecg/cli
PowerShell

如果执行 jeecg 提示「无法加载文件 jeecg.ps1,因为在此系统上禁止运行脚本」,先运行: Set-ExecutionPolicy -Scope CurrentUser RemoteSigned

2. 登录​

jeecg auth login --host <后端地址>

--host 填后端地址,例如 http://127.0.0.1:8080/jeecg-boot,不是浏览器里打开的页面地址。

执行后会自动打开浏览器登录页,登录并点「授权」后终端显示登录成功:

请在浏览器中登录:
http://127.0.0.1:57986/8IbR84Dhe65Ht_lRzzEX7A

登录成功:admin,租户 八匹狼(1012)

常用命令​

命令作用
jeecg auth status查看已登录的地址、账号、租户
jeecg auth login --host <地址>登录;已经登录过时直接显示确认租户,用来换租户,页面上点「切换账号」可以换账号
jeecg auth logout --host <地址>退出:撤销授权并删除本机的登录信息
jeecg auth token输出当前 Token,自己写脚本时用,例如 curl -H "X-Access-Token: $(jeecg auth token)" ...
jeecg --help查看全部参数

常见问题​

提示「没有开启在线授权」​

  • 检查 --host:要填后端地址(带 /jeecg-boot 这类路径),不是前端页面地址。
  • 系统版本太旧、还不支持授权登录时,只能按 Token 获取方式 从浏览器复制 Token。

在服务器(SSH)上,没有浏览器​

登录页由 jeecg 命令行工具在服务器本机提供,要在自己电脑的浏览器里打开:

  1. 在服务器上执行 jeecg auth login --host <后端地址>,它会打印登录页地址 http://127.0.0.1:端口/...。
  2. 用 VS Code、Cursor 等远程连接的,端口会自动转发,直接点开链接;普通 SSH 先在自己电脑上执行下面的命令,再打开链接:
ssh -L <端口>:127.0.0.1:<端口> <用户>@<服务器>
  1. 登录并点「授权」后,服务器上的命令显示登录成功。AI 在服务器上取 Token 时,也会提示你按这几步操作。

macOS、Linux、WSL 上使用​

  • 安装时报 EACCES 权限错误:执行 sudo npm i -g @jeecg/cli,或者用 nvm 安装 Node.js 后再装。
  • 提示「需要 Node.js 18 及以上」:Linux 系统自带的 Node.js 版本常常偏旧,升级后再试。
  • 在 WSL 里使用时,会自动打开 Windows 上的浏览器。