【2026 最新】Claude Code OfficeCLI 教學：Excel 到 PowerPoint 的 6 步驗收流程

Claude Code OfficeCLI 真正適合做的，不是把一句「幫我做簡報」丟給 AI，而是把 Excel 裡的事實、企業模板與 PowerPoint 驗收拆成可重跑的管線。這篇會帶你從來源工作簿出發，讓 Claude Code 用 OfficeCLI 讀取數字、編排投影片、逐頁渲染，再分開完成視覺與資料檢查。

這個需求不是紙上談兵。2026 年 8 月 17 日一篇 r/consulting 討論中，發文者要的是把自己寫好的內容與 Excel tracker 排成簡報，還特別說不信任 Claude 代寫內容。這篇也採同一條界線：AI 負責製作與檢查，不替你發明商業事實。

先說結論：可交付簡報＝事實層＋簡報契約＋雙重驗收

本文的錨點是：可交付簡報＝Excel 事實層＋簡報契約＋Render→看→修＋資料／結構驗收＋人工終審。Excel 是唯一數字真相來源；Claude Code 是協調者；OfficeCLI 負責讀寫 Office 檔與逐頁 render；PowerPoint 則是最後交付環境。

• 事實層：每個營收、日期、分母、單位與標籤都能回到指定儲存格。
• 簡報契約：先鎖頁數、頁面問題、標題語法、品牌規則與不可改寫欄位。
• 視覺驗收：逐頁 render 成 PNG，檢查溢位、對比、留白與一致性。
• 資料驗收：圖表與 KPI 另行回查來源；「看起來合理」不算通過。
• 人工終審：在收件者實際使用的 PowerPoint 版本開檔，檢查字型、連結、母片與隱藏資料。

這套方法和金字塔原理互補：金字塔原理決定先講哪個結論，這裡則確保結論背後的數字、版面與檔案都能被驗收。

Claude Code OfficeCLI 是哪一套？先避開同名陷阱

本文固定使用開源的 iOfficeAI/OfficeCLI，官網入口是 officecli.ai，目前 Homebrew Core formula 也指向這個 repo。它提供 create、get、add、set、view screenshot 與 validate，正好能完成 Excel→PPTX→逐頁看圖的工作流。

另一個 officecli/officecli／officecli.io 是不同產品：它使用 officecli new pptx、Hosted credits 與 External runtime。它公開的安裝／文件／Skill repo 採 MIT，但 README 明言不含完整 CLI 實作，因此不能把該 repo 的 license 直接套到分發 binary。兩者名稱與執行檔相同，卻不能混用安裝量、授權、版本或指令。本文不使用 new pptx、--local-preview 或 score pptx。

截至 2026 年 8 月 23 日，本文查證版本為 1.0.144；實際操作仍以你安裝後的 officecli --version 與 officecli help 為準。官方 Skill 也明確規定：Skill 與 help 不一致時，安裝版 help 才是權威。

Claude Code OfficeCLI 安裝：一條 Homebrew 路徑就好

步驟 1：安裝二進位，確認來源與版本

痛點不是「裝不起來」，而是同名二進位或多重 PATH 讓你跑錯產品。macOS／Linux 讀者可以只用 Homebrew Core：

brew install officecli

command -v officecli
officecli --version
brew info officecli

可觀察的完成條件是：Homebrew 首頁指向 iOfficeAI/OfficeCLI，版本可正常回傳，而且 PATH 沒有另一個 officecli 搶在前面。官方 README 把直接下載版描述成 self-contained binary；Homebrew Core 的目前 formula 則依賴 dotnet，不要把兩種包裝方式寫成同一件事。

view screenshot 並未內嵌瀏覽器。v1.0.144 會依序嘗試 Playwright CLI、Chrome／Edge／Chromium、Firefox；全都不存在時會回報 no headless backend available。macOS／Linux 應在製作前先跑一頁 smoke test；Safari 不在支援清單。這項前置條件可在截圖後端原始碼核對。

步驟 2：只把 OfficeCLI umbrella Skill 安裝到 Claude Code

