外觀
配置 Codex
這篇教學說明怎麼把瓜瓜AI 接到 Codex。影片使用的是 CC Switch 這套供應商管理工具，流程分成三段：先在瓜瓜AI 控制台複製連線資訊，再在 CC Switch 建立一個 Codex 供應商，最後啟用並重新啟動 Codex。
開始前請準備
- 一個可以登入的瓜瓜AI 帳號
- 一組可用的瓜瓜AI API Key（還沒有的話，請先看兌換與取得 API Key）
- 已安裝 CC Switch，且電腦上已經裝好 Codex（本教學不涵蓋安裝步驟）
步驟 1：在瓜瓜AI 控制台複製 API 端點與 API Key
登入瓜瓜AI 控制台，點左側的**「API 密钥」**。這個頁面有兩項資訊之後會用到：
- API 端點：畫面上顯示
https://api.guagua5487.xyz/v1。把游標移到右側的複製圖示上會出現「点击可复制此端点」提示，點一下即可複製。 - API Key：在下方清單找到你的金鑰那一列，點金鑰文字右側的複製圖示。
複製成功時，畫面右上角會出現提示：複製 API 端點時顯示「已复制」，複製 API Key 時顯示「已复制！」。
API Key 請勿外流
API Key 等同於你的身分憑證，請當作密碼保管，不要貼到聊天室、GitHub 或任何公開場合。
步驟 2：開啟 CC Switch，點右上角的「+」
開啟 CC Switch。視窗上方會列出你目前的供應商（影片中原本已經有「OpenAI Official」與「CPA」）。
點右上角的橘色 「+」 按鈕，開始新增供應商。
步驟 3：選擇「Codex 供應商」分頁
畫面會跳出「新增供應商」視窗。上方有兩個分頁：「Codex 供應商」 與「通用供應商」，請確認停在**「Codex 供應商」**。
下方的「預設供應商」清單列出一堆現成的供應商範本。本教學與影片一樣選擇清單最左邊的**「自訂設定」**，選它之後必須自己手動填寫下方所有必要欄位。
步驟 4：填寫供應商名稱與連線資訊
往下捲動到表單，依序填寫這幾個欄位：
| 欄位 | 填入內容 |
|---|---|
| 供應商名稱 | 自己辨識用的名稱，影片填入 gua |
| 官網連結 | https://api.guagua5487.xyz/v1（此欄標示為選填） |
| API Key | 貼上步驟 1 複製的金鑰；貼上後欄位會以圓點顯示 |
| API 請求位址 | https://api.guagua5487.xyz/v1 |
「API 請求位址」右側有一個**「完整 URL」**切換，影片中維持關閉；下方的說明是「填寫相容 OpenAI Response 格式的伺服器端點位址」。「備註」欄影片沒有填。
步驟 5：取得模型清單並選擇預設模型
「預設模型」欄位在影片中原本是 gpt-5.6-sol。這個欄位本身不會自動列出供應商的模型，必須先點欄位右側的下載圖示（下圖 ①）去取得模型清單，畫面出現「取得 1 個模型」才代表清單抓到了。
取得清單後，再點欄位右側的下拉選單（下圖 ②），裡面就會出現 deepseek-v4.1-flash（影片示範選擇的是這個模型），選取後欄位就會變成該模型。
欄位下方的說明是「Codex 預設請求的模型，隨時可改，無需等待軟體更新供應商版本。留空且設定了模型映射時，預設使用映射第一行。」
步驟 6：設定進階選項（選用）
展開**「進階選項」**後還有幾組設定。影片中顯示的內容如下：
- 上游格式：
Responses（原生）。說明為「供應商原生為 Responses API 就選 Responses（直連，不轉換格式）；使用 Chat Completions 就選 Chat；供應商只提供原生 Anthropic Messages 就選 Anthropic Messages。Chat 與 Anthropic Messages 均需開啟路由接管才能轉換為 Responses。」 - 模型映射：影片新增了一列，選擇顯示名與實際請求模型都填
deepseek-v4.1-flash，上下文視窗272000，思考等級minimal, low, medium, high, xhigh, max, ultra。說明為「產生 Codex model_catalog.json，讓 /model 指令顯示這些第三方模型名；表中欄目按原樣保存。修改後需要重新啟動 Codex 才能重新整理模型清單。」 - 自訂 User-Agent：影片保留
Mozilla/5.0 ...與右側的「預設」。 - 再往下還有**「本地代理請求覆蓋」（Header 覆蓋／Body 覆蓋）與「auth.json (JSON)」**等區塊。
這一段是選用設定
「進階選項」的內容會依你的需求與供應商而不同。如果只是想先把 Codex 接上瓜瓜AI，可以只填好步驟 4、5 的必要欄位；其餘選項請依畫面說明與自己的需求調整。
步驟 7：點擊「+ 新增」建立供應商
確認設定無誤後，點視窗右下角的 「+ 新增」。建立成功時畫面會顯示「供應商已新增」提示，供應商清單也會出現剛才建立的 gua，位址為 https://api.guagua5487.xyz/v1。
步驟 8：啟用供應商並重新啟動 Codex
在清單中點 gua 卡片右側的 「啟用」 按鈕（按鈕位置見上一張圖的橘框）。切換成功時畫面會顯示：
切换成功，请重新启动客户端以套用
請依照提示重新啟動 Codex，讓新的供應商設定生效。
完成配置
完成後，CC Switch 的供應商清單中會有一張 gua 卡片，位址為 https://api.guagua5487.xyz/v1，並且是你目前啟用的供應商。
找不到「啟用」按鈕？
「啟用」按鈕只會出現在尚未啟用的供應商卡片上。如果 gua 已經是目前使用的供應商，卡片上就不會再顯示這個按鈕。
如果想確認 Base URL 的用途或改在其他工具使用，可以接著看Base URL與第一個 API 請求。