1. 為什麼先做功課

第 1 篇提到，原版程式在每一支小程式裡都寫死了美股的規則。要改成台股版，最怕的不是程式寫不出來，而是規則本身搞錯：停損價設在不存在的價位、停利價超過漲停根本不可能成交、成本算漏了一半。這些錯誤不會讓程式當掉，只會默默給你錯的數字。

所以這一步的目標很單純：

1. 準備資料一鍵連上 FinMind
2. 固定規則寫給 Claude
3. 整理規則程式要知道的
4. 真實驗證拿資料比對
5. 選方案哪些要付費

2. 準備資料來源：FinMind 帳號，一鍵連上 Claude

原版用的是美股的免費資料，台股我選擇 FinMind。要讓 Claude 用它查資料，需要兩件事：一個 FinMind 帳號（和它的 token），以及把 FinMind 接到 Claude 上。

步驟 1：註冊 FinMind，複製 token

1. 到 FinMind 官網免費註冊，並完成 email 驗證（沒驗證的帳號 token 會無法使用）。
2. 登入後到會員頁面，複製自己的 token。先放在剪貼簿就好，不要貼到任何對話裡。

步驟 2：用一鍵安裝工具接上 Claude（Windows）

把 FinMind 接到 Claude，原本要手動改好幾個設定檔。為了讓初學者不用碰這些，我寫了一個一鍵安裝工具，放在 GitHub 上免費使用：

• 圖文教學：FinMind × Claude 一鍵安裝教學
• 工具下載：github.com/charlie711207/finmind-claude-setup

需要的東西：Windows 10 或 11、已安裝 Claude 桌面版（Claude Code 有裝就一起設定，沒裝會自動跳過），以及上一步複製的 token。

1. 下載：在 GitHub 頁面按綠色的 Code 按鈕 →「Download ZIP」，解壓縮後找到 setup_finmind.ps1。
2. 完全關閉 Claude 桌面版：在螢幕右下角系統匣的 Claude 圖示按右鍵，選「結束」。只關視窗不夠，因為工具要修改 Claude 的設定檔。
3. 執行：在 setup_finmind.ps1 上按右鍵，選「使用 PowerShell 執行」（不是直接雙擊）。
4. 貼上 token：畫面提示時貼上 token 並按 Enter。貼上時畫面不會顯示任何字，這是正常的保護設計。
5. 等它跑完：六個步驟完成後會顯示「全部完成！」。
6. 重新打開 Claude 桌面版。如果有開著的 Claude Code 或終端機視窗，也要關掉重開。

工具可以重複執行，不會產生重複設定。之後換 token 或換電腦，再執行一次就好。

步驟 3：確認接上了

在 Claude 桌面版開一個新對話，輸入：

用 FinMind 查一下 2330 的基本資料

如果回答裡有台積電的產業類別等資料，就代表接上了。

powershell -ExecutionPolicy Bypass -File .\setup_finmind.ps1

3. 寫一份給 Claude 的固定規則

每開一個新對話，Claude 都不記得上次說過什麼。像「台股資料一律用 FinMind」「不要跟我要 token」這種每次都適用的規則，可以寫進 Claude 的個人指示檔（CLAUDE.md），之後每個對話都會自動遵守。

一鍵工具已經自動寫入兩條基本規則。我在這個基礎上又多加了幾條，完整內容大致如下：

## FinMind
- FinMind API token 存在環境變數 FINMIND_TOKEN，程式一律從環境變數讀取。
- 不要向我要 token，也不要把 token 寫進任何檔案。
## 台股資料來源
- 台股資料（股價、K 線、三大法人、融資融券、月營收、財報、期貨選擇權）一律優先用 FinMind。
- 網路搜尋只用於新聞與事件解讀。
- 不同來源數字有出入時，以 FinMind 為準，並告訴我差異。

想加上後面幾條，直接請 Claude 幫你補：

在我的 Claude 個人設定（CLAUDE.md）補上以下規則，原本的內容保留：網路搜尋只用於新聞與事件解讀；不同來源的數字有出入時，以 FinMind 為準，並告訴我差異。

4. 程式需要知道的 9 條台股規則