OfficeCLI 是第三方工具，不是 Anthropic 官方外掛。二進位已交給 Homebrew 管理後，下面的精準子命令只安裝 umbrella base Skill，不處理 binary、PATH 或 MCP：

officecli skills claude

重新開啟 Claude Code 專案後，用 /skills 確認 officecli；接著把下面文字當成給 Claude 的提示：

開始讀取 Excel 前，請你透過 Bash 執行 `officecli load_skill excel`，
完整閱讀並遵守輸出；開始處理 PowerPoint 前，再執行
`officecli load_skill pptx`，完整閱讀並遵守輸出。

load_skill 只把內嵌 Skill 印到標準輸出，不會安裝或永久載入；若人在 Claude Code 對話外的普通 Terminal 執行，內容不會自動進入 Agent 上下文。再檢查 Skill 允許哪些 shell 操作；Claude Code 的權限規則由用戶端執行，避免用 --dangerously-skip-permissions 省略審核。想先理解模型、工具與停止條件，可以讀AI Agent Harness與自己做 Agent Harness。

步驟 3：先核對資料路徑，不要把「本機」寫成「離線」

iOfficeAI/OfficeCLI 對本機 Office 檔的主要讀寫與 render 發生在本機，但「本機」不等於「零網路」：預設更新檢查會連線；含方程式、Mermaid 或 3D 內容的 preview／screenshot 可能從 d.officecli.ai 或 jsDelivr 載入 KaTeX、Mermaid、Three.js；若操作中指定 HTTP(S) 圖片或檔案網址，CLI 也會下載該來源。Claude Code 另會把提示、納入上下文的檔案內容與工具結果送到模型服務。若公司處理敏感資料，先由資安／法務確認帳戶、端點、留存、第三方 Skill、遠端素材與更新政策，再放真實工作簿。先用虛構資料跑通，不要把「OfficeCLI 本機處理」誤寫成整條流程完全 offline。

OfficeCLI 的版本檢查預設每 24 小時最多一次，User-Agent 會包含版本與是否為 container；若組織政策禁止這類背景請求，可用 officecli config autoUpdate false 關閉，之後自行管理更新。Claude Code 還會在本機保存 session transcript；官方資料使用文件列出的預設清理期為 30 天，企業環境應一併調整 retention 與檔案權限。

實作：Claude Code OfficeCLI 從 Excel 到 PowerPoint 的 6 步流程

步驟 1：在 Excel 建立可稽核的 PPT_EXPORT 事實層

工作簿常有公式、隱藏欄、不同單位與多個口徑。不要修改 source/ 裡的原檔；先記錄來源 SHA-256，再複製成受控工作檔，只在工作副本增加 PPT_EXPORT 工作表。每列只放一個允許上簡報的事實，欄位至少包含 metric_id、label、value、unit、period、source_cell 與 locked。

先建立專案目錄：

mkdir -p deck-project/source \
  deck-project/brief \
  deck-project/output \
  deck-project/qa/renders \
  deck-project/qa/approvals

把工作簿與模板分別放到 deck-project/source/q2-board-pack.xlsx 與 deck-project/source/brand-template.pptx，再把 Claude Code 的工作目錄設為 deck-project/。接著執行 fail-fast 初始化；任一檢查失敗都會立即停止：

(
  set -eu

  test -f ./source/q2-board-pack.xlsx ||
    { echo "缺少 workbook" >&2; exit 1; }
  test -f ./source/brand-template.pptx ||
    { echo "缺少 template" >&2; exit 1; }
  test ! -e ./output/q2-board-pack-working.xlsx ||
    { echo "工作副本已存在，停止。" >&2; exit 1; }

  if command -v shasum >/dev/null 2>&1; then
    shasum -a 256 ./source/q2-board-pack.xlsx \
      > ./qa/source-workbook.sha256
  elif command -v sha256sum >/dev/null 2>&1; then
    sha256sum ./source/q2-board-pack.xlsx \
      > ./qa/source-workbook.sha256
  else
    echo "缺少 SHA-256 工具" >&2
    exit 1
  fi

  cp ./source/q2-board-pack.xlsx \
    ./output/q2-board-pack-working.xlsx
)

