安装 Foxl

请先从下载页面获取 Foxl。本页介绍安装的具体步骤。

系统要求复制锚点链接

• macOS： macOS 13（Ventura）或更高版本，搭载 Apple Silicon（M1 或更新）或 Intel 的 Mac。
• Windows： Windows 10 或更高版本，64 位。
• Linux： 带有 FUSE 的 64 位（x86-64）系统，AppImage 需要 FUSE 才能运行。

不需要另外安装任何东西。Foxl 自带服务器运行时（macOS 和 Linux 上是 Bun，Windows 上是 Node.js）。

想在手机上用？iOS 版在 App Store 上，Android 版以 APK 直接安装：请参阅移动应用。

macOS复制锚点链接

1. 打开下载的 .dmg 文件。
2. 把 Foxl 拖到“应用程序”文件夹。
3. 从“应用程序”中打开 Foxl。
4. 第一次打开时，macOS 可能会询问你是否确定。点击打开。

Mac 版下载是通用版本：在 Apple Silicon 和 Intel Mac 上都能运行。如果你使用 Homebrew，brew install --cask foxl-ai/tap/foxl 会安装同一个版本，而且这个 cask 每次发布都会更新。

Windows复制锚点链接

安装程序： 运行 Foxl-latest-setup.exe 并按步骤操作。它会安装 Foxl 并添加桌面快捷方式。会自动更新的是这个版本。

便携版： 下载 Foxl-latest-portable.zip，解压后运行 Foxl.exe。不会安装任何东西。

如果 Foxl 已经在运行，在你操作安装程序的过程中它会继续运行，即使你取消安装也一样。只有在你点击安装时它才会关闭。如果 Foxl 只为你自己安装，安装程序会在关闭它之前先询问你。如果旧版本是为所有用户安装的，或者正在自动更新，Foxl 会被直接关闭，不会询问。

Linux复制锚点链接

1. 让文件可执行：chmod +x Foxl-latest.AppImage
2. 运行它：./Foxl-latest.AppImage

如果它停在 dlopen(): error loading libfuse.so.2，说明你的系统缺少 FUSE 2，Ubuntu 22.04 及更高版本默认不再安装它。运行 sudo apt install libfuse2（在 Ubuntu 24.04 上软件包名为 libfuse2t64），然后重试。

第一次打开 Foxl复制锚点链接

1. 使用 Google、Apple、GitHub 或电子邮件（魔法链接，或者如果你设置了密码，也可以用密码）登录。登录选项下方的语言选择器可以在登录前设置 Foxl 的语言，你选的语言在登录后也会保留。
2. 应用上方会出现一个简短的设置。选择外观：浅色、深色或跟随系统，以及十九种配色主题之一。介绍一下你自己：你的角色，以及你对技术的熟悉程度，用三张卡片表示（完整的技术细节、只讲概念不讲内部原理，或者通俗易懂的语言）。所有内容都不是必填的：什么都不选也可以点击继续，随时可以用全部跳过或 Escape 退出。
3. 设置 Foxl Notes（桌面应用）。只有一个画面，每一项都是可选的：
   • 在搭载 Apple Silicon 的 Mac 上，在这台 Mac 上运行 Notes（在 Windows PC 或 Linux x64 电脑上是在这台电脑上运行 Notes）会一起安装设备端语音引擎和 Gemma，大约 6.5 GB（只下载电脑上缺少的部分）。它会显示剩余量，可以暂停，在你继续之后也会在后台接着下载。已经能转写和总结的电脑会改为显示就绪。在其他电脑上，会议转写这一项可以填写 AssemblyAI 密钥，如果电脑已经能转写则显示就绪。如果电脑上已经有用于聊天的 Gemini 密钥（在设置 > 模型和提供商中），这一项会显示使用 Gemini，不用再粘贴一次密钥。
   • 麦克风和其他应用的声音：点击允许会弹出系统提示，然后这一项变为已允许。Windows 只请求麦克风权限，Linux 只录制麦克风。
   • 实时翻译：除非你开启，否则保持关闭，同时可以选择翻译成哪种语言。
4. 导入你的设置。 只有当 Foxl 在电脑上发现 Claude Code 或 Codex 的设置，并且其中有 Foxl 还没有的内容时才会出现：它的指令、技能和 MCP 服务器，所有新内容都已勾选。点击导入会导入勾选的内容（指令会追加到 Foxl 的 AGENTS.md 末尾），Foxl 已有的内容不会被替换；什么都不勾选就点击继续则不导入任何内容。之后也可以在设置 > 高级中进行同样的导入。
5. 连接模型。 在还没有任何东西能回复聊天的电脑上，最后一个画面会帮你连接一个模型：OpenRouter、其他提供商，或者在搭载 Apple Silicon 的 Mac 上选择在这台 Mac 上运行 AI（在 Windows 和 Linux 上是在这台电脑上运行 AI；如果在这台 Mac 上运行 Notes已经提供过这个下载，这个画面就不会再提供；如果你在那里点了安装，这里会显示下载进度）。已经能聊天的电脑，也就是有 AWS 凭证、Claude Code 或 ChatGPT 登录、Ollama 或提供商密钥的电脑，不会看到这个画面。请参阅快速开始。
6. 快速导览会指向计划、代理和聊天；在 macOS 和 Linux 应用中还会指向标题栏中的绿点（它会打开一个状态面板，显示正在运行的内容、当前聊天的 token 用量和费用，以及你的套餐或额度还剩多少）；在桌面应用中还会指向模型和提供商设置。第一次打开 Foxl Notes 时，会有一个简短的导览介绍它的主要控件；第一次打开设置时，另一个导览会介绍几个只在设置中才有的功能（Chrome 扩展、Mac 上的电脑操作、随处语音输入，以及在 Mac 或 Windows PC 上的关闭后继续运行），最后以为 Foxl Notes 连接日历结束。