準備好之後，我請 Claude 整理規則，而且每一條都要說明「程式要怎麼處理」：

要把這套美股 skill 改成台股版，幫我整理程式需要知道的台股交易規則。
每一條都說明：規則是什麼、跟美股差在哪、程式要怎麼處理。法規和費率請查證最新資料。

以下是整理後的結果（法規與費率為撰文時資料，請以官方最新公告為準）。

規則 1：交易時間

時區固定是台北時間（UTC+8），沒有夏令時間，比美股的紐約時間簡單很多。

規則 2：升降單位（價格跳動單位）

程式要處理三件事：

• 每個價格都要落在合法檔位上。30 元的股票，29.33 不是合法價格，只能是 29.30 或 29.35。
• 取整方向有講究。停損往下取（離進場價遠一點，不會因為取整而變緊），停利往上取（至少達到想要的報酬）。
• 跨價格區間會換單位。50.0 元往下一檔是 49.95，不是 49.9；49.95 往上一檔是 50.0，再上去是 50.1。

規則 3：漲跌停

漲跌幅限制是前一日參考價的 ±10%。計算方式：

• 漲停價 = 參考價 × 1.1，依升降單位無條件捨去。
• 跌停價 = 參考價 × 0.9，依升降單位無條件進位。
• 升降單位依「算出來的價格」所在的區間決定，不是依參考價。

程式要做的：進場價必須在漲跌停之間；停利價超過漲停就不可能成交，直接拒絕；停損價在跌停價或以下時要警告，因為鎖跌停時可能賣不掉。這條公式下一節會用真實資料驗證。

規則 4：張與零股

一張是 1,000 股，部位計算要以「張」為單位。不到一張的是零股，盤中零股另外交易，採集合競價：撮合間隔在 2024 年 12 月 2 日縮短為每 5 秒一次。零股的成交量通常小得多，不適合頻繁當沖，所以程式預設只算整張，零股要在設定中開啟。

規則 5：交易成本

舉例：一張 26.55 元買進、27.0 元賣出，手續費 6 折：買進手續費 22 元、賣出手續費 23 元、當沖證交稅 40 元，來回成本 85 元。這筆的價差獲利是 450 元，成本就吃掉將近兩成。原版完全沒有算成本，這是台股版一定要補的地方，第 4 篇會詳細看成本對策略的影響。

規則 6：當沖資格

現股當沖不是開戶就能做。依證交所規定，一般需要開戶滿 3 個月、最近一年成交 10 筆以上（已開立信用交易帳戶者不受此限），並向券商申請、簽署相關同意書與風險預告書。實際條件以你的券商為準。

程式的處理：設定檔裡有一個「我已確認有當沖資格」的開關，預設是關閉。沒打開之前，風控會擋下所有當沖單。這是刻意的設計，第 5 篇會說明。

規則 7：暫停先賣後買

先賣後買（先賣出、再買回）屬於放空性質。遇到除權息、股東會、現金增資、ETF 分配收益等情況，個股會被暫停先賣後買一段時間。台股版第一階段只做「先買後賣」，先賣後買一律擋下。

規則 8：處置股

股價波動異常的股票會被列為處置股，處置期間改成分盤集合競價（例如每 5 分鐘或 20 分鐘撮合一次）。這時「開盤 15 分鐘突破高點」的邏輯完全失效。例如 2455 在 2026 年 11 月 11 日到 17 日是處置期間。程式預設擋下處置股。

規則 9：休市日

FinMind 的交易日曆會列出整個年度的交易日，包含未來的日期，所以程式可以事先知道哪天休市（例如 2026 年 10 月 9 日國慶連假）。但颱風假這類臨時休市無法事先得知，這點要記得。

5. 驗證：漲跌停公式對不對？

網路上漲跌停的算法有好幾種寫法，「捨去還是進位」「用參考價還是算出來的價格決定升降單位」很容易搞錯。所以我請 Claude 不要只是相信自己整理的公式：

用 FinMind 的漲跌停資料（TaiwanStockPriceLimit），驗證你整理的漲跌停公式。
至少涵蓋每一個升降單位的價格區間，也要包含 ETF。每一筆都比對，有任何不符就告訴我。

