Easy Lens CLI 是 Snap 的免費命令列工具,能讓 Claude Code、Codex 或 Cursor 建置 Snapchat Lens、產生預覽影片、推送到手機測試,再送交 Snap 審核。 Snap 在 2026 年 11 月 18 日公開推出,使用 Snapchat 帳號即可開始。
先按作品選路線。臉部追蹤、手勢或鏡頭疊圖用 Recipe AR Lens,全螢幕遊戲或互動工具用 Web Lens。台灣創作者可先安裝並試作。依 Snap 現行公告,台灣目前未列入 Lens+ 分潤資格地區。
Easy Lens CLI 是什麼:把 Lens 產線裝進終端機

Easy Lens CLI 透過 npm 套件 @snap/easylens-cli 提供 easylens 指令。CLI 沿用 Easy Lens 的創作流程,讓代理在專案目錄內呼叫指令,從選素材、組裝與預覽一路做到提交審核。
Snapchat Lens 是相機特效或可玩的互動體驗,例如把數位物件放進畫面、做臉部特效,或讓使用者挑戰一關遊戲。Lens Studio 提供視覺化編輯工具。網頁與手機版 Easy Lens可用文字描述生成作品,CLI 則把這項流程接到外部編碼代理。
npm registry 顯示,首批 smoke 版本在 2026 年 11 月 6 日出現。本文實測採用的 v0.2.99 於 11 月 17 日發布,截至 11 月 22 日仍為 npm 上的最新版。團隊交接時可把實際版本寫進專案文件,方便重現結果。
Snap 列出的支援平台為 macOS、Windows 和 Linux。用 npm 安裝需要 Node.js 18 以上,CLI 代理指南另列有獨立執行檔。
| 項目 | 內容 |
|---|---|
| 發布日期 | 2026 年 11 月 18 日 |
| 安裝指令 | npm install -g @snap/easylens-cli@latest |
| 最新版本 | v0.2.99(2026 年 11 月 17 日) |
| 系統需求 | Node.js 18 以上,或改用獨立執行檔 |
| 支援平台 | Mac、Windows、Linux |
| 費用 | 免費,Snapchat 帳號登入 |
| 支援的編碼代理 | Claude Code、Codex、Cursor 與其他終端機代理 |
Snap 的發布公告列出超過 100 個 AR 建構元件與 50 個以上的 AI 素材產生器。代理可在同一個工作階段建置、測試、送審與查詢成效。
Easy Lens CLI 工作流程:組裝、預覽與送審

官方把 Easy Lens CLI 的工作流分成三段。Build 階段從超過 100 個 AR block 與 50 個素材產生器取材,block 是視覺與功能元件,代理用一份稱為 recipe 的 JSON 藍圖把它們組裝成 Lens;Test 階段在伺服器端渲染 MP4 預覽影片,並把 Lens 直接推到手機上試用;Publish 階段把成品送進 Snapchat 的審核與發布管線,成效追蹤也在同一個 session 完成。
easylens agent print 會印出內建指南。要追蹤臉部、手勢或在鏡頭上加效果,走 Recipe,讓代理用 JSON 藍圖組裝元件。要做全螢幕遊戲或互動工具,可走 Web Lens,將本機的 HTML、CSS、JavaScript 專案打包成 ZIP。
建置是非同步的。easylens lens build 送出 recipe 後立刻回傳一個 checkpoint id,成品稍後才生成,要用 –watch 或 lens watch 跟到結束,狀態欄位 asset_statuses.lens.status 落在 SUCCESS 或 ERROR 才算定案。代理指南同時定義了 exit code 契約,0 到 7 各有明確語義,3 代表未登入、5 代表建置失敗、6 代表被限流,代理依代碼分流處理,不必剖析文字輸出。
輸出契約對代理也友善。終端機直接看是表格,管線接收時自動換成 JSON,stdout 只放資料、進度一律走 stderr,因此 easylens lens get ID 重定向到檔案永遠乾淨。這些設計細節說明 Snap 做的不只是給人用的 CLI,而是給代理讀的介面,編碼代理與 CLI 之間不需要膠水程式碼。
預覽與交付物的規格也一併標準化。lens render 在伺服器端把建置結果渲染成 MP4,lens download 能把成品、圖示與預覽一次拉回本機,Web Lens 拿到的是一個 zip 壓縮檔,發布圖示固定是 320×320 的圓形規格。這些交貨格式直接寫在命令輸出裡,代理商要交付給客戶的素材清單可以對齊規格,不必逐案討論檔案形式。
整條工作流掛在一個稱為 conversation 的容器上。代理與 EasyLens 後端的每次互動都記錄在同一個對話裡,每一輪修改完成後回報 conversation 與 checkpoint 兩組識別碼,素材能在後續版本重複使用,發布指令也以對話為單位送出。官方 CLI 頁的第四個示範情境就是把這條線倒過來用:直接問代理我的 Lens+ Lens 哪些表現最好,據此決定下一個要做什麼,等於把選題與量產接在同一個終端機裡。
實機安裝實測:五分鐘接上 Claude Code

