2026 年，WordPress.org 一口氣上架三支官方外掛，分別是 AI Provider for Anthropic、AI Provider for Google、AI Provider for OpenAI，各自串接一家 AI 供應商，直接掛進 WordPress 核心新增的 AI Client 底層。這不是又一支「AI 寫作助手」，而是把 AI 串接做成跟資料庫連線同一個等級的基礎建設，讓其他外掛不用各自處理金鑰、各自寫一套串接程式碼。
問題是，裝完外掛只是第一步。金鑰要貼在哪個畫面、貼完要怎麼確認真的連上線、三家一起裝會不會互相衝突，這幾件事外掛的描述頁不會主動講清楚，得自己一步一步摸索。WordPress AI外掛設定的完整路徑，從辦金鑰、裝外掛、到金鑰存放位置與多支外掛共用，其實有一套固定流程，只是散在三個外掛頁與核心的官方說明裡，沒有人整理成一條路走完。
官方三支外掛分別串接 Anthropic、Google、OpenAI 三個模型
裝哪一支，網站就認得哪一家的模型。這是理解這三支外掛最快的方式。它們是三個各自獨立的 WordPress.org 外掛，分別替 Anthropic、Google、OpenAI 三家供應商實作 PHP AI Client SDK 要求的介面，彼此不互相依賴，也不會因為裝了一支就自動擁有另一家的能力。
AI Provider for Anthropic 提供文字生成（對應 Claude 系列模型）、函式呼叫（function calling）與擴充思考（extended thinking）三項能力，並且會自動註冊到 WordPress 的供應商清單裡。AI Provider for Google 一樣支援文字生成與函式呼叫，額外多了圖片生成，可以叫用 Imagen 系列模型產圖，2026 年 9 月 21 日釋出的 1.2.0 版再加上文字轉語音（TTS）。AI Provider for OpenAI 支援的類型最完整，除了 GPT 系列的文字生成、函式呼叫，還有網頁搜尋（web search）、DALL-E 與 GPT Image 的圖片生成。2026 年 8 月 17 日釋出的 1.1.0 版新增了嵌入（embedding）模型支援，以及用參考圖搭配 OpenAI 圖片編輯端點來修改既有圖片的功能；9 月 21 日的 1.2.0 版又補上文字轉語音（TTS）。
三支外掛都不是自己內建一份寫死的模型清單，而是連線到各家的 API 動態抓取當下可用的模型。供應商上架新模型，外掛端不用更新版本就能抓到。它們也都依賴同一套 PHP AI Client SDK，這正是為什麼裝好其中一支之後，其他呼叫這套 SDK 的外掛（像後面會提到的官方「AI」外掛）就能直接沿用，不用各自重新處理供應商的實作細節。三支的能力差異不代表誰更好，實際要裝哪一支，取決於網站需要哪些生成類型、已經在用哪一家的模型。
三個模型平台各自的 API 金鑰申請入口
裝外掛之前，得先去對應供應商的網站辦一組 API 金鑰。三個申請入口分別在不同的官方頁面，名稱與路徑都不一樣，很容易搞混。
Anthropic Console 建立帳號並產生 Claude 金鑰
AI Provider for Anthropic 外掛頁面的 FAQ 直接寫明，要辦 Claude 的 API 金鑰，去 Anthropic Console 建立帳號並產生金鑰即可，這是官方指定的唯一入口。Anthropic 後來把 Console 更名為 Claude Console，網址改成 platform.claude.com，舊網址 console.anthropic.com 會自動轉過去；它跟一般消費者使用的 Claude.ai 聊天網站是不同系統，帳號也未必共用。
進到 Console 之後，金鑰通常會列在專門的 API Keys 頁面下，產生出來的字串只會完整顯示一次，一旦離開畫面就只剩遮罩後的片段可以查看。金鑰產生出來的當下，建議先存到密碼管理工具，避免之後還要重新產生一組。
Google AI Studio 產生 Gemini 金鑰
Google 這邊官方指名的入口是 Google AI Studio，不是一般開發者更熟悉的 Google Cloud Console。AI Provider for Google 外掛頁面的 FAQ 寫得很明確，要辦 Google 的 API 金鑰，去 Google AI Studio 產生給 Gemini API 用的金鑰即可。
這兩個系統的差別在於，Google Cloud Console 管的是整個 Google Cloud 專案層級的服務與帳單，設定步驟繁瑣得多；Google AI Studio 則是專門給 Gemini API 開發者用的輕量入口。每組金鑰背後雖然都掛在一個 Google Cloud 專案底下，但新使用者在 AI Studio 同意服務條款後，系統會自動建立預設專案與金鑰，不必先自己去 Cloud Console 開專案；已經在用 Google Cloud 的帳號，AI Studio 不會另外建預設專案，要先把既有專案匯入，再到 API Keys 頁面產生金鑰。讀者若照著舊教學文章跑去 Cloud Console 找金鑰，反而會被更複雜的介面拖住，找不到金鑰藏在哪個選單裡。
OpenAI Platform 建立帳號並產生 GPT 金鑰
OpenAI 官方指定的入口叫 OpenAI Platform，網址是 platform.openai.com，跟一般消費者在用的 ChatGPT 網站是分開的兩個系統。AI Provider for OpenAI 外掛頁面的 FAQ 同樣寫得很直接，要辦 OpenAI 的 API 金鑰，去 OpenAI Platform 建立帳號並產生金鑰。
不少讀者第一次找金鑰時會直接跑去 ChatGPT 網站的帳號設定裡翻找，結果什麼都找不到。ChatGPT 訂閱與 API 用量是兩套完全不同的計費與管理系統，金鑰只會出現在 Platform 這個開發者後台裡。
安裝並啟用對應的 AI Provider 外掛
三支外掛的安裝路徑完全同構，差別只在外掛名稱。AI Provider for Anthropic 裝在 /wp-content/plugins/ai-provider-for-anthropic/，Google 版與 OpenAI 版分別是 ai-provider-for-google/ 與 ai-provider-for-openai/。安裝方式有兩種，一種是在後台「外掛」頁面直接搜尋外掛名稱、點安裝並啟用；另一種是把外掛的 zip 檔上傳到後台，適合網路環境限制、無法直接連到 WordPress.org 搜尋的站台。
裝好之後記得回到「外掛」清單頁確認狀態是「已啟用」，而不是只完成上傳卻忘記啟用，這是最常見的漏一步。
版本要求上，三支外掛都需要 PHP 7.4 以上。WordPress 版本則有明顯差異，如果網站跑的是 WordPress 6.9，要另外用 Composer 手動安裝 wordpress/php-ai-client 這個相依套件，外掛才能正常運作；如果是 WordPress 7.0 以上，完全不需要這個額外步驟，因為 AI Client 已經內建進核心，外掛裝完啟用就能直接抓到。不少舊教學文章寫的還是 6.9 時代的做法，若照著在 7.0 以上的站台又裝一次 Composer 套件，純屬多餘的步驟。
三支外掛之間互不衝突，一次裝一支或全部裝齊都可以，裝多支只是讓網站同時認得多家模型，不會因為裝了第二支就把第一支擠掉。
金鑰貼在核心「連接器」畫面，不是外掛自己的設定頁
實際設定金鑰的畫面，並不在外掛自己的設定頁，而是 WordPress 核心內建的「設定 > 連接器」（Settings > Connectors）畫面。這是 WordPress 7.0 新增的核心功能，不需要另外裝任何外掛就存在；WordPress 7.0 出廠時就內建三個「精選連接器」（featured connectors），分別對應 Anthropic、Google、OpenAI。畫面會檢查每張卡片對應的 Provider 外掛有沒有安裝、啟用，再顯示相應的動作按鈕；外掛裝好並啟用之後，卡片上出現的就是設定金鑰用的「Set up」按鈕。
每個連接器在畫面上都以卡片形式呈現，卡片上有供應商名稱、一句說明，還有 logo。最實用的是卡片內建一個直接連到該供應商官網申請頁面的連結，也就是前面講的 Anthropic Console、Google AI Studio、OpenAI Platform 這三個入口，讀者不用自己再去外面找網址，點卡片上的連結就能直接跳過去。
貼上金鑰、按下儲存之後，畫面會顯示這組金鑰目前的來源（環境變數、PHP 常數，或是資料庫），以及連線狀態是否成功。如果連線失敗，通常代表金鑰字串貼錯，或是還沒完成前面「安裝並啟用」那一步。
金鑰的三種存放位置與讀取順序
金鑰該存在哪裡最安全，是設定完之後最常被問的問題。官方文件寫得很清楚，api_key 類型的連接器支援三種存放方式，依序是環境變數、PHP 常數、資料庫，WordPress 會按照這個順序去檢查，只要其中一種有設定值就會直接生效，不會三種都要求同時填。
每家供應商的環境變數與常數命名都遵循固定規則，格式是 {PROVIDER_ID}_API_KEY。以三家為例，Anthropic 對應 ANTHROPIC_API_KEY，Google 對應 GOOGLE_API_KEY，OpenAI 對應 OPENAI_API_KEY。要用 PHP 常數設定，做法跟一般 WordPress 常數一樣，在 wp-config.php 裡加一行：
define('ANTHROPIC_API_KEY', '你的金鑰字串');Code language: PHP (php)如果選擇存進資料庫（也就是直接在「設定 > 連接器」畫面貼上、按儲存），WordPress 會依 connectors_{$provider_type}_{$provider_id}_api_key 這個樣式自動產生對應的設定名稱，不需要自己手動命名。
這裡有一個現況要留意，目前存進資料庫的金鑰並沒有加密，只在畫面上用遮罩顯示部分字元防止被直接看到完整字串。對安全性比較敏感的站台，可以改用環境變數或 PHP 常數存放，這兩種都不會把明文金鑰寫進資料庫。另一個做法是另外裝一支官方外掛，名稱就叫「AI」，裡面內建一個叫「Key Encryption」的實驗功能，用內建的 libsodium 函式庫把存進資料庫的 AI 連接器金鑰加密存放，讀取時透明解密、寫入時重新加密。這是不少教學文章都還沒提到的具體解法，若停用這個實驗或停用外掛本身，金鑰就會恢復成明文，等於是可以隨時打開關掉的加密層，不是不可逆的動作。
一組金鑰，所有相容外掛都能沿用
金鑰是站台層級的設定，不是外掛層級的。站上只要裝好 AI Connector 外掛、在連接器畫面設定好金鑰，任何呼叫核心 AI Client 的外掛都直接讀得到同一組金鑰，不用各自再貼一次；連接器畫面頂端的說明也直接寫明，金鑰與憑證存在這裡、跨外掛共用，設定一次就能到處使用。這件事最好懂的例子，就是前面提到、名稱叫「AI」的那支外掛。
「AI」外掛本身完全不含任何供應商的實作或憑證，它做的是把 AI Client 包裝成一組實用功能，像是幫圖片自動產生替代文字（Alt Text）、幫文章產生標題、產生摘要、產生 Meta Description。外掛安裝說明寫得很具體，要讓這些功能真的可以用，得先裝好至少一支 AI Connector 外掛，並在「設定 > 連接器」設定好憑證，這兩件事沒完成之前，「AI」外掛裡的功能可能會呈現無法使用的狀態，要等連接器裝好、通過驗證，而且支援該功能需要的生成類型，功能才會真的動起來。所以裝了「AI」外掛卻發現功能沒反應，多半不是外掛壞了，而是連接器這一段還沒接好。
外掛裡還有一個實驗功能叫「Connector Approvals」，預設不開啟；打開之後，任何外掛或佈景主題要使用站上設定好的 AI 連接器，都得先經過管理員明確核准。這對多外掛、多用戶的站台是個實用的把關機制，避免每支裝進來的外掛都無條件共用同一組金鑰去打 API。要留意的是，開了這個功能之後，「AI」外掛本身也是一支外掛，同樣要先核准才能呼叫連接器，忘了這一步，標題生成這類功能就會像沒接上連接器一樣跑不起來。
同時串接多家模型時，各外掛依偏好清單決定呼叫對象
同時裝好三支 Provider 外掛，金鑰也設定完成，常有人擔心它們會不會互相干擾，或是每次呼叫都要自己選一家。答案是不會，這件事交給外掛開發者在程式裡指定的「偏好模型清單」處理。
外掛開發者呼叫 AI Client 時，可以列出一份偏好使用的模型清單，官方 dev note 給的範例類似 claude-sonnet-4-6、gemini-3.1-pro-preview、gpt-5.4 這樣依序排列。WordPress 會從清單第一個目前有配置好的模型開始用，若清單裡列的都沒配置，就退回任何相容的可用模型繼續執行，不會直接失敗。對一般站主來說，這代表不用選邊站，三家都裝、都設好金鑰，個別功能背後實際呼叫哪一家，交給該功能自己的偏好清單或退回機制決定，不需要手動切換。
這套機制還搭配一個叫「功能偵測」的行為，指的是在沒有任何 Connector 配置好之前，跟 AI 有關的按鈕或介面通常不會出現，或是會提示使用者先去設定，不會讓讀者點了按鈕卻完全沒反應。開發者被明確提醒，不能假設只要站台裝了 WordPress 7.0，AI 功能就一定可用，得先檢查功能是否真的能執行，才顯示相關介面。
設定完成後，用標題生成功能驗證串接是否成功
金鑰貼了、連線狀態也顯示成功，不代表功能一定真的能跑起來。與其憑感覺覺得應該沒問題，不如照官方「AI」外掛的說明走一次完整的驗證流程。
第一步是到「設定 > AI」，在功能清單裡個別打開要測試的實驗功能（2026 年 10 月釋出的 1.4.0 版已拿掉頁首的「Enable AI」總開關，功能改成逐項開關），這裡以標題生成（Title Generation）當範例，因為它是操作路徑最短、最容易一次看出結果的功能。啟用之後，回到文章編輯畫面，任選一篇文章，點進標題欄位，欄位上方會出現一個「Generate / Regenerate」按鈕。點下去之後，請求送出到設定好的 AI 供應商，等回應跑完，畫面會跳出一個彈窗，顯示幾個標題建議，選一個喜歡的，按下 Select 就會直接插入標題欄位。
如果這個流程能順利跑完，代表從金鑰、外掛、到 AI Client 這整條路徑都是通的，不需要再逐一檢查中間每一段設定。如果卡在任何一步（按鈕沒出現、點了沒反應、跳出錯誤訊息），原因通常就落在金鑰有沒有真的設定好、版本相依套件有沒有裝齊這幾件事上。
常見設定失敗的原因、排查方式
前面幾節提到的坑，實際設定時最容易卡在這幾個地方。
最常見的一種是兩邊只設定了一邊：裝了 Provider 外掛，卻沒去「設定 > 連接器」貼金鑰；或是反過來，以為連接器畫面本來就有 Anthropic、Google、OpenAI 三張卡片就能直接用，卻沒有先裝好、啟用對應的 Provider 外掛，卡片上顯示的還是安裝或啟用外掛的按鈕。這兩件事缺一不可，確認方式很直接，回到「設定 > 連接器」，看對應供應商的卡片是不是已經顯示連線成功，而不是還停在安裝或啟用外掛的按鈕。
第二種是版本相依套件沒裝齊。如果網站還在 WordPress 6.9，前面提過要另外用 Composer 裝 wordpress/php-ai-client 套件，少了這一步，外掛雖然顯示已啟用，實際呼叫時會直接失敗。升級到 WordPress 7.0 以上就不會遇到這個問題，因為套件已經內建進核心。另外要注意，官方「AI」外掛本身要求 WordPress 7.0.3 以上，還在 6.9 的站台就算補裝了套件，也沒辦法用它跑前面的標題生成驗證。
第三種容易被忽略的是編輯器版本。官方「AI」外掛明確不支援 Classic Editor，只支援區塊編輯器（Block Editor）。如果網站還在用 Classic Editor 或相關外掛維持舊版編輯畫面，前面走過的標題生成驗證流程根本不會出現在畫面上，不是設定錯誤，而是編輯器不相容。
第四種不算是故障，而是刻意的權限限制：瀏覽器端的 JavaScript 版 AI Client（wp-ai-client），預設只開放給管理員角色使用。這是因為這套 API 允許從客戶端直接送出提示詞（prompt）給 AI 供應商，若開放給任何角色，等於讓未受信任的使用者可以任意呼叫已設定好的 AI 服務，所以官方刻意把權限收在管理員層級。如果編輯或作者角色反映某個 AI 功能用不到，先確認是不是這個角色限制，而不是急著重新檢查金鑰設定。
把這幾件事按順序確認過一遍：連接器頁面的連線狀態、WordPress 版本與相依套件、編輯器類型、操作角色的權限，多數設定失敗的原因都會落在這四種裡面。金鑰、外掛、連接器這條路徑一旦真的接通，後續不管是「AI」外掛內建的功能，還是其他呼叫同一套 AI Client 的外掛，都能直接沿用同一組設定，不用每裝一支新外掛就重新走一次申請金鑰的流程。