README.zh-CN.md

March 31, 2026 · View on GitHub

Anycoding

面向本地 agent 会话的 CLI-first 桌面与移动端 UI，支持 Claude Code、Cursor CLI、Codex、Gemini-CLI 和 OpenCode。
这个 fork 更偏向 CLI-first 工作区，支持多 provider CLI、按项目持久化 CLI、项目级 CLI 历史，以及文件、Git、MCP 与移动端访问。

GitHub · Bug 报告 · npm · 贡献指南

English · Русский · Deutsch · 한국어 · 中文 · 日本語

功能

CLI-first 工作区 - 围绕持久化 CLI 会话，而不是 chat-first 流程
多 provider CLI - 在同一套 UI 中启动 Claude Code、Codex、Cursor 风格会话、Gemini CLI、OpenCode 或系统 CLI
按项目保留 CLI 历史 - 切换项目后可恢复对应 CLI 工作区
Provider 感知的新建 CLI - 在头部直接按 provider 创建 CLI，并显示对应图标
响应式设计 - 支持桌面、平板与移动端
文件浏览器 - 交互式文件树，支持语法高亮与实时编辑
Git 浏览器 - 查看、暂存并提交改动，也可切换分支
会话管理 - 在侧边栏浏览项目与 session 历史
插件系统 - 通过自定义标签页、后端服务与集成扩展 UI。开始构建 →
TaskMaster AI 集成 (可选) - AI 任务规划、PRD 分析与工作流自动化
模型兼容性 - 支持 Claude、GPT、Gemini 模型家族（完整列表见 shared/modelConstants.js）

快速开始

自托管

使用 npx 立即运行这个 fork（需要 Node.js v22+）：

npx @luzedong/anycoding

或全局安装：

npm install -g @luzedong/anycoding
anycoding

打开 http://localhost:3001，系统会自动发现本地已有项目与会话。

从源码运行

git clone https://github.com/luzedong/anycoding.git
cd anycoding
npm install
npm run dev

打包为 macOS 应用

仓库已内置 Electron 桌面壳，可直接打包为原生 macOS 应用：

# 本地构建并启动桌面版
npm run desktop:start

# 仅生成本地验证用 .app（速度更快）
npm run desktop:pack:dir

# 生成可分发安装包（dmg + zip）
npm run desktop:pack

产物默认输出到 release/（例如 release/mac-arm64/Anycoding.app）。

包与链接

npm: @luzedong/anycoding
GitHub: luzedong/anycoding

哪个选项更适合你？

Anycoding 与 claudecodeui 都是面向本地 agent 会话的开源 UI，但在默认交互方式、文档中列出的 provider、打包与生态链接上有差异。

	Anycoding	claudecodeui
默认交互方式	CLI-first 工作区（provider 感知的 CLI 标签与按项目 CLI 工作区/历史）	聊天界面 + 内置 Shell 终端（以上游文档为准）
README 列出的 Providers	Claude Code、Cursor CLI、Codex、Gemini CLI、OpenCode	Claude Code、Cursor CLI、Codex、Gemini CLI
安装方式	`npx @luzedong/anycoding`	`npx @siteboon/claude-code-ui`
全局命令	`anycoding`	`cloudcli`
仓库 / Issues	`luzedong/anycoding`	`siteboon/claudecodeui`
包名	`@luzedong/anycoding`	`@siteboon/claude-code-ui`
CloudCLI Cloud 引导链接	非本仓库主轴	原仓库内置官方引导
核心本地能力	CLI 会话 + Files + Git + MCP + 插件	CLI 会话 + Files + Git + MCP + 插件
机器需保持开机（自托管）	是	是

🔒 重要提示: 所有 Claude Code 工具默认禁用，可防止潜在的有害操作自动运行。

启用工具

打开工具设置 - 点击侧边栏齿轮图标
选择性启用 - 仅启用所需工具
应用设置 - 偏好设置保存在本地

工具设置弹窗 工具设置界面 - 只启用你需要的内容

推荐做法: 先启用基础工具，再根据需要添加其他工具。随时可以调整。

插件

Anycoding 配备插件系统，允许你添加带自定义前端 UI 和可选 Node.js 后端的选项卡。在 Settings > Plugins 中直接从 Git 仓库安装插件，或自行开发。

可用插件

插件	描述
Project Stats	展示当前项目的文件数、代码行数、文件类型分布、最大文件以及最近修改的文件

自行构建

Plugin Starter Template → — Fork 该仓库以构建自己的插件。示例包括前端渲染、实时上下文更新和 RPC 通信。

插件文档 → — 提供插件 API、清单格式、安全模型等完整指南。

常见问题

与 Claude Code Remote Control 有何不同？

Claude Code Remote Control 让你发送消息到本地终端中已经运行的会话。该方式要求你的机器保持开机，终端保持开启，断开网络后约 10 分钟会话会超时。

Anycoding 与 Anycoding Cloud 是对 Claude Code 的扩展，而非旁观 — MCP 服务器、权限、设置、会话与 Claude Code 完全一致。

覆盖全部会话 — Anycoding 会自动扫描 ~/.claude 文件夹中的每个会话。Remote Control 只暴露当前活动的会话。
设置统一 — 在 Anycoding 中修改的 MCP、工具权限等设置会立即写入 Claude Code。
支持更多 Agents — Claude Code、Cursor CLI、Codex、Gemini CLI。
完整 UI — 除了聊天界面，还包括文件浏览器、Git 集成、MCP 管理和 CLI 终端。
Anycoding Cloud 保持运行于云端 — 关闭本地设备也不会中断代理运行，无需监控终端。

需要额外购买 AI 订阅吗？

需要。Anycoding 只提供环境。你仍需自行获取 Claude、Cursor、Codex 或 Gemini 订阅。Anycoding Cloud 从 $7/月起提供托管环境。

能在手机上使用 Anycoding 吗？

可以。自托管时，在你的设备上运行服务器，然后在网络中的任意浏览器打开 [yourip]:port。Anycoding Cloud 可从任意设备访问，内置原生应用也在开发中。

UI 中的更改会影响本地 Claude Code 配置吗？

会的。自托管模式下，Anycoding 读取并写入 Claude Code 使用的 ~/.claude 配置。通过 UI 添加的 MCP 服务器会立即在 Claude Code 中可见。

社区与支持

文档 — 安装、配置、功能与故障排除指南
GitHub Issues — 报告 Bug 与建议功能
贡献指南 — 如何参与项目贡献

许可证

GNU 通用公共许可证 v3.0 - 详见 LICENSE 文件。

该项目为开源软件，在 GPL v3 许可证下可自由使用、修改与分发。

致谢

原始项目

本项目最初基于 siteboon/claudecodeui。感谢上游维护者和贡献者。

使用技术

Claude Code - Anthropic 官方 CLI
Cursor CLI - Cursor 官方 CLI
Codex - OpenAI Codex
Gemini-CLI - Google Gemini CLI
React - 用户界面库
Vite - 快速构建工具与开发服务器
Tailwind CSS - 实用先行 CSS 框架
CodeMirror - 高级代码编辑器
TaskMaster AI (可选) - AI 驱动的项目管理与任务规划

为 Claude Code、Cursor、Codex、Gemini CLI 和 OpenCode 社区精心打造。