进阶 jean.build 2026-10-18 10:33:18 · 23 阅读

第4章 Jean 桌面应用安装与后端配置指南

安装与配置 安装 Jean,接入你偏好的后端,完成首次运行的设置。Jean 是原生桌面应用,可以配合你现有的 CLI 工具使用,支持 Claude CLI、Codex CLI、OpenCode、Cursor Agent、PI、Command Code、Grok、Kimi Code,也可以混搭使用。Git 为必需项;GitHub CLI 和 Linear API key 为可选项,但配置后可以解锁更多工作流。

你需要准备什么

Git 至少一个后端:Claude CLI、Codex CLI、OpenCode、Cursor Agent、PI、Command Code、Grok 或 Kimi Code Jean 安装包:来自 Homebrew 或 coollabsio/jean releases 可选:GitHub CLI,用于 issues、PR、工作流和安全上下文 可选:Linear 个人 API key,用于 Linear issue 流程

安装 Jean brew tap coollabsio/jean brew install --cask jean 也可以从 coollabsio/jean/releases 下载最新的桌面版安装包,然后按 macOS、Windows 或 Linux 的常规方式安装即可。

完成配置 Jean 首次启动时会检测是否已安装受支持的后端。 如果没有检测到,欢迎界面会引导你完成配置,之后才能添加项目。 在配置流程中,你可以:

检查各 CLI 的安装状态 为 Claude CLI、Codex CLI、GitHub CLI、OpenCode、Cursor Agent、PI、Command Code、Grok 和 Kimi Code 完成认证 当存在基于路径或 Jean 托管的安装时,选择每个 CLI 的来源 设置默认后端、模型及其他默认项 选择是否让 Jean 使用你偏好的应用打开终端和编辑器

推荐做法如果你刚接触 Jean,建议先只配置一个你已经熟悉的后端,之后再逐步添加其他后端。首次使用时组件越少,越容易上手。

可选工具

GitHub CLI 提供 issue、PR、工作流和安全排查相关的流程。 Linear API key 让 Jean 可以把 Linear issue 引入新建会话的流程。 自定义 Claude CLI provider 配置文件,让你可以把 Claude CLI 路由到备用端点,同时不影响 Jean 的工作流。

Web 访问稍后再配置每个 Jean 实例都可以开启 Web 访问(在桌面端 Preferences 中,或通过 jean-server 二进制文件)。这是运行时的选择,不属于安装步骤。配置完成后可参考 Web 访问指南——远程使用建议配合 Tailscale 或类似的私有网络。

接下来阅读

添加你的第一个项目 开始你的第一个会话 后端、模型与 MCP Web 访问与 headless 模式

本地优先与安全性 Jean 存储了什么、哪些数据保留在本地,以及 Web 访问的安全机制。

添加你的第一个项目 把仓库引入 Jean,在侧边栏中整理,并决定第一天就启用多少自动化。

评论 (0)