這一篇是使用說明書:怎麼把 12 個工具裝進 Claude、怎麼填自己的資金與風控設定、一個交易日從開盤前到平倉怎麼用,以及盤中會跳出哪些訊息、看到時該怎麼做。
跟著 Claude 把美股當沖 skill 改成台股版・第 10 篇
安裝與設定教學:讓整套台股版跑起來,以及盤中會看到哪些訊息
前九篇記錄了開發過程,這一篇是使用說明書:怎麼把 12 個工具裝進 Claude、怎麼填自己的資金與風控設定、一個交易日從開盤前到平倉怎麼用,以及盤中會跳出哪些訊息、看到時該怎麼做。
關於下載
台股版程式會在整個系列完成後整理好放上 GitHub。本篇先說明完整的安裝與使用方式,公開時會在這裡補上下載連結。
1. 開始前要準備什麼
| 項目 | 說明 | 參考 |
|---|---|---|
| Claude 桌面版 | 付費方案(撰文時 Pro 以上),使用 Code 分頁 | 第 2 篇 |
| Python | 3.8 以上,只用標準函式庫,不必另外安裝套件 | 第 2 篇 |
| FinMind 帳號+連接 | 用一鍵安裝工具設定 token、連接 Claude | 第 3 篇 |
| 券商帳戶 | 確認有現股當沖資格;建議先用模擬交易 | 第 3、9 篇 |
FinMind 方案決定你能用到哪些功能
| 方案 | 可以用的工具 |
|---|---|
| Free | 停損停利、計算張數、風控、新聞、基本面、籌碼、下單單據;掃描只能逐檔;處置股只會警告 |
| Backer | 再加上全市場掃描、處置股檢查 |
| Sponsor | 再加上盤中進場判斷、即時報價提醒、Time Machine 模擬 |
2. 安裝:把工具放進 Claude
12 個資料夾
台股版一共 11 個 skill,加上一個大家共用的 tw-common(台股規則、FinMind 讀取)。tw-common 一定要一起裝,它不會出現在選單裡,但其他 skill 都要靠它。
| skill | 做什麼 | 什麼時候用 |
|---|---|---|
| tw-scanner | 盤前掃描,產生觀察清單 | 開盤前 |
| tw-news | 新聞整理(台北時間、標籤) | 開盤前、盤中 |
| tw-analyst | 月營收、財報、除權息 | 開盤前 |
| tw-chips | 三大法人、融資融券、當沖比例 | 開盤前 |
| tw-entry | 開盤區間突破的進場判斷 | 09:15 之後 |
| tw-exit | 停損停利規劃 | 觸發後、下單前 |
| tw-timemachine | 10,000 次模擬+歷史(扣成本) | 下單前 |
| tw-budget | 計算張數 | 下單前 |
| tw-risk | 風控 PASS/BLOCK | 下單前(一定要) |
| tw-broker | 下單單據、同意與成交紀錄 | 下單、平倉 |
| tw-alerts | 停損、停利、平倉提醒 | 成交後 |
安裝步驟
- 在 Claude 桌面版的 Code 分頁,打開你的交易專案資料夾(例如「台股當沖」)。
- 把下載的台股版資料夾放進專案裡,然後對 Claude 說:
把台股版資料夾裡所有 tw- 開頭的資料夾(包含 tw-common)安裝到這個專案的 .claude/skills,然後幫我確認 11 個 skill 都有 SKILL.md。
- 開一個新的對話(新安裝的 skill 要開新對話才會載入),在對話框輸入
/tw-,應該會看到 11 個 skill。
一定要在同一個專案資料夾使用
工具會把資料存在專案裡的 trader/ 資料夾(設定、觀察清單、計畫、紀錄)。如果在別的資料夾開 Claude,它會找不到你的設定和紀錄。
想讓所有專案都能用,也可以裝到個人的 skills 資料夾;但建議先裝在單一專案,熟悉後再說。
3. 設定:先在冷靜的時候寫好規則
所有規則都在 trader/config.json 這個設定檔裡。第一次使用時,直接請 Claude 帶你填:
幫我建立 trader/config.json:從 tw-budget 資料夾裡的 config.example.json 複製一份,然後逐項用白話問我要填多少。
| 設定 | 範例值 | 意思 |
|---|---|---|
| budget | 300,000 | 這套方法可以動用的資金。只能是輸得起的錢 |
| cash_buffer_pct | 10 | 永遠保留的現金比例(%) |
| max_loss_per_trade_twd | 1,500 | 一筆停損出場最多虧多少,含手續費和證交稅 |
| max_daily_loss_twd | 4,500 | 今天所有進場「如果都停損」最多虧多少 |
| max_trades_per_day | 3 | 每天最多進場幾筆 |
| min_reward_risk_after_cost | 1.0 | 扣成本後報酬風險比的下限 |
| no_entries_before/after | 09:15/13:00 | 幾點之前、之後不進場 |
| flat_by | 13:20 | 幾點前一定平倉(13:25 起是收盤集合競價) |
| fee_discount | 0.6 | 券商手續費折扣(6 折填 0.6) |
| daytrade_eligible | false | 向券商確認有當沖資格後才改成 true,否則風控會擋下所有當沖單 |
| paper | true | 模擬帳戶。改成 false 代表實盤,請自己決定 |
| allow_odd_lot | false | 買不起一張時要不要改算零股(流動性差) |
規則只在盤後改
這些數字是給「盤中情緒最差的你」看的。盤中為了做某一筆而改規則,正是風控要防止的事。
4. 一個交易日怎麼用
| 時間 | 做什麼 | 對 Claude 說 |
|---|---|---|
| 開盤前(08:00 左右) | 掃描、看新聞、基本面、籌碼 | 「做今天的盤前早報」 |
| 09:00–09:15 | 開盤區間形成中,先不要動 | 「現在是什麼交易階段?」 |
| 09:15–13:00 | 盯觀察清單,等收盤站上區間高點 | 「每 5 分鐘檢查觀察清單有沒有觸發」 |
| 觸發後 | 停損停利 → 模擬 → 張數 → 風控 → 單據 | 「2409 觸發了,幫我從停損停利一路跑到風控」 |
| 你決定要做 | 明確同意,自己在券商 App 送出 | 「確認下單第 1 筆」→ 送出後「已送出」→ 成交後「成交價 29」 |
| 成交後 | 設停損停利條件單或開提醒 | 「依計畫設提醒,每 2 分鐘檢查一次」 |
| 13:20 前 | 還沒出場的一定要平倉 | 「幫我產生 2409 的平倉單」 |
| 收盤後 | 看今天的紀錄與已實現損益 | 「今天做了哪些?損益多少?」 |
Claude 會依照各個 skill 的說明書,自己決定要執行哪個工具。你只要用白話說出想做的事;想指定工具,也可以直接打 /tw-entry 2409 這樣的指令。
5. 盤中會看到的訊息
以下是各工具在盤中會出現的訊息(範例取自 11/12、11/13 的真實資料回放),以及看到時該怎麼做。
進場判斷
| 訊息 | 代表什麼 | 你該做什麼 |
|---|---|---|
| 開盤區間還在形成 | 還沒到 09:15,區間高低點還沒確定 | 等 |
| 等待中,還差 X(−Y%) | 最新一根收完的 K 棒還在區間高點下面 | 等;可以讓 Claude 定時檢查 |
| 那根還在形成;收完之前不算 | 盤中價格可能已經站上,但 K 棒還沒收完 | 不要追,等它收完 |
| 觸發 HH:MM,價格 X | 第一根收盤站上區間高點的 K 棒 | 進入停損停利 → 張數 → 風控的流程 |
| 觸發已過 N 根 K 棒……晚進場是另一筆交易 | 你發現得太晚,價格已經離觸發價很遠 | 重新規劃,或放棄這筆 |
| 鎖漲停……這個型態今天不會觸發 | 開盤區間高點就是漲停價 | 從清單移除,不用再盯 |
| 已過最晚進場時間 | 13:00 之後沒有觸發 | 今天這檔不做 |
| 分 K 尚未更新;即時快照……無法確認 K 棒收盤 | 分鐘資料還沒更新,只能看到目前成交價 | 等下一次檢查,不要用快照價格判斷觸發 |
實際畫面(2409 在 11/12,09:19 與 09:20):
等待中 最新完成的 K 棒(09:10)收 28.8,距離 28.85 還差 0.05(-0.17%)。
09:15 那根還在形成(目前 28.9,09:20 收);收完之前不算。
觸發 09:20,價格 29:09:15 那根 K 棒收盤站上 28.85(+0.52%)。
如果要做,這就是進場時點。沒有下任何單。
一次檢查整份觀察清單(11/13 10:30):
2330 等待(差 -0.63%)
2454 鎖漲停(開盤區間高點 = 漲停價,不會觸發)
3443 鎖漲停(開盤區間高點 = 漲停價,不會觸發)
3017 觸發 09:25 @ 3045
3374 鎖漲停(開盤區間高點 = 漲停價,不會觸發)
2891 觸發 09:25 @ 78
觸發之後:不是每一筆都能做
2891 在 09:25 以 78 觸發。停損放區間中點 76.3,看起來很合理,但計算張數時:
不下單:買不到一張:1 張 1000 股在 78 買進、停損 76.3,虧損含成本 1,945 元,超過每筆上限 1,500 元。可改用更近的停損、提高每筆最大虧損,或在設定開啟零股(allow_odd_lot,流動性較差)
這是很常見的情況:觸發了,但一張的風險超過你的上限。不要為了做這筆而提高上限。同一筆的 Time Machine 也顯示,93.9% 的模擬到 13:20 都沒碰到停利或停損,代表這檔股票平常波動不大,2.18% 的停損對它太寬:
先停利 0.6 %
先停損 5.5 %
都沒碰到 93.9 % 到 13:20 仍未出場
有 93.9% 的模擬到平倉時間都沒碰到停利或停損,這些由平倉時的價格決定。
風控與下單
| 訊息 | 代表什麼 | 你該做什麼 |
|---|---|---|
| 擋下:尚未確認你有現股當沖資格 | 設定的 daytrade_eligible 還是 false | 向券商確認資格後,盤後再改設定 |
| 擋下:今天累計風險……會超過每日上限 | 今天的額度用完了 | 今天收手 |
| 擋下:……處置中 | 處置股,分盤撮合 | 不做 |
| 注意:停損只存在計畫裡 | 台股沒有交易所停損單 | 成交後設條件單或開提醒 |
| READY | 通過風控,單據可以用 | 決定要不要做;要做就明確同意 |
| 不能下單:指紋不符 | 委託在風控後被改過 | 重新跑風控 |
提醒
台北時間 09:30,盤中連續交易。 !2409 停利 30.1:成交價 30.3 ≥ 30.1
台北時間 13:20,盤中連續交易。 !2409 平倉時間 13:20:還沒出場的部位現在要賣掉
!2409 停損 28.45:成交價 28.4 ≤ 28.45。委買是空的,可能鎖跌停、賣不掉。台股沒有交易所停損單,請立刻自行出場或確認條件單已成交
最後一行停損提醒是測試用的模擬情境,不是 11/12 的實際走勢。
| 提醒 | 你該做什麼 |
|---|---|
| 停利 | 照計畫賣出(或確認條件單已成交),記錄成交 |
| 停損 | 立刻出場,不要等反彈;委買空的時候特別小心 |
| 平倉時間 | 還沒出場的部位現在就賣,避免當沖沒沖掉要交割 |
6. 讓 Claude 幫你盯盤
Claude Code 有一個 /loop 功能,可以每隔一段時間自動做同一件事:
/loop 5m 檢查觀察清單前 10 檔有沒有開盤區間突破,有觸發就告訴我時間和價格
/loop 2m 檢查我的價格提醒,有響就告訴我要做什麼
- 電腦要保持不休眠,Claude 桌面版要開著。
- 盯盤只會通知,不會下單。觸發之後的停損停利、風控、同意、送出,都要你在場。
- 檢查間隔決定反應速度:2 分鐘檢查一次,兩次之間的高低點不會被看到。
7. 常見問題與排解
輸入 /tw- 沒有出現任何 skill?
開一個新的對話再試。還是沒有,請 Claude 檢查:「.claude/skills 底下有沒有 tw-entry/SKILL.md?我目前開的是哪個資料夾?」
出現「No module named tw_market」之類的錯誤?
tw-common 沒有一起安裝。把 tw-common 資料夾也放進 .claude/skills。
出現「Token is illegal」或查不到資料?
重新執行 FinMind 一鍵安裝工具,並把 Claude 桌面版完全關閉再打開(第 3 篇)。
盤中說「沒有足夠的分 K 資料」?
分鐘資料需要 FinMind Sponsor 方案;有方案的話,可能是資料還沒更新,等下一次檢查。
風控一直擋下「尚未確認你有現股當沖資格」?
這是刻意的預設。向券商確認有資格後,盤後把設定的 daytrade_eligible 改成 true。
資料存在哪裡?要怎麼重來?
都在專案的 trader/ 資料夾:config.json 是設定,watchlist.json 是觀察清單,plan.json、orders.json 是當天的計畫與委託,state/ 裡是紀錄與資料快取。想重來,保留 config.json,其餘可以請 Claude 幫你清掉。
工具會自動下單嗎?
不會。程式沒有任何送單能力,最後一定是你親手在券商 App 送出(第 9 篇)。
還在驗證中的部分
本篇範例是用歷史資料回放的。盤中分鐘資料的實際更新速度,會在下一個交易日實測後補充在這裡;工具在資料還沒更新時,會明確顯示「分 K 尚未更新」,不會假裝有資料。
8. 你可以照著說的話
做今天的盤前早報:掃描、觀察清單前 10 檔的新聞、月營收和三大法人。
現在是什麼交易階段?下一次開盤是什麼時候?
檢查觀察清單前 10 檔有沒有開盤區間突破,哪些鎖漲停可以先移除?
2409 觸發了:幫我設停損停利、跑 Time Machine、算張數、跑風控,最後給我下單單據。
確認下單第 1 筆。
我已經在券商送出了,成交價 29,幫我記錄並依計畫設提醒。
幫我產生 2409 的平倉單,限價 30.1。
今天做了哪些?已實現損益(含成本)多少?還剩多少每日額度?
進階:給習慣終端機的讀者
# 在專案資料夾執行(trader/ 是相對路徑)
K=.claude/skills
python $K/tw-alerts/alerts.py clock
python $K/tw-scanner/scan.py universe && python $K/tw-scanner/scan.py daily
python $K/tw-news/news.py && python $K/tw-analyst/facts.py && python $K/tw-chips/chips.py
python $K/tw-entry/entry.py watchlist # 或 watch 2409
python $K/tw-exit/exit.py plan --write
python $K/tw-timemachine/timemachine.py run --write
python $K/tw-budget/size.py --write
python $K/tw-risk/check.py
python $K/tw-broker/ticket.py show
python $K/tw-alerts/alerts.py add --from-plan && python $K/tw-alerts/alerts.py check
每個工具都支援 --now "YYYY-MM-DD HH:MM"(台北時間);搭配 --offline 目錄 可完全離線回放。trader/ 的檔案:config.json、universe.json、watchlist.json、entry.json、plan.json、timemachine.json、orders.json、prices.json、portfolio.json、alerts.json、state/(risk、broker、alerts、news 紀錄與 tw_cache 資料快取)。
下一篇預告
寫到這裡,有讀者會問:進場判斷只有一條固定規則,能不能比較不同的參數,看哪一組在過去比較好?Time Machine 只能看一檔、一組設定,不夠用。下一篇是延伸開發:回測引擎。說明為什麼需要它、它怎麼用多檔股票、多組參數、扣掉成本做回測,以及怎麼避免把參數調成「只是剛好符合過去」。
本文僅為軟體工具教學與開發經驗分享,不構成任何投資建議。文中範例為歷史資料回放,不代表買賣建議,也不代表此方法能獲利。當沖風險極高,請自行評估並為自己的交易決策負責。資料與方案以撰文時為準。