接著用 Excel 開啟 output/q2-board-pack-working.xlsx，先盤點原有工作表並提出欄位到 source_cell 的映射。資料 owner 核准後，只在這份工作副本新增並填好 PPT_EXPORT，儲存關閉；再請 Claude Code 載入 Excel Skill，先只讀不改。下面驗證與 owner 複核都通過後，才把工作副本凍結成後續只讀的事實層：

officecli load_skill excel
officecli view ./output/q2-board-pack-working.xlsx outline
officecli get ./output/q2-board-pack-working.xlsx "/PPT_EXPORT/A1:G40" --json
officecli view ./output/q2-board-pack-working.xlsx issues
officecli validate ./output/q2-board-pack-working.xlsx

validate 只證明 OOXML schema，不能證明數字正確。對每個 summary 指標，還要用 officecli get 同時看 formula 與 cachedValue，抽查來源範圍、分母、正負號、單位與期間。若任何 source_cell 對不上，就停在這一步。

步驟 2：把企業模板複製成工作檔，再讀母片與版型

不要從空白簡報猜品牌。先複製原檔，所有修改都發生在副本：

(
  set -eu

  test ! -e ./output/q2-executive-review.pptx ||
    { echo "工作檔已存在，停止。" >&2; exit 1; }
  temp_dir=$(mktemp -d ./output/template-check-XXXXXX)
  temp_deck="$temp_dir/q2-executive-review.pptx"
  cp ./source/brand-template.pptx "$temp_deck"

  officecli load_skill pptx
  officecli view "$temp_deck" outline
  officecli view "$temp_deck" annotated
  officecli get "$temp_deck" /theme --json
  officecli query "$temp_deck" 'slidemaster' --json
  officecli query "$temp_deck" 'slidelayout' --json

  smoke_dir=$(mktemp -d ./qa/renders/template-smoke-XXXXXX)
  officecli view "$temp_deck" screenshot \
    --page 1 -o "$smoke_dir/slide-01.png"
  test -s "$smoke_dir/slide-01.png" ||
    { echo "找不到非空 PNG，請先處理 screenshot backend。" >&2; exit 1; }
  officecli close "$temp_deck"
  mv "$temp_deck" ./output/q2-executive-review.pptx
)

先盤點 slide masters、layouts、現有標題位置、色票、字型、頁碼與 logo 使用方式。官方 PPTX Skill 的原則是保留既有模板；如果現有版型已可用，就以 officecli add <file> / --from '/slide[N]' 複製範例頁，再替換內容，避免重畫一套看似相近、實際不一致的品牌。

query 會列出 /slidemaster[N] 與 /slidelayout[N] 路徑；對要沿用的項目再以 get 精讀。同一個 fail-fast 區塊會先用暫存工作檔 render 模板第一頁，關閉 resident 後才把它移成正式檔；後端失敗不會留下看似可用的正式 PPTX。

步驟 3：先批准標題序列與 slide-to-metric map

把下面提示貼給 Claude Code。痛點是 Agent 一開始就畫投影片，後面才發現敘事與資料口徑錯了；解法是先交付可審核的契約：

先不要修改 PPTX。請用 OfficeCLI 重新讀取：
- output/q2-board-pack-working.xlsx 的 PPT_EXPORT 範圍
- output/q2-executive-review.pptx 的 outline、annotated 與 master/layout 結構

先建立 brief/deck-contract.md 與 brief/slide-to-metric.csv：
1. 7 頁：封面、先說結論、3 頁證據、風險、下一步。
2. 每頁只回答一個問題；標題都是可驗證的結論句。
3. 每個 KPI／圖表列出 metric_id、來源儲存格、期間、單位與 rounding。
4. locked=true 的值、標籤、日期、分母與單位不得改寫或推算。
5. 不得從常識補數字；缺資料時停止並提問。
6. 沿用模板現有 master、layout、字型、色票與 logo 規則。
7. 先回報 7 頁的「問題／結論／證據／版型」，等我批准後才動檔案。

完成條件是只看七個標題也能走完整段論證，而且每個數字都有 metric_id。若你還在整理資料來源，可先接Claude Code 財經資料教學；本篇聚焦資料已核准後的製作與交付。

