簡短回答
npx apiyi@latest 是臨時下載、跑完即走，不會在電腦上留下一個 apiyi 命令。所以接下來的每條命令都要寫成 npx apiyi@latest …，例如儲存 Key：
apiyi，就全域性安裝一次：npm i -g apiyi。
問題現象
第一次執行自檢，提示沒有 Key，照著提示敲命令卻報錯：原因
npx 會把 CLI 下載到 npm 的臨時快取裡執行，不會把 apiyi 加進系統 PATH。0.2.1 及以前的版本，提示裡寫的是簡寫 apiyi auth set-key，照抄就會撞上這個報錯。
從 0.2.2 起，CLI 會識別自己是不是通過 npx 執行的，提示裡直接給出完整寫法 npx apiyi@latest auth set-key；--help 也會說明這一點。
解決方法
- 一直用 npx（推薦，零安裝）
- 全域性安裝一次
- 用環境變數
每條命令前都帶上
npx apiyi@latest，始終是最新版，不在電腦上留東西：完整的首次配置步驟
1
複製 Key
開啟 令牌頁面，複製一個以
sk- 開頭的令牌；沒有就先新建一個。2
儲存 Key
執行
npx apiyi@latest auth set-key，出現 API key (input hidden): 後貼上並回車。
輸入時螢幕上不顯示任何字元，這是為了防止 Key 被旁人看到，屬於正常現象。
看到 Saved apiKey to ~/.config/apiyi/config.json (mode 0600) 就是成功了。3
重新自檢
執行
npx apiyi@latest check，status 顯示 ok 說明 Key 有效、節點連通。4
發第一條訊息
執行
npx apiyi@latest chat "你好" -m gpt-5.4-mini，能看到回覆和 token 用量就全部跑通了。常見問題
貼上 Key 時螢幕沒有任何反應，是不是沒粘上？
貼上 Key 時螢幕沒有任何反應，是不是沒粘上？
是隱藏輸入，粘貼後直接回車即可。不放心可以用
npx apiyi@latest auth show 檢視，會打碼顯示已儲存的 Key。已經 npm i -g apiyi 了，還是 command not found？
已經 npm i -g apiyi 了，還是 command not found？
說明 npm 的全域性目錄不在 PATH 裡。執行
npm prefix -g 看全域性目錄，把它下面的 bin 子目錄加進 PATH（寫進 ~/.zshrc），然後重開終端。用 nvm 管理 Node 時，切換 Node 版本後也需要在新版本下重新全域性安裝。Key 存在哪裡？怎麼刪除？
Key 存在哪裡？怎麼刪除？
儲存在
~/.config/apiyi/config.json，檔案權限 0600，只有當前使用者能讀。刪除用 npx apiyi@latest auth clear。提示 Node 版本太低？
提示 Node 版本太低？
CLI 需要 Node 18.17 及以上。執行
node -v 檢視版本，低於這個版本請先升級 Node。查餘額也報 no_key 或權限不足？
查餘額也報 no_key 或權限不足？
普通
sk- Key 讀不到餘額，查餘額要用個人訪問令牌（nap_ 開頭）：npx apiyi@latest auth set-key --access-token。詳見 什麼是個人訪問令牌？相關文件
AI 開發者套件 · CLI 命令列
全部命令、Key 的查詢順序、退出碼
API Key 無效怎麼辦？
check 返回 invalid_key 時看這裡