jcode 是什么?

jcode 是用 Rust 编写的本地 AI 编程代理外壳,提供终端界面、无头 run 模式、会话恢复、多代理协作、MCP、浏览器工具和多家模型提供方接入。程序本身采用 MIT 许可,但真正执行模型请求仍依赖用户已有的 OAuth 订阅、API key 或本地模型服务。

⭐ 20,394 Stars 🍴 2,377 Forks Rust MIT 作者: 1jehuang
来源:github.com/1jehuang/jcode;https://github.com/1jehuang/jcode/blob/mast… 查看 GitHub 仓库 → 📘 使用教程 →

为什么值得关注

官方在 2026-09-20 发布 v0.86.0,集中修复 OpenAI WebSocket 恢复、用量与成本估算、定时任务、客户端技能和共享 SSH 连接。

来源:github.com/1jehuang/jcode/releases/tag/v0.86.0

核心功能

多提供方认证

可接 Claude、OpenAI、Gemini、Copilot、Azure、多个 OpenAI 兼容服务,也支持 Ollama、LM Studio 和自建 vLLM。OAuth 与 API key 是不同凭据路径,应分别检查。

来源:github.com/1jehuang/jcode/blob/master/README.md;https://github.com/1j…
会话与多代理协作

TUI、无头命令和 SDK 共用会话能力;swarm 模式可在同一仓库中运行多个代理,并在已读文件被其他代理修改时发出通知。

来源:github.com/1jehuang/jcode/blob/master/README.md;https://github.com/1j…
远程与工具接入

支持原生 SSH 会话、MCP、浏览器工具、侧边面板和自定义 OpenAI 兼容 endpoint;远程凭据导入和外部凭据复用有单独的确认流程。

来源:github.com/1jehuang/jcode/blob/master/README.md;https://github.com/1j…
赞助工具发现

内置 discover_tools 会向托管目录请求第三方工具。该功能默认开启,目录可能包含付费赞助位置;请求包含类别、能力摘要和选择理由,配置收件人后相关摘要可能交给赞助商。

来源:github.com/1jehuang/jcode/blob/master/crates/jcode-base/src/sponsors.…

技术架构

jcode 的 Rust workspace 将 TUI、应用核心、provider、认证、遥测和 SDK 拆成多个 crate。本地客户端连接 jcode server 管理会话和工具;模型请求按所选 provider 发送到对应 OAuth、API 或本地 endpoint。MCP 与浏览器属于额外工具边界。discover_tools 另行请求 api.jcode.sh 的托管目录,普通遥测也走独立后端,因此不能把“客户端开源”理解成“全程离线”。

来源:github.com/1jehuang/jcode/blob/master/README.md;https://github.com/1j…

项目知识图谱

知识图谱:项目核心节点(中心)+ 核心功能(内环六边形)+ 关键技术依赖(外环 chip) macOS Apple Silicon/Intel、Linux x86-64/aarch64、Windows x86-64/ARM64;v0.86.0 release 另列 FreeBSD x86-64 资产macOS Apple Si… 在线模型需要对应订阅或 API key;Ollama、LM Studio、自建 vLLM 可走本地或自管 endpoint在线模型需要对应… 源码构建需要 Rust toolchain;Windows 源码构建还需要 Visual Studio 2022 C++ workload源码构建需要 Ru… 多提供方认证 会话与多代理协作 远程与工具接入 赞助工具发现 jcode 项目本体 核心功能 关键依赖

技术栈

语言Rust workspace,原生 TUI、server、SDK 与 provider adapters框架Cargo、Tokio 风格异步服务、多 provider/OAuth、MCP、SSH 与本地会话存储
macOS Apple Silicon/Intel、Linux x86-…在线模型需要对应订阅或 API key;Ollama、LM Studio…源码构建需要 Rust toolchain;Windows 源码构建还需…
默认在 ~/.jcode 与平台配置目录保存会话、认证和 provider 配置;普通遥测默认开启,赞助发现默认开启;MIT 许可
来源:github.com/1jehuang/jcode/blob/master/README.md;https://github.com/1j…

快速上手

固定 v0.86.0 并优先从官方 release 或 Homebrew 安装。首次启动前先执行 jcode telemetry status;不希望发送匿名使用数据时运行 jcode telemetry disable,并在 ~/.jcode/config.toml 设置 [sponsors] enabled = false。随后只配置一个已有 provider,用 jcode auth status --json 和 auth-test 核对来源,再在测试仓库执行一次只读提示。不要让安装代理自行读取或导入其他工具的凭据。
来源:github.com/1jehuang/jcode/releases/tag/v0.86.0;https://github.com/1je…

使用场景

适合希望在一个终端外壳里切换多个模型提供方、恢复会话、运行并行代理或连接远程开发机的人。只需要简单问答或单一 provider 时,额外的 server、认证和遥测配置会增加维护量;严格离线环境应改用本地模型,并关闭遥测、赞助发现和不需要的网络工具。

来源:github.com/1jehuang/jcode/blob/master/README.md;https://github.com/1j…

优势与局限