步驟 4：讓 Claude Code 用 help-first 規則製作 PPTX

批准契約後，再給 Agent 這段執行規則：

依已批准的 deck-contract.md 修改 output/q2-executive-review.pptx。

執行規則：
1. 先跑 officecli help pptx；任何 prop、enum 或 alias 不確定時先查 help，不猜。
2. open 工作檔；優先複製模板既有 slide/layout，再替換內容。
3. 每做一個結構操作，立即 get 該 slide／shape 確認。
4. 寫入每個 KPI／chart 前，重新 get output/q2-board-pack-working.xlsx 的對應 source_cell，不從對話記憶取值。
5. 每張內容頁加入 notes，記錄 metric_id 與口徑。
6. 不更動 source/ 下任何檔案；不得新增來源不存在的數字或 logo。
7. 完成後先 save，但不要宣稱可交付，直接進入 QA。

OfficeCLI 是低階、可編排的 Office 操作面，不是替你做商業判斷的一鍵簡報器。Claude Code 會依 Skill 規則組合 add、set、get 與 batch；你應審查命令與差異，尤其是 shell 裡的 $、! 與包含 [N] 的路徑。官方 Skill 要求 zsh／bash 的元素路徑都加引號，避免 glob 展開。

步驟 5：逐頁 Render→看→修，最多三輪

先跑文字與結構 gate：

officecli validate ./output/q2-executive-review.pptx
officecli view ./output/q2-executive-review.pptx issues
officecli view ./output/q2-executive-review.pptx text

任何 schema error、view issues 項目或殘留的 xxxx、lorem、<TODO>、空白 ()／[] 都先修掉。接著逐頁 render；頁碼要一路跑到超過簡報總頁數：

(
  set -eu
  render_dir=$(mktemp -d ./qa/renders/run-XXXXXX)

  officecli view ./output/q2-executive-review.pptx stats --json \
    > "$render_dir/deck-stats.json"
  slide_count=$(
    sed -n 's/^[[:space:]]*"slides":[[:space:]]*\([0-9][0-9]*\),[[:space:]]*$/\1/p' \
      "$render_dir/deck-stats.json"
  )
  test -n "$slide_count" ||
    { echo "無法取得投影片數量" >&2; exit 1; }

  page=1
  while [ "$page" -le "$slide_count" ]; do
    png=$(printf '%s/slide-%02d.png' "$render_dir" "$page")
    officecli view ./output/q2-executive-review.pptx screenshot \
      --page "$page" -o "$png"
    test -s "$png" ||
      { echo "本輪 slide $page render 失敗" >&2; exit 1; }
    page=$((page + 1))
  done

  echo "本輪 render 目錄：$render_dir"
)

Anthropic 的 Read 工具文件列出 PNG／JPG 等圖片輸入，也會回傳 original／display dimensions；兩者不同時，小字與高風險圖表要裁切或另做高解析度單頁截圖再看。只把命令最後回報的本輪唯一目錄裡的 PNG 交給一個沒參與製作的 fresh reviewer，使用這段對抗式提示：

假設這份簡報存在問題。逐頁檢查並寫入 qa/visual-review.md：
- shape／chart 重疊、文字裁切、過窄文字框
- 深色底上的低對比文字或圖示
- 截圖／logo 被裁切、圖片比例失真
- 流程線缺箭頭、頁尾／來源撞到內容
- 元素離邊界太近、卡片間距不均、重複元素未對齊
- 標題在 200px 縮圖仍是否可讀
- 敘事順序是否為封面→結論→證據→風險→行動

每個問題用「slide N：問題｜嚴重度｜修法」回報；看不清就標記未驗證，不得猜。
修正後另建新的唯一 render 目錄並重跑全部頁面，最多三輪；三輪仍不收斂就停止並回報根因。

這裡的核心和視覺回歸驗收相同：不是讓模型說「很好看」，而是用固定檢查表、同一批 render 與明確停止條件找差異。

步驟 6：數字另驗一次，再進 PowerPoint 終審

