安装与准备 — Noea Code 文档

开始使用 Noea 前，需要安装桌面应用，并让至少一个编程 Agent 完成安装、登录和验证。应用会引导你完成这些步骤。

选择安装包

在 Noea 官网下载区选择与你的系统和处理器对应的版本。

系统	选择方式
macOS	Apple 芯片，macOS 13 或更新版本；当前不提供 Intel Mac 安装包
Windows	Intel 或 AMD 处理器选择 x64，Windows on ARM 设备选择 ARM64
Linux	按处理器选择 x86_64 或 ARM64；提供 AppImage 和 `.deb`

macOS 打开磁盘映像后安装应用；Windows 运行安装程序；Linux 根据发行版使用 AppImage 或 .deb。Windows 安装程序按当前用户安装，不要求管理员权限。

首次启动时，如果没有可用的 Agent，Noea 会进入引导界面。

当前支持 Codex、Claude Code、OpenCode 和 CodeBuddy Code。你只需要准备其中一个，也可以随后在“设置 → 智能体”中添加其他 Agent。界面中的“智能体”就是本文所说的 Agent。

Noea 会自动下载 Agent 所需的运行环境，无需预先安装 Node.js。下载和准备进度会显示在界面中。

登录可能打开浏览器、应用内登录终端或系统终端，也可能要求输入 API Key。请按照当前 Agent 的提示完成。

Codex 在 macOS 和 Windows 上优先提供浏览器登录，在 Linux 上优先提供设备码登录。OpenCode 通过连接模型供应商完成准备；供应商支持的账号登录、API Key 和自定义端点入口见Agent、模型与用量。

登录结束后，Noea 会再次验证连接。如果仍显示“需要登录”或失败，请打开该 Agent 的详情面板查看原因。

在其他终端工具中已经使用过某个 Agent，也请以 Noea 清单中的状态为准。

下载和 Agent 请求会使用系统 HTTP(S) 代理设置；已通过环境变量指定代理时，以环境变量为准。SOCKS 代理不在这一支持范围内。

如果下载失败，先检查网络和代理，再使用原位置的重试操作。短时间没有新数据时出现“正在准备”，不一定意味着任务已经失败。

如果安装成功但验证失败，打开 Agent 的详情面板，按提示重新登录、修正供应商配置或处理网络问题。需要求助时可以复制诊断信息，见故障排查。

进入工作台后，使用“打开文件夹…”选择你要处理的代码目录。Noea 会为它打开或创建关联项目。第一篇教程不要求你先整理完整需求，也不要求先添加 MCP 或 Skill。