一个极简、可扩展的 AI Agent 框架,包含统一的多厂商 LLM API、Agent 运行时、终端 UI 和编程 Agent 命令行工具。
- Star
- 7,989
- Fork
- 2,455
- 未关闭 Issue
- 11
- 最近提交
- 16小时前
这是什么?
ZCode 是智谱 Z.ai 推出的 AI 编程工作台,分为桌面应用、浏览器界面和命令行三种形式。命令行版通过统一的 `zcode` 命令启动:无参数进入终端界面(TUI),加 `--web` 启动浏览器界面,其他参数交给 Agent CLI 处理,全部在本机运行。
仓库采用 pnpm monorepo 结构,包含 Electron 桌面客户端、HTTP / WebSocket 服务、共享 React 组件库、Agent CLI 与运行时,以及 Provider 集成代码。Web 模式默认监听 127.0.0.1,也可通过 `--host 0.0.0.0` 开放局域网访问,此时自动生成访问令牌。
开发者可用 `pnpm bootstrap` 初始化依赖,用 `pnpm dev:desktop` 启动桌面版,或用 `pnpm dev:web` 同时启动 Web 前端和后端。构建脚本可生成桌面安装包和带安装脚本的命令行发行包。
核心功能
- 01终端界面、浏览器界面和桌面应用共用同一套 Agent 后端。
- 02Web 模式默认监听本机,局域网访问时可使用访问令牌。
- 03monorepo 结构将桌面端、Web 端、服务端、共享 UI 和 CLI 分包管理。
- 04构建脚本可为 macOS、Windows 和 Linux 生成桌面安装包。
- 05命令行版以 tar.gz 运行包发布,附带 SHA256 校验和安装脚本。
适用场景
- 在终端中直接使用 AI 编程 Agent 处理本地项目。
- 通过浏览器访问本机项目目录进行 AI 辅助编程。
- 基于开源代码扩展 Agent 功能或开发 UI 插件。
快速上手
- 1
准备 Git、Node.js 24.14.0 和 pnpm 10.33.2(版本见 mise.toml)
- 2
在仓库根目录初始化依赖和本地资源
pnpm bootstrap - 3
以开发模式启动桌面应用
pnpm dev:desktop
使用前须知
- 安装前需准备 Node.js 24.14.0 和 pnpm 10.33.2。
- 本地构建的桌面应用未签名,macOS 首次打开可能被拦截,需要手动移除隔离属性。
- 打包命令行发行版需要自行配置并托管下载根地址。
标签
常见问题
- ZCode 是什么?
- 智谱 Z.ai 推出的 AI 编程工作台,提供桌面应用、浏览器界面和终端 Agent。 ZCode 是智谱 Z.ai 推出的 AI 编程工作台,分为桌面应用、浏览器界面和命令行三种形式。命令行版通过统一的 `zcode` 命令启动:无参数进入终端界面(TUI),加 `--web` 启动浏览器界面,其他参数交给 Agent CLI 处理,全部在本机运行。
- ZCode 可以免费使用吗?用的什么许可证?
- ZCode 以 Apache-2.0 许可证开源。用于商业产品前,请先确认许可证条款。
- ZCode 还在维护吗?
- 活跃维护中。ZCode 最近一次提交是在 2026年10月19日。
- ZCode 适合用来做什么?
- 在终端中直接使用 AI 编程 Agent 处理本地项目。 通过浏览器访问本机项目目录进行 AI 辅助编程。 基于开源代码扩展 Agent 功能或开发 UI 插件。
- ZCode 怎么安装和运行?
- 准备 Git、Node.js 24.14.0 和 pnpm 10.33.2(版本见 mise.toml) 在仓库根目录初始化依赖和本地资源: pnpm bootstrap 以开发模式启动桌面应用: pnpm dev:desktop
- 在哪里获取 ZCode?
- 源代码和安装说明在 GitHub 上:https://github.com/zai-org/ZCode
概要由 AI 根据项目 README 生成;GitHub 数据每日更新。
相关项目
Pi 编程智能体的提前编译版本,编译为原生代码,启动更快、CPU 占用更低。
一款开源的 AI 编程代理,可在终端运行,并提供桌面应用与内置的构建、规划两类代理。
Anthropic 推出的智能体编程工具,在终端中运行,可读取代码库,并通过自然语言完成编码任务和 git 工作流。
一款 Rust 编写的命令行与终端工具,检测 CPU、内存和显卡,按硬件适配度推荐可运行的开源大模型。
终端编程智能体,内置 LSP、调试器、浏览器和子智能体,支持 60 多家模型服务商。