当 AI 学会点咖啡：瑞幸 Luckin CLI 从安装到避坑全记录

目录

一句话总结：瑞幸出了个命令行工具，能用自然语言点咖啡。本文记录从安装、登录、配置模型到踩坑解决的全过程，Windows 用户特别注意 .env 不生效的问题。

一、前言：咖啡党的终极偷懒工具

作为一个每天靠咖啡续命的开发者，我最近发现了一个有意思的东西——瑞幸咖啡官方推出的 Luckin CLI。

它不是普通的命令行工具，而是一个基于 MCP（Model Context Protocol） 的 AI 助手终端。简单说，你可以直接在终端里对它说：

luckin -p "帮我来一杯冰美式，少冰"

然后 AI 会自动帮你找门店 → 选商品 → 匹配优惠券 → 下单，关键节点会停下来让你确认，再也不用打开 App 点点点了。

更离谱的是，它还能帮你查附近门店、看订单、取消订单，完全用自然语言交互。

官网地址：https://open.lkcoffee.com/mcp

二、安装与登录

1. 安装

下载 luckin.exe 后，直接运行安装命令：

luckin.exe install

这会把它复制到用户目录并加入 PATH，以后可以直接用 luckin 命令。

2. 登录获取 Token

luckin.exe login

这会唤起浏览器，让你扫码或手机号登录瑞幸账号。登录成功后，会写入一个 MCP Token 到本地配置文件，有效期一个月，不用频繁登录。

登录后可以用 luckin.exe menu 或 luckin.exe store 测试一下基础功能是否正常。

三、配置 LLM 模型（核心步骤）

Luckin CLI 本身不自带大模型，需要你自己接入一个 OpenAI 兼容的 API。我手头正好有**阿里云百炼（DashScope）**的 Key，模型选的是 qwen-plus，配置过程如下。

我的配置信息

配置项	值
模型名称	qwen（自定义，用于标识）
Base URL	https://dashscope.aliyuncs.com/compatible-mode/v1
模型 ID	qwen-plus
API Key	sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

添加模型的命令

# 方式一：明文写入 API Key（不推荐，会写入 config.json）
luckin.exe models add qwen `
  --base-url "https://dashscope.aliyuncs.com/compatible-mode/v1" `
  --model "qwen-plus" `
  --api-key "sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" `
  --set-active

# 方式二：通过环境变量引用（推荐）
luckin.exe models add qwen `
  --base-url "https://dashscope.aliyuncs.com/compatible-mode/v1" `
  --model "qwen-plus" `
  --api-key-env "DASHSCOPE_API_KEY" `
  --set-active

我选了方式二，更安全。

验证配置

luckin.exe models status

如果看到类似下面的输出，说明配置成功了：

active: qwen
  base_url: https://dashscope.aliyuncs.com/compatible-mode/v1
  model: qwen-plus
profiles: 1
  qwen: env:DASHSCOPE_API_KEY

四、大坑预警：Windows 上 .env 文件不生效！

配置完成后，我自信满满地运行：

luckin.exe -p "你好"

结果报错：

当前模型 "qwen" 未就绪：未配置 API Key：请在 ~/.luckin/.env 写入 DASHSCOPE_API_KEY=你的密钥

我明明已经按提示在 C:\Users\<你的用户名>\.luckin\.env 里写入了 DASHSCOPE_API_KEY=...，为什么还报错？

排查过程

1. 检查文件内容 → 没问题，Key 确实写进去了。
2. 检查 config.json → 也没问题，api_key_env 指向正确。
3. 怀疑是路径问题 → 在 Windows 上，~ 应该映射到 %USERPROFILE%，路径是对的。
4. 最终发现：Luckin CLI 在 Windows 环境下不会自动读取 .env 文件！它依赖的是系统环境变量本身存在，而不是去读 .env 文件。

解决方案

当前窗口临时生效：

$env:DASHSCOPE_API_KEY="sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
luckin.exe -p "你好"

持久化方案（推荐）：写入 Windows 用户环境变量

[Environment]::SetEnvironmentVariable(
    "DASHSCOPE_API_KEY",
    "sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "User"
)

设置后，关闭当前 PowerShell，重新打开一个新窗口，环境变量就会加载。以后再也不用每次手动设置了。

避坑总结：在 Windows 上使用 Luckin CLI，别指望 .env 文件，直接设系统环境变量最靠谱。

五、实际体验

配置成功后，第一次对话：

luckin.exe -p "你好"

输出：

MCP 连接中…
MCP 列举工具中…
模型推理中…
你好，我是瑞幸咖啡 Luckin CLI 内置助手。我可以帮你：
- 查询附近门店
- 搜索并下单商品（支持一句话点单）
- 查看/取消当前订单
- 修改商品规格（如加冰、去糖等）
请告诉我你的需求，例如：
📍 "查一下附近的瑞幸"
☕ "我要买一杯生椰拿铁"
📦 "查看我的最新订单"

当然，真正用起来比官方示例更有趣。我在微信里用 ClawBot 直接一句话点单，AI 自动帮我匹配了最近的仓兴街店，选好橙 C 美式和规格，原价 ¥20.0，自动减免了 ¥7.1，应付 ¥12.9：

不过目前有两个小限制：没法使用 9.9 优惠券，也没法主动领券，价格就是系统直减后的金额。确认订单后，AI 会生成一个支付二维码，需要自己扫码完成支付，不是自动扣款。付完款告诉它一声，它就立刻帮我查到了取餐码：814。整个流程跑通后体验还是很流畅的，AI 会调用真实的瑞幸接口，不会瞎编结果，关键节点也会停下来让你确认。

最后去门店报取餐码，拿到手的这杯长这样，取餐码对上了：

六、常用命令速查

# 基础
luckin login              # 浏览器登录
luckin logout             # 清除 Token
luckin version            # 查看版本

# 门店与商品
luckin store              # 查询附近门店
luckin menu               # 查询门店饮品菜单
luckin product            # 查询门店商品

# 模型管理
luckin models list        # 列出所有模型
luckin models status      # 查看当前模型状态
luckin models add <name>  # 添加模型
luckin models set <name>  # 切换模型

# 订单
luckin order              # 订单相关操作

# 一句话交互
luckin -p "来一杯生椰拿铁"

七、写在最后

Luckin CLI 是一个很有意思的尝试——它把 MCP 协议从”AI 开发工具”下沉到了”日常消费场景”。对开发者来说，能在终端里用自然语言完成点咖啡、查订单这类操作，既酷又实用。

当然，目前 Windows 版的体验还有打磨空间（比如 .env 不生效的问题），但整体瑕不掩瑜。如果你也是每天一杯咖啡的开发者，不妨试试看。

参考链接：

• 瑞幸 MCP 开放平台：https://open.lkcoffee.com/mcp
• 阿里云百炼模型列表：https://help.aliyun.com/zh/model-studio/getting-started/models

文章作者：阿文

文章链接： https://www.awen.me/post/f9e3566a.html

版权声明：本博客所有文章除特别声明外，均采用 CC BY-NC-SA 4.0 许可协议。转载请注明来自 阿文的博客！