有兩筆最有代表性：

• 2884：參考價 47.6 在「10–50 元，一檔 0.05」的區間，但算出來的 52.36 已經跨進「50–100 元，一檔 0.1」，要用 0.1 捨去，得到 52.3。如果誤用參考價的升降單位（0.05），會算成 52.35，而這在 50 元以上根本不是合法價格。
• 0050：ETF 在 50 元以上一檔 0.05，所以 107.195 捨去成 107.15。如果把它當一般股票（100 元以上一檔 0.5），會算成 107.0，差了三檔。

這些細節光看公式很難發現，用真實資料一比就清楚了。

順便查清楚的幾件事

• 交易日曆含未來日期：查 2026 年 10 月到 2027 年 2 月，FinMind 已經列出未來的交易日。
• 台股代號可能帶英文字母：例如 00980D、00679B（債券 ETF）。程式判斷代號格式時要允許，不能只收 4 位數字。
• 處置股、暫停先賣後買的資料要 Backer 方案：漲跌停和交易日曆是免費的。

6. 資料集與方案怎麼選

把每個功能需要的資料對應到 FinMind 的資料集，就知道哪些要付費（資料集名稱是 FinMind 裡的正式名稱，請 Claude 查資料時可以直接用）：

價格與內容請以 FinMind 官網為準。

我的決定

• 第一階段只用免費資料就能完成。停損停利、計算張數、風控需要的漲跌停和交易日曆都是免費的。
• 拿不到的資料，程式要誠實說出來。例如沒有 Backer 方案查不到處置股，風控會顯示「無法確認是否為處置股」的警告；想更嚴格，也可以設定成「拿不到資料就擋下」。
• Sponsor 等到第三階段（盤中）再升級。沒必要一開始就付最貴的方案。
• Yahoo 只當備援。Yahoo 也有台股的分 K（代號寫成 2330.TW），但有延遲且非官方。

7. 這一步學到的事

8. 你可以照著說的話

用 FinMind 查一下 2330 的基本資料

確認一下環境變數 FINMIND_TOKEN 有沒有設定好。只要告訴我有或沒有，不要顯示內容。

在我的 Claude 個人設定（CLAUDE.md）補上以下規則，原本的內容保留：網路搜尋只用於新聞與事件解讀；不同來源的數字有出入時，以 FinMind 為準，並告訴我差異。

要把這套美股 skill 改成台股版，幫我整理程式需要知道的台股交易規則。每一條都說明：規則是什麼、跟美股差在哪、程式要怎麼處理。法規和費率請查證最新資料。

用 FinMind 的漲跌停資料（TaiwanStockPriceLimit），驗證你整理的漲跌停公式。至少涵蓋每一個升降單位的價格區間，也要包含 ETF。每一筆都比對，有任何不符就告訴我，並把資料存成之後的測試資料。

列出每個功能需要的 FinMind 資料集和方案。我現在的方案查得到哪些？查不到的，程式應該怎麼處理？

常見問題

tick_size(price, etf)        # 升降單位
floor_tick / ceil_tick       # 往下／往上取到合法檔位（停損／停利）
next_tick / prev_tick        # 上一檔／下一檔（自動跨區間）
price_limits(reference, etf) # (漲停價, 跌停價)
round_trip_cost(...)         # 買賣手續費 + 證交稅
loss_at_stop / net_reward_risk
# FinMind API（token 放在 Authorization 標頭）
GET https://api.finmindtrade.com/api/v4/data?dataset=TaiwanStockPriceLimit&data_id=2603&start_date=2026-11-13&end_date=2026-11-13

下一篇預告

規則整理好、資料也驗證過了，終於要開始寫程式。下一篇會說明為什麼我決定「重寫」而不是修改原版，以及台股版的停損停利和張數計算。最讓我意外的發現是：一個看起來報酬風險比 1:1 的計畫，扣掉交易成本後，只剩 0.62。

本文僅為軟體工具教學與開發經驗分享，不構成任何投資建議。當沖風險極高，請自行評估並為自己的交易決策負責。文中法規、費率、方案價格以撰文時為準，請以證交所、券商與 FinMind 官方最新公告為依據。