我在 macOS 上實際裝了一次,整個過程不到五分鐘。npm install -g @snap/easylens-cli@latest 跑完後,easylens –version 回報 0.2.99,與官方 CLI 頁標示的最新版一致。登入走 easylens auth login,瀏覽器跳出 Snapchat 的 OAuth 頁面,授權回來後憑證存在本機,CI 環境改用 EASYLENS_TOKEN 環境變數就能免互動登入。
接上編碼代理的關鍵命令是 easylens agent init。它把完整的操作指南寫成技能文件放進專案,內容涵蓋每個命令的用法、JSON 與 exit code 契約,以及會讓建置默默失敗的 recipe 陷阱;官方頁給 Claude 的提示詞另指定 –target claude 並要求保留既有專案指示。Codex 與 Cursor 用同一份指南就能驅動,差別只在各自載入專案指示的方式,Claude 的終端機設定流程可對照站上的Claude Code 完整教學。
# 1. 全域安裝最新版並確認版本
npm install -g @snap/easylens-cli@latest
easylens --version
# 2. 在專案內寫入 Claude Code 技能指南(Codex / Cursor 可省略或改目標)
easylens agent init --target claude
# 3. 瀏覽器 OAuth 登入一次(CI 環境改設 EASYLENS_TOKEN)
easylens auth login
# 4. 檢查可用 AR 元件
easylens blocks list
# 5. 準備好 recipe.json 後再建置並等待結果
easylens lens build recipe.json --watch

