多數人卡在ZCode的第一步不是安裝，而是「這四個格子到底要填什麼」。要準備的東西其實只有四樣：基礎位址、API格式、API Key、模型ID，剩下都是介面操作。
先把路線畫出來：裝好桌面端、從控制台拿一把金鑰、新增自訂供應商、把四格填齊、同一把金鑰再掛幾個模型，最後回對話裡確認請求真的走了自己的金鑰。截圖按這個順序排。
| 項目 | 本次環境 |
|---|---|
| 系統 | Windows 11 |
| 用戶端 | ZCode桌面版（2026年10月介面） |
| 示例模型 | glm-5.3 |
| 要填的欄位 | Base URL、API格式、API Key、模型ID |
一、安裝這一步，兩屏都能跳
官網下載頁把三種系統的安裝包並排放在一起，Windows挑x64那個，雙擊後照向導走完，從開始選單啟動就好。
第一次啟動會先問工作方向：開發、維運、設計、財務等十二個選項。它只影響用戶端怎麼理解你的場景，跟接口能不能接上完全無關，左下角「跳過」。
接著是「歡迎來到ZCode」，要你連帳號。供應商下拉預設指向某個內建服務，下方是API Key欄位——那格收的是內建服務的金鑰，接自己的接口時派不上用場，按底部「暫時跳過」。
兩屏跳過就進主介面，之後加多少供應商，入口都在同一處，不用回頭補。
二、Key與費用，都在控制台解決
金鑰不是登入密碼，這點先分清楚。ZCode要的是閘道發的憑證——閘道，簡單說就是你把模型額度買在裡面的那個API服務。我這次用Crazyrouter：進去後從左側「令牌管理」建立一把，名字給它叫zcode方便日後辨認；字串只在建立當下完整顯示，錯過就得重來。
額度、有效期、能調哪些模型，全在控制台；用戶端不管這些，它只負責把金鑰帶在請求上。示例用的模型是glm-5.3，先把這把金鑰對它的權限確認好，再往下走。還沒帳號的人，註冊入口就在同一個站點。
費用是按量結算，用多少扣多少，沒有月費門檻。儲值入口與活動頁都在控制台裡，當期優惠與贈送額度以頁面顯示為準；頭一次先儲小額，確定整條路走得通，再依需要補。
三、建供應商、填四格
設定左側的分組由上往下是：基礎設定（常規、外觀、模型設定、瀏覽器控制、遠端裝置、電腦控制、鍵盤快捷鍵），再來是Agent能力（記憶、子智能體、外掛、MCP伺服器、技能、命令、鉤子）。
「模型設定」的右上角有「新增供應商」。面板分兩段：上面是內建卡片，選了只補金鑰；下面「其他」列著常見廠商，排頭一個是「建立自訂供應商」。
差別只有一處：接入參數由誰提供。內建卡片的位址與協議寫死在卡片裡，自訂供應商則全部自己來；閘道不在名單內、或你用的是自建位址，就走自訂。建過的供應商會留在左側，點名字就能改，不必重建。
按下之後右側出現六項：名稱、啟用開關、Base URL、API格式、API Key、模型列表。
名稱預設「新供應商」，只決定列表顯示什麼；改成「團隊閘道」這種一眼認得出的名字，日後在選單裡挑分組不容易點錯。
Base URL寫到域名為止，這次填的是：
https://api.crazyrouter.com結尾別接/v1或/messages：位址與協議分屬兩件事，路徑交給下面的格式選項；硬往後補路徑，多半換來一個404。
API格式挑含/v1/messages的那一項。它管兩件事：請求打哪個路徑、回包按哪套欄位解析，必須與閘道實際開通的協議相符，不能憑感覺。挑錯的結果通常落在400或404，而不是鑑權失敗。另外，/v1/messages與/v1/chat/completions是兩種報文格式，位址再準，格式錯也通不了。
API Key放進去的該是剛複製的金鑰，不是登入密碼。填完按右側眼睛核對：開頭多一個空格、結尾少幾個字元，結果都會變成401。金鑰留在本機設定裡，別貼進對話或群組請人代看。
模型列表按「+ 新增模型」，彈層填ID。先放一個常用的就夠；要加第二、第三個，不必再建供應商，下一節說明。每行尾端有開關與刪除，關掉即從對話選單消失。
最後看一眼右側頂部的供應商開關是不是啟用狀態；表單改完沒儲存就退出，前面的工夫全白費。
內建卡片不好嗎？它只覆蓋幾家主流服務，模型與金鑰都由卡片決定。自訂的價值在於把額度收在一個帳戶、一把金鑰打通多家模型，換模型不必換供應商。若你只用一家、圖省事，內建確實更快；兩條路不衝突，加錯了左側刪掉就好。
四、同一把金鑰掛多個模型，再回對話驗證
模型ID別手打。控制台進模型廣場，搜glm，清單會即時收斂，截圖裡是170個模型中的10個。
卡片右上「Details」進詳情，旁邊的圖示複製ID；貼回表單時大小寫照原樣。要第二個模型，就再按一次「+ 新增模型」：同一個供應商底下能掛多條，位址與金鑰共用，差別只在ID。
位址與金鑰決定請求進哪個閘道，ID決定閘道裡叫哪一個模型，所以不必重填前兩項，也不必另建供應商。關掉不用的那條，選單就只剩剩下的；能加哪些、上下文多長看卡片標註，能不能跑則看控制台給這把金鑰開的權限。
存檔後新開會話，模型選單先找供應商分組，再挑模型，丟一句最短的指令測試。通了的話，對話框右下角會標出當前模型——截圖裡是glm-5.3，跟在後面的「高」代表思考強度檔位。
找不到模型，照三處巡一遍：供應商開關、模型行尾開關、表單有沒有存檔；都沒問題就退出設定重進，讓清單重抓。
另一種情況更常見：設定都對，對話卻仍走別人的金鑰。看會話當下選中的是不是新分組——加了供應商，不等於會話已經切換。截圖那行提示就是切換紀錄：從內建分組切到「新供應商/glm-5.3」，底部「選擇模型」按下確認，之後的請求才真的帶著自己的金鑰。
切完之後，換模型只是選單裡換一項，設定不用再碰。裝了兩個以上供應商時，選單會按供應商分組，同名模型出現在兩組很常見，挑的時候分組名優先於模型名。
五、glm型號這麼多，怎麼挑
glm在廣場裡是一整屏，但命名有跡可循：版本號後面接後綴，flash是低成本檔、flashx是它的加速版、帶v的偏視覺、ocr專做文字辨識、legal針對法律場景；同代數字越大越新，後綴決定用途。
| 型號 | 官方定位 | 上下文/輸出 | 適合做什麼 |
|---|---|---|---|
| glm-5.3 | 旗艦，複雜軟體工程與Agent任務 | 1M / 128K | 整專案重構、長鏈路調試、跨檔案改動 |
| glm-5.3-flash | 原生多模態，低成本架構 | 1M / 128K | 邊看介面邊改程式碼、做PPT表格文件 |
| glm-5.3-flashx | flash的加速版，約200 tokens/s | 1M / 128K | 批量小任務、不想等的地方 |
| glm-5.3-flashx-legal | 法律場景優化 | 1M / 128K | 合約審查、法條檢索、文書起草 |
| glm-5.2 | 上一代旗艦，長程任務穩 | 1M / 128K | 已有流程不想動、求穩 |
| glm-ocr | 輕量圖文解析 | 單圖10MB、PDF 50MB，最多100頁 | 掃描件、票據、複雜版式的PDF |
| glm-5v-turbo | 早期多模態 | 以卡片標註為準 | 只想識圖、要便宜 |
再往前的glm-5.1、glm-5、glm-5-turbo、glm-3-turbo屬舊世代，除非既有流程綁著它們，新專案直接從5.3系挑。
按人和活來配：學生與剛接手的，用glm-5.3-flash，看圖、讀課件、改課程作業的小腳本都夠，成本也低；獨立開發者與接案的，把glm-5.3當主力，讀長文件、改整段程式碼，收尾用flash補完，再順手看介面截圖核對；團隊與長週期專案直接用glm-5.3，整個儲存庫或長文件塞進1M上下文，重活集中在這條；法務與行政把合約、檢索交給flashx-legal，掃描件與票據交給glm-ocr；內容與營運用flash出PPT、表格、圖生文，長稿改寫再換回5.3。
預算優先就從flash起跑，效果不足再升5.3；速度優先挑flashx。拿不準時，把同一段需求交給兩個模型各跑一次，比返工次數比看參數快。
順帶一個細節：glm-5.3永遠開著思考，分low、high、max三檔，截圖裡那個「高」就是它。瑣碎問答調low省時間，複雜改動給max。
裝、接、掛、切、挑，五件事做完，ZCode跑的就是你自己的金鑰。之後拿不準，回選單換一條試，比重配一次快。你的主力模型是哪一條？留言聊聊你踩過的坑。
1) --- 會變成分隔線（上一行必須是空白）
2) # 會變成一級標題
3) ## 會變成二級標題
4) ### 會變成三級標題
5) **粗體文字**會顯示粗體文字
6) ```當第一行與最後一行會顯示程式碼
7) 請搜尋 Markdown 語法，了解各種格式
