從這個問題開始
這一課只做一件事：把三樣工具裝好，並且逐一驗證。你會先安裝 Node.js（CLI 的運行環境），再安裝 CodeBuddy 編輯器，最後用 npm 安裝 CodeBuddy CLI 並登入。每一步都有明確的預期結果，見不到預期結果就不要進入下一步。
準備的工具與材料
- 符合目前 CodeBuddy 與 Node.js 系統要求的 Mac 或 Windows 電腦
- 可正常下載及登入的網絡連線
- 可使用 CodeBuddy 的帳號
本課完成後，你能做到
第一，說清楚三樣工具的分工：Node.js 是 CLI 的運行環境，CodeBuddy 編輯器（IDE）是你管理檔案與對話的視窗，CodeBuddy CLI 是在終端機裡接收指令、實際操作檔案的程式。第二，在自己的電腦完成全部安裝，並用版本號指令確認每樣工具真正可用。安裝所需時間視網絡及電腦環境而定。
開始之前
- 確認電腦系統符合上方「準備的工具與材料」
- 預留約 30 分鐘不被打斷的時間
- 安裝過程中如系統詢問權限，看清內容才按允許；本教程不需要你關閉任何系統安全設定
第 1 步：安裝 Node.js
CodeBuddy CLI 透過 npm 安裝，而 npm 隨 Node.js 一同提供，所以要先裝 Node.js。
- 用瀏覽器打開 Node.js 官方下載頁：https://nodejs.org/en/download
- 選擇標示為 LTS（長期支援）的現行版本。LTS 是官方持續維護的穩定版本，請不要安裝已停止支援的舊版本。
- Mac 選 macOS 安裝包（.pkg），Windows 選 Windows 安裝程式（.msi）；如下載頁提供處理器架構選項，按你的電腦選擇（Mac 可在「關於這台 Mac」查看晶片；Windows 在「設定 → 系統 → 關於 → 系統類型」確認 x64 或 ARM64）。
- 打開下載好的安裝程式，按畫面提示逐步完成安裝。
- 安裝完成後，關閉所有已打開的終端機視窗，再重新打開一個新的終端機（Mac 叫「終端機」，Windows 可用「命令提示字元 cmd」）。
在新開的終端機輸入以下第一行，按 Enter，再輸入第二行：
node --version
npm --version預期結果：兩行各自顯示一個版本號（例如 v22.x.x 與一組數字）。兩個版本號都見到，Node.js 才算裝好。見不到就不要繼續，先看本課「常見問題」。
第 2 步：安裝 CodeBuddy 編輯器
- 用瀏覽器打開 CodeBuddy 官方網站 https://www.codebuddy.ai/，進入下載頁。
- 按你的系統選擇對應版本下載。
- Mac：如下載到的是 .dmg，打開後把 CodeBuddy 拖進「應用程式（Applications）」資料夾；如是其他安裝包形式，按畫面指示完成。Windows：打開安裝程式，按安裝精靈逐步完成。
- 打開 CodeBuddy，確認能見到主介面（左邊檔案總管、中間編輯區、右邊 AI 對話面板）。
第 3 步：安裝 CodeBuddy CLI
CLI 透過 npm 安裝。打開一個新的終端機（或在 CodeBuddy 內打開整合終端機），輸入以下指令：
npm install -g @tencent-ai/codebuddy-code預期結果：安裝過程完成、沒有未處理的安裝錯誤。完成後輸入：
codebuddy --version預期結果：顯示 CLI 的版本號。見到版本號，CLI 才算裝好。
最後啟動 CLI：
codebuddy預期結果：CLI 啟動並顯示登入或初始引導畫面。按畫面當時提供的登入方式完成登入。可用模型、用量與費用以你帳號內顯示為準，本教程不作任何費用承諾。CLI 內的指令（例如查閱可用指令用 /help）以 /help 列出的內容為準。
常見問題
完成清單
官方參考
Node.js 官方下載頁：https://nodejs.org/en/download CodeBuddy CLI 安裝文件：https://www.codebuddy.ai/docs/cli/installation （中文：https://www.codebuddy.cn/docs/cli/installation ） 以上連結內容於 2026-10-18 核實；官方頁面如有更新，以官方為準。