官方頁對第一次接觸的使用者給了一段可直接貼進代理的提示詞,內容就是完整的接線順序:安裝最新版、跑版本確認、執行 agent print 跟著內建指南走,沒有指南的專案就用 agent init 生成,需要登入時走 auth login,並保留既有的專案指示。把 onboarding 直接寫成一段 prompt,這個細節顯示 Snap 假設的使用者不是終端機重度玩家,而是把代理當成預設工作環境的新一代開發者。
命令面比預期完整,十五個頂層命令覆蓋從素材、建置到分潤的整條路,實測中最常被叫用的是十個核心命令。
| 命令 | 用途 |
|---|---|
| auth | 登入 EasyLens、檢視本機憑證 |
| blocks | 列出 AR 建構 block 與其輸入、事件、注意事項 |
| generators | 列出素材產生器與各自參數 |
| recipe | 產生、驗證、編輯 Lens 的 JSON 藍圖 |
| lens | 建置、渲染、下載、發布、刪除 Lens |
| profile | 帳號層級的 Lens 統計 |
| payouts | 查詢分潤加入資格、條款與收益 |
| leaderboard | 查詢公開的 Lens+ 排行榜,免登入 |
| doctor | 診斷憑證與連線問題 |
| agent | 把代理指南寫進專案或印到 stdout |
lens upload 儲存草稿,lens push 推到手機試用,lens publish 才送出發布審核。 內建指南要求代理在送審前取得明確同意。品牌素材可以先在手機上驗收,再決定何時送交 Snap。
easylens doctor 可檢查憑證與連線。代理指南另列有 HTTP 逾時預設值與 EASYLENS_OAUTH_CLIENT_ID 設定,使用自有 OAuth 的團隊可先核對指南。
免登入能做的事比預期多。實測 easylens leaderboard lenses 不需登入就回傳完整的 Lens+ 排行資料,含每個 Lens 的分類、預覽圖與影片連結,做市場調查時可以先用這個命令看哪些類型正在起量,再決定要做哪一種 Lens。
在乾淨的環境從零接線,最小安裝路徑只有五個動作,每一步都有對應的驗證點。
- 安裝 Node.js 18 以上,執行 npm install -g @snap/easylens-cli@latest。
- 執行 easylens –version,確認回報 0.2.99 以上。
- 執行 easylens auth login,在瀏覽器完成 Snapchat 登入。
- 在專案資料夾執行 easylens agent init –target claude,寫入代理指南。
- 對代理說出需求,例如做一個含計分板的 Web Lens 小遊戲。
和 Lens Studio CLAD 的分界:兩條 AI 產線
Snap 手上的 AI 建 Lens 路線其實有兩條,中文報導幾乎都把它們混在一起。Lens Studio 5.25 起內建 MCP 伺服器,搭配 CLAD 外掛讓 Claude Code 直接操作打開中的 Lens Studio 專案,官方文件要求 Lens Studio 先開著、專案已儲存,適合需要精細控制場景的團隊;Easy Lens CLI 則完全不裝 Lens Studio,用 block 與 recipe 在雲端後端組裝,走快速產品化路線。
兩者的工作條件差異很實際。CLAD 讓代理在 Lens Studio 的圖形介面裡逐步建場景,官方文件明載一次 Lens 建置會呼叫數百個工具,因此建議用 auto mode 讓代理不必逐步確認,一個完整 Lens 可能要三十分鐘以上;Easy Lens CLI 只要終端機與 npm,建置丟給雲端,本機只留 recipe 與預覽。選擇標準一句話就能說完:要動到 Lens Studio 等級的場景細節就上 CLAD,要在一天內驗證點子就用 CLI。
官方文件給的 CLAD 範例也勾勒出它的定位:對代理說出做一個元素週期表 Lens,在每個元素上顯示原子結構,代理就在 Lens Studio 視窗裡把場景與預覽逐步蓋出來,過程全程可見。這種精細度是 CLI 的 block 組裝給不了的,反過來說,CLAD 也沒有 CLI 那種從素材生成到成效查詢的一條龍命令。兩條線共用同一個 Snapchat 帳號與發布標準,團隊可以按專案混合使用。
官方文件同時提醒 auto mode 的使用前提。讓代理免確認連續工作前,專案要放在可還原的狀態,例如納入版本控制,因為數百次工具呼叫一旦方向錯了,回頭靠的是你自己的還原點。CLI 這邊的風險形態不同,素材與建置都在雲端對話裡,本機要顧好的只有 recipe 檔案的版本。
| 項目 | Lens Studio CLAD | Easy Lens CLI |
|---|---|---|
| 前置安裝 | Lens Studio 5.25 以上並保持開啟 | Node.js 18 以上,不安裝 Lens Studio |
| 連接方式 | MCP 伺服器加 CLAD 外掛 | npm 套件加內建代理指南 |
| 建置位置 | 本機 Lens Studio 專案內 | 雲端後端,本機留 recipe 與預覽 |
| 單一 Lens 耗時 | 完整 Lens 可能超過三十分鐘 | 取決於作品與渲染,發布另須審核 |
| 適合族群 | 要精細場景控制的專業開發者 | 要快速取得可試用版本的創作者 |
需要細調 Lens Studio 的場景與預覽,就從 CLAD 開始。適合用現成 AR 元件驗證的點子,或已有瀏覽器版的遊戲,較適合先用 CLI 試作。
一天上架的宣稱與實際時程
Snap 把「一天內從點子做到上線」列為可能的情境。官方示範的快速環節是反覆建置、渲染與推送手機。公開日期仍要看內容審核,接案時可分開估算「交付可試用版本」與「通過審核後上架」。
Snap 表示,CLI 作品採用與 Easy Lens 應用程式相同的內容檢查及審核流程。依官方 Lens+ 分潤 FAQ,加入分潤的作品先有 48 小時開放體驗,之後才轉為訂閱者專屬並開始累積分潤。要查看帳號的投稿額度,可執行 easylens lens quotas。
要進分潤的 Lens 另有兩個硬條件。可見度必須設為公開,且要附上有效的影片預覽,CLI 的工作流正好把這一步包進建置流程,代理用 lens render 產出預覽影片後一併送出,不必再自行剪片。分潤加入只能在送出發布的當下勾選,已上架的舊 Lens 事後不能補加入,這條規則讓「先隨便發布、之後再營利」的路走不通,商業專案從第一個 Lens 就要想清楚要不要進分潤。
台灣創作者可以使用 Easy Lens CLI、領 Lens+ 分潤嗎?
Snap 在 2026 年 11 月的發布公告表示,前一個月已向 Lens+ 社群創作者支付 180 萬美元。依官方分潤 FAQ,單個作品的月分潤分數須超過 100,分數由訂閱者互動和訂閱轉換決定,每個 Lens 各自計算。
分潤指標按月更新,月中看到零分可能只是尚未更新。一般曝光與分享能幫助作品被看見,分潤看的是符合條件的訂閱者互動與轉換。
Snap 會在 Rewards Hub 通知待入帳獎勵,官方 FAQ 說通常約 14 天可用。款項透過 Hyperwallet 處理,依分潤條款,累積達 100 美元後可申請提領。
截至 2026 年 11 月 22 日,Snap 的 Lens+ Payouts 資格名單包含日本、韓國、新加坡和菲律賓,台灣未列入。 申請人須年滿 18 歲、位於符合資格的地區,並通過 Snap 審核。製作與投稿請依 Snapchat 帳號可用功能操作,分潤地區以Lens Creator Rewards最新公告為準。
台灣團隊可先把 Lens 用於活動曝光或品牌接案,並以 lens insights 和 lens stats 查看互動。如果活動也有獨立落地頁,可先用免費 SEO 健檢檢查公開頁面的結構。需要讓活動資訊長期可搜尋,再評估AI 搜尋能見度與引用優化。
Easy Lens CLI 適合哪些作品?
遊戲開發者可以先拿現有瀏覽器遊戲測試 Web Lens。適配時優先驗證手機上的操作區、計分與分享流程。代理選型可對照Codex 與 Claude Code 的本機和雲端工作流,或按Codex 安裝指南先完成環境設定。
AI 創作者與內容團隊是第二種。素材產生器負責基礎素材,自備的模型、貼圖與音效可以經由 upload 命令綁進對話,風格不必遷就內建產生器。趨勢型的短週期內容特別適合這條路,官方的示範案例裡就有把當週流行元素轉成 Lens 的完整流程影片。
官方頁的畫廊給了具體的產能證據。Stadium Star、Disco Faces、Pixel Catch、Block Hop 這十來個作品全部標註為單一代理 session 完成,題材涵蓋臉部效果、小遊戲與教學型互動,每個都附 Snapchat 上的試用連結。對評估者來說,這份清單比任何宣稱都好用,直接點開試玩,就能判斷這條產線的品質是否符合你的品牌標準。
品牌團隊可以先把活動影片、產品圖與品牌色整理好,交給代理製作手機可試用的草稿,再讓客戶確認互動和素材。若團隊用T3 Code 管理編碼代理,仍要在工作指示中明確區分試用與公開送審。
EasyLens 官方影片演示如何把品牌活動素材做進可試用的 Snapchat Lens。
評估順序建議反著排:先用 leaderboard 看正在起量的類型,再用免費帳號做一個最小 Lens 驗證團隊工作流,最後才決定是否投入系列化產能。工具本身零成本,試錯的成本只落在代理的訂閱費用上,這筆帳在排產能前先算清楚。
Easy Lens CLI 常見問題
Easy Lens CLI 本身要付費嗎?
Snap 表示 Easy Lens CLI 可免費使用,使用 Snapchat 帳號登入即可開始。Claude Code、Codex 或 Cursor 的訂閱與 API 費用依各自方案計算。
完全不會寫程式也做得出 Lens 嗎?
可以先用白話描述要做的效果,讓代理處理素材和 recipe。使用 CLI 仍要安裝工具並登入。想做相機效果時,可先讓代理列出支援的 AR 元件,確認能否做到想要的追蹤或互動。
Easy Lens CLI 和網頁版 Easy Lens 有什麼不同?
網頁與手機版在 Easy Lens 自己的介面對話。CLI 讓 Claude Code、Codex 或 Cursor 呼叫建置與預覽指令,並在目前的專案中保留 recipe 或 Web Lens 原始碼。Snap 說明兩者採用相同的內容審核流程。
發布之後還能修改 Lens 嗎?
可以。CLI 指南列出 lens republish,可在原對話上傳修訂後送出更新。官方 Web Lens FAQ也明載網頁版全螢幕 Web Lens 支援原地更新並保留連結。
Windows 或 Linux 電腦也能用嗎?
可以,官方支援 Mac、Windows 與 Linux 三平台。npm 安裝路線要求 Node.js 18 以上,Windows 的 PowerShell 與 Mac 的終端機跑的是同一行 npm 指令;不想裝 Node 的環境改用獨立執行檔,官方代理指南提醒不要在同一個任務裡混用兩種安裝方式,避免執行路徑不一致。recipe 與專案檔跨平台互通,團隊混用作業系統不影響協作。
Lens 送出後多久會上線?
送出後要等 Snap 審核,官方公告沒有承諾固定上線時間。加入 Lens+ 分潤的 Lens 另有 48 小時開放體驗安排,之後才轉成訂閱者專屬。






討論與提問