在新安装的 Foxl 上，计划任务或代理完成时，Foxl 不会通知你；但它们失败时、有设备连接时以及需要你回答时，仍然会通知你。如果你想收到完成通知，请在设置 > 通知中的计划任务或代理下开启任务完成。已经使用过 Foxl 的电脑会保留原有的通知设置。

在 Windows 上，设置画面的“继续”旁边还会显示登录时启动 Foxl，默认开启。只有在保持开启的状态下完成设置，Foxl 才会被添加到你的登录启动应用中。之后可以在设置 > 通用 > 登录时启动中更改。

想再看一遍设置？设置 > 外观中有重新查看初始设置，下方的重置新手引导会在你登录时为你的账户重新开始设置：它会在你接下来打开的任意一台设备上再运行一次。在任意一台已登录的设备上完成或跳过设置，就会在所有设备上视为完成。手机应用会跳过这个设置，直接进入应用，除非你在手机上通过“重新查看初始设置”主动要求，或者重置要求再运行一次；这时在手机上，外观画面只会询问浅色、深色或跟随系统。在 app.foxl.ai 上，新账户第一次登录时会显示外观和自我介绍画面以及导览；Notes、导入你的设置和连接模型这几个画面只在桌面应用中出现。

Windows 和 Linux：托盘、窗口和菜单复制锚点链接

• 点击托盘图标可以打开窗口。 在 Windows 上，单击或双击系统托盘中的 Foxl 图标即可让窗口重新出现。在 Linux 上，只要桌面环境允许，单击就能打开。在 macOS 上，单击菜单栏图标会打开它的菜单。
• 关闭窗口。 在 Windows 上，无论是否显示托盘图标（设置 > 通用中的在系统托盘中显示），关闭窗口后 Foxl 都会继续运行。在 Linux 上则取决于这个设置：托盘图标开启时，Foxl 会继续运行（第一次会有通知说明这一点以及如何返回）；关闭时，关闭窗口就会退出 Foxl。
• 菜单跟随应用的语言，菜单栏和托盘菜单都是。刚完成全新安装时，在 Foxl 窗口加载一次之前，菜单会显示为英文。
• 在 Linux 上，菜单栏默认隐藏，按 Alt 才会显示。Ctrl+Q 等快捷键在两种状态下都能用。
• Ctrl+R 不会重新加载应用。 菜单中仍然有视图 > 重新加载，只是没有快捷键；在终端中，Ctrl+R 仍然会发送给 shell。macOS 上的 Cmd+R 不变。
• Windows 任务栏固定。 Foxl 使用与其“开始”菜单快捷方式相同的应用标识运行，Windows 用这个标识来发送通知，并把固定的 Foxl 与它的窗口归为一组。登录时启动也使用这个标识，所以登录时 Foxl 不会启动两次。在 0.7.36 或更早版本中从 Foxl 窗口固定的项目，会在 Foxl 启动后不久迁移到这个标识。如果仍然看到两个 Foxl 按钮，请取消固定 Foxl，然后重新固定。

浅色、深色和窗口复制锚点链接

Foxl 会跟随系统的浅色或深色设置。要自己选择，请打开设置 > 外观；同一页面上还有十九种配色主题和十五种表面（请参阅外观）。你的选择会应用到桌面应用、app.foxl.ai 和手机应用。

在 macOS 26（Tahoe）及更高版本上，窗口的外框是半透明的，所以在内容保持不透明的同时，桌面会从侧边栏后面透出来。更早的 macOS、Windows 和 Linux 使用普通的不透明窗口。

更新复制锚点链接

Foxl 会自动检查更新，并在你退出应用时安装。

如果更新无法完成（有东西仍在使用这个应用），Foxl 会在下次启动时通过铃铛和设置告诉你，并提供重试。

Beta 更新复制锚点链接

在设置 > 通用的更新下，打开 Beta 更新开关，就能在测试版一发布时就收到，比其他人早一个版本。

• 测试版是同一个 Foxl，以同样的方式签名，使用你平常的账户和数据。只是应用版本更超前。
• 对应的稳定版发布后，你会自动转到稳定版。
• 把开关关闭后，你会停留在当前版本，直到对应的稳定版发布。它绝不会让你回退到旧版本。
• 测试版以预发布版本的形式发布，所以开关关闭时你永远不会收到测试版，下载链接也始终提供稳定版。

需要帮助？复制锚点链接

请参阅故障排除，或者在我们的 Discord 社区中提问。