指令列工具 CLI

FinLab CLI 透過 python -m finlab 使用：在終端機登入帳號、跑出第一份回測、問 AI 助理，或把策略部署到雲端，每天定時自動執行。

安裝並登入

安裝或更新 FinLab：

pip install -U finlab

登入 FinLab 帳號：

python -m finlab login

查看登入狀態：

python -m finlab status

跑出第一份回測

python -m finlab quickstart

沒登入時先開瀏覽器登入，再把 finlab_quickstart.py 寫到目前資料夾、執行它，並開啟 finlab_quickstart.html 報告。檔案已存在時不會覆蓋，直接執行你改過的版本。加 --market us 改跑美股（finlab_quickstart_us.py）。

讓策略每天在雲端自動執行

把策略部署到雲端後，可以設定每日自動執行時間，也可以手動觸發執行、查看執行紀錄與本月用量。

雲端策略程式碼會在獨立容器中執行，容器內已預裝 FinLab SDK。策略 ID 必須以英文字母或數字開頭，只能包含英文字母、數字、.、_、-，最長 64 個字元。排程時間使用 HH:MM 格式，時區為 Asia/Taipei。

python -m finlab login

python -m finlab cloud deploy my-strategy --code strategy.py --time 09:30 --tier s

python -m finlab cloud run my-strategy

python -m finlab cloud logs my-strategy --limit 5 --show-output

方案限制

雲端策略執行會依方案限制可用 tier 與策略數量。可以用 python -m finlab cloud status 查看目前帳號允許使用的 tier 與本月執行次數。

如果部署時沒有指定 --tier，新策略會使用帳號方案的預設 tier；更新既有策略時，若該策略已經有 tier，則會保留原本設定。Free 使用者不能部署雲端策略。

各 tier 的規格：

部署單一檔案或多檔案策略

可以部署單一 Python 檔，也可以部署 zip 壓縮檔形式的多檔案策略。

python -m finlab cloud deploy my-strategy --code strategy.py

python -m finlab cloud deploy zip-strategy --zip strategy.zip --entry-script main.py --tier m

--code 和 --zip 只能擇一使用。Inline 程式碼上限為 256 KiB；zip 壓縮檔上限為 5 MiB，解壓後上限為 50 MiB，最多 100 個檔案。

可用選項：

加入參賽

python -m finlab cloud deploy my-strategy --code strategy.py --time 09:30 --contest --contest-alias TeamA

參賽策略需要在排程執行時產生並上傳回測報告，例如使用 sim(..., upload=True)。手動執行 cloud run 不會納入參賽計算。

設定執行頻率

設定每日自動執行時間：

python -m finlab cloud schedule set my-strategy 14:30

改成每週、每月或自訂 cron：

python -m finlab cloud schedule set my-strat 09:00 --frequency weekly --days-of-week 1,5
python -m finlab cloud schedule set my-strat 09:00 --frequency monthly --day-of-month 31
python -m finlab cloud schedule set my-strat --frequency custom --cron '0 9 * * 1-5'
python -m finlab cloud deploy my-strat --code strategy.py --time 09:00 --frequency weekly --days-of-week 1,5

• 全部以台北時區執行，不自動判斷休市日；每月不存在的日期會跳過。
• 未指定頻率時，新排程每日執行，既有排程保留頻率。
• 星期使用 0（週日）到 6（週六）。
• Cron 使用五欄數字：分、時、日、月、星期，支援 *、逗號、範圍與步長；同時指定日期與星期時，任一符合就執行。

移除每日排程：

python -m finlab cloud schedule delete my-strategy

手動執行與換規格

策略必須已部署；同一策略的手動觸發限制為每小時 5 次。也可以只針對這次手動執行覆寫規格：

python -m finlab cloud run my-strategy --tier m

查看執行紀錄

查看策略近期執行紀錄，包含狀態、執行時間和費用。狀態可能為 queued、running、success、error、timeout、quota_exceeded。

python -m finlab cloud logs my-strategy

查看與刪除策略

列出目前登入帳號的雲端策略（加 --limit 500 最多列出 500 個）：

python -m finlab cloud list
python -m finlab cloud list --limit 500

取得單一策略的中繼資料。Inline 策略會顯示程式碼；zip 策略只會顯示中繼資料和進入點檔案，原始碼仍保存在雲端儲存空間：

python -m finlab cloud get my-strategy

只輸出 inline 策略程式碼，適合重新導向到檔案或搭配其他工具處理：

python -m finlab cloud get my-strategy --code-only

刪除策略、中繼資料、程式碼和排程，執行紀錄會保留；加 -y 略過刪除確認提示：

python -m finlab cloud delete my-strategy
python -m finlab cloud delete my-strategy -y

查看本月額度

查看本月雲端執行使用量、允許使用的 tier 和執行次數，或查詢指定月份：

python -m finlab cloud status
python -m finlab cloud status --month 2026-04

登入與憑證

在終端機問 AI 助理

在終端機直接問 FinLab AI 助理：套件用法、回測報錯、資料口徑、帳號與方案。對話與網站客服共用同一份紀錄與每月 200 則提問額度（台灣時間每月 1 日 00:00 重置），使用前需要先登入。

問問題

問一個問題，回覆出現前會持續等候：

python -m finlab ai "怎麼抓月營收？"

把錯誤訊息或程式一起送出：

python my_strategy.py 2>&1 | python -m finlab ai "這個錯誤怎麼修？"

不帶問題就進入對話模式，可以直接貼上多行內容，輸入 exit 離開：

python -m finlab ai

按 Ctrl+C 只會停止等候，提問仍會處理。

查看先前的問答

查看最近一則問答，還在處理就繼續等候：

python -m finlab ai --last

列出最近 10 則提問，或指定筆數；清單包含提問 ID、建立時間、狀態與題目摘要，依時間由新到舊排列：

python -m finlab ai --history
python -m finlab ai --history 50

用清單中的 ID 讀取指定提問與所有回覆，包含事後追加的案件進度通知：

python -m finlab ai --show <提問ID>

--history 與 --show 讀取當下紀錄，不等候處理完成；查詢只限目前登入的帳號。

讓自己的 agent 解析結果

加上 --json 可讓自己的 agent 解析結果：

python -m finlab ai --history 50 --json
python -m finlab ai --show <提問ID> --json
python -m finlab ai --last --json
python -m finlab ai "我先前回報的問題目前處理到哪裡？" --json

--history --json 輸出 {"messages": [...]}；其他模式輸出一則完整提問物件，含 id、text、status、createdAt、updatedAt 與 replies 陣列。JSON 保留完整題目與全部回覆。送出問題與 --last 會等候完成後才輸出一個 JSON 物件，進度提示寫到 stderr；請勿將 stderr 合併到 stdout。送出問題仍適用每月 200 則與至少 10 秒的間隔限制。--json 須搭配問題或查詢選項，不用於互動對話。

助理只回答 FinLab 相關問題。提醒後仍重複送出與 FinLab 無關或無意義的內容，或送出惡意內容，帳號會被停用 AI 助理。

安裝 AI 工具的 FinLab skill

python -m finlab skill install

從 finlab-ai 下載最新版 skill 到 ~/.agents/skills/finlab（Codex、Cursor 讀這裡），有 Claude Code 時也寫入 ~/.claude/skills/finlab。不需要 Node.js，重新執行就會更新。

下一步