視覺 PASS 不代表數字 PASS。依 slide-to-metric.csv 逐筆回查：KPI 文字、圖表 categories、series values、期間、單位、百分比分母、正負號與 rounding 都要和 PPT_EXPORT 對上。對 Excel 的 summary cells 也要同時看 formula 與 cachedValue；OfficeCLI 官方 Excel Skill 說得很直白：工作簿可以在每個數字都錯時仍通過 validate。

不要只拿來源和計畫表互相比；還要把成品 PPTX 的實際文字與圖表資料抽出來，再逐筆比較。若成品沒有原生 chart，先以畫面與來源產圖逐項人工驗證，將方法、結論與當下 PPTX 的 SHA-256 寫入 qa/approvals/chart-structure-na.md：

(
  set -eu

  officecli get ./output/q2-board-pack-working.xlsx \
    "/PPT_EXPORT/A1:G40" --json > ./qa/source-metrics.json
  officecli query ./output/q2-executive-review.pptx \
    'chart' --json > ./qa/ppt-charts.json
  officecli view ./output/q2-executive-review.pptx \
    text > ./qa/ppt-text.txt

  grep -Eq '"success"[[:space:]]*:[[:space:]]*true' \
    ./qa/source-metrics.json
  grep -Eq '"matches"[[:space:]]*:[[:space:]]*[1-9][0-9]*' \
    ./qa/source-metrics.json
  grep -Eq '"success"[[:space:]]*:[[:space:]]*true' \
    ./qa/ppt-charts.json
  test -s ./qa/ppt-text.txt

  if grep -Eq '"matches"[[:space:]]*:[[:space:]]*[1-9][0-9]*' \
    ./qa/ppt-charts.json; then
    echo "找到原生 chart：進行 categories／series／values 結構比對"
  else
    if command -v shasum >/dev/null 2>&1; then
      deck_sha=$(shasum -a 256 ./output/q2-executive-review.pptx | awk '{print $1}')
    elif command -v sha256sum >/dev/null 2>&1; then
      deck_sha=$(sha256sum ./output/q2-executive-review.pptx | awk '{print $1}')
    else
      echo "缺少 SHA-256 工具" >&2
      exit 1
    fi
    approval=./qa/approvals/chart-structure-na.md
    test -s "$approval" ||
      { echo "缺少原生 chart N/A 人工核准紀錄" >&2; exit 1; }
    grep -Fq "$deck_sha" "$approval" ||
      { echo "N/A 核准未綁定目前 PPTX hash" >&2; exit 1; }
    echo "原生 chart 結構驗證 N/A：人工核准已綁定目前 PPTX"
  fi
)

query 'chart' 可回傳圖表 categories、series 與 values；若畫面明明有圖表，結果卻是 matches: 0，它可能已被點陣化，此時只能做像素與標籤抽查，不能宣稱 series 已通過結構驗證。

OfficeCLI 的 schema、資料與逐頁 render 全部收斂後，先執行 officecli save ./output/q2-executive-review.pptx，再執行 officecli close ./output/q2-executive-review.pptx 釋放 resident。確認 CLI 已關檔後，才進入 PowerPoint 人工終審，避免檔案鎖或 resident 覆蓋外部修改。

最後在收件者使用的 PowerPoint 版本開檔，檢查字型替代、母片、圖表色彩、動畫、備註、連結與投影對比。Microsoft 的字型嵌入說明指出，缺少字型可能改變版面與樣式，而且不是每套字型都允許嵌入；交付前要在乾淨的目標電腦試開。若簡報含嵌入的 Excel chart，先在副本上跑 Document Inspector，檢查隱藏物件與 cached data；若是外部連結，則用 PowerPoint 的 Edit Links to Files 確認來源與更新狀態。最後明確決定交付檔要保留 linked、embedded，還是轉成靜態。

如果人工終審在 PowerPoint 做了修改，先關閉 PowerPoint，再讓 OfficeCLI 重新開檔並重跑受影響的資料、render 與 hash gate，最後再次關閉 resident；終審後不要無條件呼叫 save 覆蓋外部版本。沒有待修項目後，保存原始 Excel、工作副本、模板、OfficeCLI 版本、實際命令、deck contract、metric map、模型／端點、逐頁 PNG、QA 結果與最後 PPTX，並記錄每個輸入／輸出的 SHA-256。hash 只證明檔案身分與完整性；完整 manifest 才支持重跑。

