在 Codex 中安裝 BIMTeki MCP
本篇說明如何讓 ChatGPT 桌面版的 Codex 模式（或 Codex CLI）能直接操作 Archicad 裡的 BIMTeki 專案。整個過程分三步：裝連接器、裝技能包、確認連得上。用 Claude 的人請改看〈02 在 Claude 中安裝 BIMTeki MCP〉。
還不清楚連接器與技能包是什麼、各自負責什麼，請先看〈01 甚麼是 BIMTeki MCP〉。
安裝前請先確認
步驟一：安裝 BIMTeki MCP（連接器）
連接器不需要單獨下載，它就包在 BIMTeki Studio 的安裝檔裡。
幾件值得知道的事：
步驟二：安裝 ChatGPT 桌面版與 BIMTeki 技能包
先安裝 ChatGPT 桌面版（Windows 版從 Microsoft Store 安裝）。它左上角可以切換「ChatGPT」與「Codex」兩種模式，BIMTeki 要在 Codex 模式使用。
接著要做兩件事：把 BIMTeki 的技能包「市集」加進 Codex，再從市集安裝技能包。加市集有兩種方式，選一種做即可；桌面版與 Codex CLI 共用同一套設定，在任一邊加好，另一邊就有了。
BIMTeki/bimteki-plugin「Git 參照」維持預設的 main、「稀疏路徑」留空，按 新增市集。看到「bimteki 市集已新增」就完成了。
codex plugin marketplace add BIMTeki/bimteki-plugin
連接器的設定由 BIMTeki Studio 安裝檔在步驟一寫好了。你不需要去設定什麼伺服器位址、不需要執行任何「加入 MCP」的指令，也不需要安裝任何額外的擴充功能。
步驟三：確認裝好了
先讓 Archicad 開著、而且已開啟一個 BIMTeki 專案，否則連接器再正常也沒有東西可以回報。
⚠️ 要在對的模式用
這是最常見的踩雷點。ChatGPT 有好幾種使用方式，BIMTeki 只有在能啟動本機連接器的那幾個才能實際操作 Archicad：
| 在哪裡 | 看得到技能 | 能操作 Archicad |
|---|---|---|
| ChatGPT 桌面版 Codex 模式 | ✅ | ✅ |
| Codex CLI | ✅ | ✅ |
| ChatGPT 桌面版 ChatGPT 模式 | ❌ | ❌ |
| ChatGPT 網頁版 | ❌ | ❌ |
ChatGPT 模式與網頁版連本機的東西都碰不到，請切到 Codex 模式。
步驟四：更新技能包
技能會隨著法規與 BIMTeki 功能持續調整。更新分兩層：先讓市集拿到新版清單，再更新技能包本身。
桌面版：Codex 模式 → 外掛程式 → 管理 → 市集 頁籤，對 bimteki 市集按 升級（內建市集會自動更新，只有像 BIMTeki 這種 Git 來源的市集需要按），再回到外掛程式清單對「BIMTeki 建照檢討」按更新。
終端機：
codex plugin marketplace upgrade bimteki
改過之後記得完全重開 ChatGPT 桌面版。
這一點請特別記住，它是很多困惑的根源：
| 更新方式 | |
|---|---|
| 技能包 | 在 ChatGPT 的外掛程式頁面一鍵更新 |
| BIMTeki MCP 連接器 | 要重新執行最新版 BIMTeki Studio 安裝檔 |
所以兩邊的版本號不一樣是常態，不用擔心。但如果 AI 跟你說「你的 MCP 版本太舊」，或做出來的表格少了合併儲存格、少了框線，那就是技能包更新了、連接器沒跟上——請重跑一次最新版安裝檔，裝完把 ChatGPT 完全關掉再重開。
疑難排解
只要是「AI 看不到 BIMTeki 工具」這一類問題，先跑這一支。它隨 BIMTeki Studio 一起安裝，只讀不寫，不會改動你電腦上的任何東西。
打開 PowerShell，貼上執行：
powershell -NoProfile -ExecutionPolicy Bypass -File "$env:ProgramW6432\BIMTeki Studio\verify-mcp-install.ps1"
它會依序檢查安裝紀錄、檔案是否齊全，然後真的把連接器啟動起來跑一次連線測試，最後告訴你卡在哪一關。
看到紅色 [失敗]，對照下表處理：
| 失敗的項目 | 意思與處理方式 |
|---|---|
| 登錄檔：找不到 | 安裝時沒勾「AI 助理連接器 (BIMTeki MCP)」（舊版叫「Claude AI 連接器」），或安裝檔是加入連接器之前的舊版。請重跑最新版安裝檔 |
| 內嵌 Python／MCP 進入點 不存在 | 檔案不齊，重跑安裝檔 |
| 預編譯檔太少 | 不影響功能，但連接器啟動會變慢。重跑安裝檔可修正 |
| initialize 沒有回應 | 多半是防毒或公司資安軟體把連接器擋掉了。請 IT 把 BIMTeki Studio 安裝資料夾底下 mcp\python\python.exe 加入白名單 |
| stdout 被汙染 | 請把完整輸出寄給我們 |
| 症狀 | 處理方式 |
|---|---|
| /mcp 清單裡沒有 bimteki | 最常見是安裝檔太舊（v0.0.24 以前不會寫 Codex 設定），請重跑最新版安裝檔後完全重開 ChatGPT 桌面版。若安裝檔當時是用「以系統管理員身分執行」啟動的，設定會寫到管理員帳號，請改用一般方式重跑一次安裝檔 |
| 技能包頁面看得到技能，但看不到連接器 | 正常。ChatGPT 的技能包頁面不會顯示連接器，以 /mcp 為準 |
| 桌面版「新增市集」顯示「無法新增市集」 | 確認來源拼的是 BIMTeki/bimteki-plugin、電腦連得上 GitHub；仍失敗就改用方式 B 的終端機指令加入 |
| 市集加好了，但外掛程式清單裡找不到「BIMTeki 建照檢討」 | 到 管理 → 市集 確認 bimteki 市集在清單裡，對它按 升級 重新整理清單；仍沒有就完全重開 ChatGPT 桌面版 |
| bimteki 顯示啟動失敗或逾時 | 多半是防毒第一次掃描連接器花太久，關掉對話再開一次新對話即可；持續發生請 IT 把 BIMTeki Studio 安裝資料夾底下 mcp\python\python.exe 加入白名單 |
| 對話一開始就說「本機執行核心無法啟動」 | 對話開在 Codex 不信任的資料夾（例如 Program Files 底下的程式專案）。換一個普通資料夾開新對話 |
| ChatGPT 模式或網頁版看不到 BIMTeki | 正常，本機連接器只有 Codex 模式與 Codex CLI 連得到。切到 Codex 模式 |
| 技能沒出現 | 到外掛程式頁面確認 BIMTeki 建照檢討為啟用狀態；改過設定後要完全重開 ChatGPT 桌面版 |
| ChatGPT 說「無法連線到 Archicad」 | 連接器正常，但 Archicad 那頭沒準備好。確認 Archicad 開著、專案已開啟、BIMTeki 外掛已載入 |
| 表格產生了但數值是空白 | 這不是安裝問題。自動文字要放置到圖紙（Layout）上才會計算出實際值 |
| ChatGPT 說「你的 MCP 版本太舊」，或表格少了合併儲存格／框線 | 技能包更新了、連接器沒有。重跑最新版 BIMTeki Studio 安裝檔，裝完完全關掉再重開 ChatGPT |
| ChatGPT 說「席位已被其他電腦取用」 | 這是浮動許可的正常機制：席位在另一台開著 Archicad 的電腦上。關閉那台電腦的 Archicad，這台幾分鐘內會自動取回席位；詳見〈授權〉系列的「浮動許可」一文 |
| ChatGPT 說「離線寬限已逾期」 | 這台電腦斷網超過寬限時間。確認網路恢復後再試一次即可，不必重開 Archicad |
| 其他授權相關錯誤 | 請聯繫 BIMTeki |
若以上都無法解決，請來信 office@arkiteki.com，並附上：
裝好之後可以做什麼
不需要記任何指令名稱，直接用中文交代就好：
「做地下層容積檢討表」
「這個建照有哪些檢討表可以做？」
「把這份土管做成檢討表」（並把土管 PDF 拖進對話）
「幫我畫容積區域」
如果你已經很清楚要用哪一項功能，也可以直接指定技能。Codex 用錢字號 $bimteki: 開頭；ChatGPT 桌面版的對話框則可以打 @ 從清單選「BIMTeki 建照檢討」，再用中文說要做什麼。例如：
$bimteki:table
不帶任何關鍵字，AI 會列出這個案子目前可以做的所有檢討表讓你挑。全部技能的用途見〈05 SKILL 一覽〉；想看實際操作影片，見〈06 使用案例〉（影片以 Claude 示範，Codex 的流程相同，只是指定技能的寫法從 / 改成 $）。