安裝與準備 — Noea Code 文件

開始前，請安裝 Noea 桌面應用程式並準備至少一個程式開發 Agent。應用程式會引導你完成安裝、登入及連線驗證。

選擇安裝程式

前往 Noea 下載區，選擇符合作業系統與處理器的版本。

系統	選擇方式
macOS	Apple silicon，macOS 13 或更新版本。目前不提供 Intel Mac 安裝程式。
Windows	Intel 或 AMD 處理器選 x64；Windows on ARM 裝置選 ARM64。
Linux	依處理器選擇 x86_64 或 ARM64，提供 AppImage 與 `.deb` 套件。

macOS 請開啟磁碟映像檔並安裝應用程式。Windows 請執行安裝程式；它會為目前使用者安裝，不需要系統管理員權限。Linux 請依發行版選擇 AppImage 或 .deb。

Noea 啟動時若沒有就緒的 Agent，會開啟設定引導。

Noea 目前支援 Codex、Claude Code、OpenCode 與 CodeBuddy Code。開始時只需一個，之後可在設定 → AI 代理加入其他 Agent。

Noea 會下載 Agent 所需的執行環境，不必事先安裝 Node.js。下載及準備進度會顯示在應用程式中。

登入可能開啟瀏覽器、應用程式內終端機或系統終端機，也可能要求 API 金鑰。請依所選 Agent 的指示操作。

Codex 在 macOS 與 Windows 優先使用瀏覽器登入，在 Linux 使用裝置代碼登入。OpenCode 透過連接模型供應商完成設定。供應商帳號、API 金鑰及自訂端點請參閱 Agent、模型與用量。

登入後 Noea 會再次驗證連線。若仍要求登入或回報失敗，請開啟 Agent 詳細資訊面板查看原因。

即使你已在其他終端機工具使用某個 Agent，仍應以 Noea 清單中的狀態判斷它在此是否就緒。

下載及 Agent 請求使用系統的 HTTP(S) 代理設定；若設定代理環境變數，則優先使用環境變數。此機制不支援 SOCKS 代理。

下載失敗時，先檢查網路與代理設定，再從原處重試。接收資料短暫停頓時顯示準備中，不一定代表下載失敗。

安裝成功但驗證失敗時，請在 Agent 詳細資訊面板重新登入、修正供應商設定或處理網路問題。求助時可複製診斷資訊，參閱疑難排解。

在工作台選擇打開資料夾…並選取程式碼資料夾。Noea 會開啟或建立連結專案。完成第一個教學不需要完整的需求文件、MCP 伺服器或 Skills。