交付門檻：哪些可以自動，哪些一定要人看？

• 可以機械化：schema、placeholder、metric_id 唯一性、來源範圍、單位、總計、逐頁 PNG 是否存在與輸入 hash。
• 可以讓 Claude 輔助：溢位、過密、對比、敘事斷點、標籤遺漏與跨頁視覺不一致。
• 不能只交給模型：董事會口徑、敏感資料授權、對外聲明、品牌法務、字型授權、隱藏資料與目標 PowerPoint 最終呈現。

最實用的停止條件是：任一 locked 值沒有來源、任一頁沒有獨立 render、任一 issue 未被理解、或目標 PowerPoint 有替代字型／修復提示，就不交付。這比一個漂亮但無法重現的「品質分數」可靠。

Claude Code × OfficeCLI 的 8 個常見問題

1. 本文為什麼不用 officecli new pptx？

因為那是另一套同名產品。本文的 iOfficeAI/OfficeCLI 使用 create、add、set、get、view 與 validate；請不要混用 officecli.io 文件。

2. OfficeCLI 是 Anthropic 官方外掛嗎？

不是。它是 Apache-2.0 的第三方開源工具與第三方 Skill；Claude Code 提供的是通用 Skill 與 shell 介面。安裝前仍要審 repo、腳本、權限、更新與網路行為。

3. OfficeCLI 本機 render 是否代表整條流程離線？

不是。本機 Office 檔主要在本機處理，但更新檢查、URL 媒體、特定 preview／screenshot 資產與 Claude 模型推論仍可能連網。資料能否使用，要依實際帳戶、端點、組織政策、遠端素材與工具設定判斷。

4. validate 通過就能寄給客戶嗎？

不能。validate 查 schema，不證明 Excel 數值、圖表來源、品牌一致性或 PowerPoint 顯示結果。至少還要跑 issues、placeholder、逐頁 screenshot、資料回查與 target viewer。

5. Claude Code 能直接看 PPTX 每一頁嗎？

先用 view screenshot 轉成逐頁 PNG。Claude Code 官方支援讀圖片，但 original／display dimensions 可能不同；小字與 chart values 要裁切或另做高解析度單頁截圖再看。PPTX 存在目錄裡，不等於視覺已驗收。

6. 能直接沿用公司的 PowerPoint 母片嗎？

可以從模板副本開始，並優先複製現有 slide／layout。但仍要實際讀取 master、layout、字型與 logo 規則；不能只把檔案放進資料夾就假設 Agent 自動理解所有品牌細節。

7. 為什麼不讓 Claude 自己從整本 Excel 挑數字？

因為挑哪個數字本身就是商業口徑。隱藏列、公式版本、幣別與期間都可能改變結論。PPT_EXPORT 等於先為簡報定義一個窄而明確的資料 API。

8. 這套流程能完全自動化嗎？

重跑與機械 gate 可以，自動批准交付不建議。等 schema、metric map、render 與檢查清單穩定後，可接進腳本或 CI；對外結論、敏感資料、字型／資產權利與 PowerPoint 終審仍要有明確人類 owner。

給新手的 6 個重點

1. 記住錨點：可交付簡報＝事實層＋簡報契約＋雙重驗收＋人工終審。
2. 本文用 iOfficeAI/OfficeCLI；先核對 repo、版本與 help，不混用 officecli.io 指令。
3. Excel 保留為唯一真相來源，另建 PPT_EXPORT 限定 Agent 可用事實。
4. 先批准標題序列與 slide-to-metric map，再讓 Claude Code 修改模板副本。
5. 逐頁 Render→看→修只處理視覺；數字必須用來源儲存格與 cached values 另驗。
6. schema 通過、本機 render、target PowerPoint 可交付是三個不同 gate。

如果你剛開始用 Claude Code，可以先讀Claude、Claude Code、Cowork 的差異，再看Claude Code vs Codex理解工具執行方式。想系統化練習 Agent 工作流，也可以到 AlphaLab 線上課程查看學習路線，或回到 AI 專區延伸閱讀。