优势

  • TUI、无头运行、SDK、SSH 和多代理协作集中在同一套会话系统
  • OAuth、API key、本地模型和自定义 OpenAI 兼容 endpoint 的覆盖面较广
  • 提供 auth status、auth-test、telemetry status 和卸载 dry-run 等可核对入口
  • MIT 许可,主要客户端与遥测实现可以直接审阅

局限

  • 客户端免费不等于模型免费;OAuth 订阅、API 用量和第三方工具费用由各提供方决定
  • 普通遥测默认开启,使用随机安装 ID 记录 provider、模型、会话结果和功能级计数;可完全关闭
  • 完整 transcript 分享虽默认关闭,但一旦主动开启会上传提示、回答、保留的推理、消息内源码和工具结果
  • 赞助工具发现默认开启,付费位置会显示披露;能力摘要和选择理由会发到发现服务,配置赞助商收件人后还可能用于赞助报告
  • 外部凭据导入在确认后直接读取其他工具的认证文件;应逐个确认来源,不能把历史 auth-validation 缓存当成当前有效状态
  • 官方 README 的性能比较来自项目方自己的特定机器与启动测试,不能外推为所有仓库、终端和模型上的实际表现
来源:github.com/1jehuang/jcode/blob/master/README.md;https://github.com/1j…

最新版本

最新稳定版是 v0.86.0,官方于 2026-09-20 发布。该版让 Rust/TypeScript 客户端区分 assistant、final 与 retry replacement,复用已认证 SSH 连接,并修复 OpenAI WebSocket 恢复、usage/cost 统计、定时任务和本地客户端技能加载。

来源:github.com/1jehuang/jcode/releases/tag/v0.86.0

实测与证据

status: docs_and_source_checked_not_executed  |  checked_at: 2026-09-23  |  environment: 核对官方 README、v0.86.0 release、MIT LICENSE、TELEMETRY.md、认证来源文档、赞助发现源码与赞助接入 runbook;未安装或运行 jcode。  |  limitations: 没有验证二进制签名或 checksum、安装脚本、实际内存占用、provider 登录、模型计费、工具权限、SSH、swarm、MCP、浏览器、遥测网络包或 Windows/FreeBSD 兼容性。  |  observed_output: 官方 release 将 v0.86.0 标为 2026-09-20 发布,并列出 Linux、macOS、Windows、FreeBSD 对应资产。源码明确写出普通遥测和赞助发现的默认状态及关闭方法;

来源:github.com/1jehuang/jcode/releases/tag/v0.86.0;https://github.com/1je…

同类项目对比

相比 OpenCode,jcode 更强调原生 Rust TUI、共享 server、SSH 会话和内建 swarm;OpenCode 的官方文档与生态更集中在其 client/server、模型与插件体系。两者都支持多 provider,实际选择应看你已有的认证方式、团队需要的扩展和是否接受默认遥测或赞助发现。先用同一个小仓库、同一个模型跑相同任务,再比较启动、权限提示、diff 可读性与总费用。

来源:github.com/1jehuang/jcode/blob/master/README.md;https://github.com/an…

总结评价

推荐从 v0.86.0、小测试仓库和单一 provider 开始;首次运行前明确决定是否关闭遥测和赞助发现,只在需要时授权外部凭据、SSH、MCP、浏览器或 swarm。

来源:github.com/1jehuang/jcode/releases/tag/v0.86.0;https://github.com/1je…

常见问题

jcode 本身免费,为什么运行仍可能花钱?

jcode 客户端采用 MIT 许可,但云端模型由对应 provider 计费,或要求已有订阅。使用 Ollama、LM Studio 或自建 vLLM 可把推理放到自己的机器或服务器,硬件和运维成本仍由你承担。

怎样彻底关闭 jcode 普通遥测?

运行 jcode telemetry disable,或设置 JCODE_NO_TELEMETRY=1、DO_NOT_TRACK=1,也可创建 ~/.jcode/no_telemetry。官方文档称关闭后遥测模块不会发网络请求;可用 jcode telemetry status --json 检查。

赞助工具发现会发送什么?可以关闭吗?

discover_tools 会发送固定类别、重新概括的能力需求和选择理由;服务可能把与赞助条目相关的摘要交给已配置的赞助商收件人。它默认开启,在 ~/.jcode/config.toml 写入 [sponsors] enabled = false 可关闭。

jcode 会自动读取 Codex、Claude Code 或 OpenCode 的登录凭据吗?

它能发现这些外部凭据来源,但官方认证文档称读取前要逐项同意,凭据不会复制进 jcode 自己的存储。先用 jcode auth status --json 查看来源,只授权你认识的文件。

卸载 jcode 会删除会话和密钥吗?

普通卸载默认保留配置、认证和会话,方便重装后继续使用。需要全部清除时使用官方卸载脚本的 --purge;先加 --dry-run 查看将删除的路径,再自行备份需要的会话。

资料与核验范围
本文依据项目公开资料整理。版本、安装命令和功能边界可能随上游更新,请以所列来源和项目当前版本为准。 资料核对时间: 2026-09-23 13:55.

参考材料:README、GitHub API、依赖文件