Lune 命令行应用

Lune 命令行应用可以把 Lune MCP 服务器安装到受支持的本地 Agent，并检查安装后的连接。它也能在终端中管理登录、团队、凭证和账单。

CLI 是可选的设置和排查工具，不是主要的科研入口。文献检索等科研任务请在 AI Agent 内通过 Lune MCP 工具完成。

安装

npm install -g @retrograde-labs/lune-cli

如果你还没有 Node，请先通过 nodejs.org 或你的包管理器安装它。

登录

lune login

这会打开一个浏览器标签页，让你用 Lune 账户登录。命令行应用会记住你，你不必再登录一次。

lune whoami

显示你当前登录的账户、当前套餐、今日剩余请求数，以及你的点数余额。

把 Lune 接入本地 AI Agent

命令行应用可以一步为你接好大多数桌面 AI 应用。

lune install --client claude-code
lune install --client cursor
lune install --client vscode
lune install --client codex

你可以运行多条。对这些应用，命令会更新对应的配置文件，并在后台创建一个 API 密钥。

有些应用通过自己的界面接入。对于这类应用（例如 Claude 桌面版），命令会打开控制台上对应的指南：

lune install --client claude-desktop

之后若要移除某个连接：

lune uninstall --client cursor       # 移除单个应用
lune uninstall --all                 # 移除所有连接

在已连接的 Agent 中使用 Lune

安装完成后，打开本地 Agent，让它检索 Paper、阅读全文、追踪引用、比较方法、核验论断或查询科研最佳实践。Agent 会在正常工作过程中选择已安装的 Lune MCP 工具。你不需要编写 REST 客户端，也不必把任务移到单独的终端流程中。

管理你的账户

lune teams list                  # 你加入的所有团队
lune teams use <slug>            # 设置该配置档的当前团队
lune teams current               # 显示当前团队
 
lune keys list                   # 当前团队的 API 密钥
lune keys create --name laptop   # 新建密钥（只显示一次）
lune keys revoke <id>

CLI 会在创建新的 MCP 连接时使用当前团队。如果本地 Agent 应使用另一个团队的额度，请先切换团队，再运行 lune install。

多重身份

如果你同时把 Lune 用于个人和团队工作，--profile 标志可以把两者分开。

lune --profile work login
lune --profile work teams use acme
lune --profile work install --client codex

不传 --profile 时使用的是 default。每个配置档都有自己的登录状态和自己的当前团队。

诊断

lune doctor

它会指出明显的异常：账户不对、密钥过期、安装命令读不到的配置文件。觉得哪里不对，先跑这一条。