Codeg：统一管理多AI编码助手，打造企业级远程开发工作空间

1. 项目概述Codeg一个企业级的多智能体编码工作空间如果你和我一样每天的工作流里同时开着Claude Code、Codex CLI、OpenCode等好几个AI编码助手在终端、IDE和浏览器之间来回切换只为查看不同智能体的对话记录、管理它们的会话状态那你一定理解这种“甜蜜的负担”。每个工具都有自己独立的会话存储路径、不同的配置文件和操作逻辑信息被割裂在不同的孤岛里。Codeg的出现就是为了终结这种混乱。Codeg是一个开源的、企业级的多智能体编码工作空间。它的核心目标非常明确统一。它把市面上主流的本地AI编码智能体Claude Code, Codex CLI, OpenCode, Gemini CLI, OpenClaw, Cline等全部聚合到一个统一的界面里。你可以把它看作一个为AI编码智能体量身打造的“仪表盘”或“控制中心”。更关键的是它不仅仅是一个桌面应用还提供了独立服务器和Docker容器两种部署形态这意味着你可以把它部署在远程服务器上然后通过任何浏览器进行访问实现真正的远程AI辅助开发。想象一下这个场景你在家里的电脑上启动了一个需要长时间运行的代码生成任务然后出门用手机通过Telegram接收任务进度通知并在咖啡馆用笔记本电脑的浏览器登录同一个Codeg实例无缝地继续这个会话。或者团队可以将Codeg部署在内网服务器上所有成员共享同一套配置好的智能体和项目环境协作效率会得到极大提升。这就是Codeg试图构建的未来工作流。2. 核心设计思路与架构拆解2.1 为什么是“多智能体”工作空间当前AI编码工具生态的一个显著特点是“百花齐放各自为政”。每个工具都有其独特的优势和擅长的场景Claude Code可能在理解复杂业务逻辑上更出色Codex CLI在快速生成样板代码时效率极高而OpenClaw可能在处理特定框架如某个内部库时表现更好。开发者被迫在不同的工具间做选择或者忍受频繁切换的成本。Codeg的设计哲学是“兼收并蓄而非取代”。它不试图创造另一个新的AI智能体而是扮演一个聚合层和协调者的角色。通过解析各个智能体本地存储的会话数据通常是JSON或SQLite格式Codeg将它们的历史对话、代码变更、工具调用记录等以一种结构化的、统一的视图呈现给用户。这解决了信息分散的核心痛点。注意Codeg本身不运行AI模型也不直接调用大语言模型的API。它依赖于你已经安装并配置好的本地AI编码智能体客户端。Codeg负责“读取”和“展示”这些智能体产生的数据并在需要时通过标准化的方式如命令行调用与它们交互。这是一种非常务实的“集成优先”思路。2.2 技术栈选型Tauri Next.js Rust的黄金组合Codeg的技术栈选择体现了其对性能、跨平台和现代Web体验的追求前端 (Next.js 16 React 19)使用Next.js并配置为output: export进行静态导出。这意味着前端部分是一套纯静态的HTML、CSS和JavaScript文件可以轻松地嵌入到任何环境中桌面应用或独立服务器无需Node.js运行时。React 19带来了并发特性等现代能力为复杂的UI交互提供了基础。桌面端框架 (Tauri 2)Tauri是一个用Rust构建的框架用于创建小巧、快速、安全的桌面应用程序。它用系统自带的Web视图在Linux/macOS上是WebKitGTK在Windows上是WebView2来渲染前端替代了Electron中庞大的Chromium内核使得最终的应用体积大幅减小通常只有几MB到几十MB启动速度和内存占用也更有优势。Tauri的核心逻辑窗口管理、系统交互等由Rust编写通过安全的IPC进程间通信与前端JavaScript交互。后端核心 (Rust Axum)这是Codeg的“大脑”。所有核心业务逻辑——智能体会话解析、聊天通道管理、Git操作、文件树遍历、MCPModel Context Protocol技能管理——都用Rust实现。Rust的内存安全和零成本抽象特性使得处理大量本地文件I/O和并发任务时既高效又稳定。对于独立服务器模式Codeg使用了Axum这个异步Web框架来处理HTTP请求和WebSocket连接。数据层 (SeaORM SQLite)为了持久化存储用户配置、项目元数据、聊天通道状态等信息Codeg采用了SeaORM这个Rust的ORM框架底层是轻量级的SQLite数据库。这种选择保证了应用的“本地优先”特性所有敏感数据如聊天机器人令牌都默认存储在本地并通过操作系统的密钥环Keyring进行加密保护。这种架构带来的一个关键优势是代码复用。无论是桌面模式还是服务器模式它们都共享同一套Rust核心业务逻辑。桌面模式下前端通过Tauri的invoke命令调用Rust函数服务器模式下前端通过HTTP API和WebSocket与后端的Rust服务通信。这种设计极大地减少了维护成本。2.3 核心功能模块解析Codeg的功能可以归纳为以下几个核心模块它们共同构成了一个完整的工作流闭环智能体统一管理自动扫描并索引你本地已安装的各个AI编码智能体的会话目录。你可以在一个界面里浏览所有智能体在不同项目中的对话历史无需再记忆~/.claude/projects或%APPDATA%\.codex\sessions这些分散的路径。并行开发工作流 (git worktree)这是对Git高级功能的一个绝佳应用。Codeg内置了git worktree工作流管理。简单来说git worktree允许你在同一个Git仓库中同时签出多个不同的分支到不同的工作目录。Codeg利用这个特性让你可以为每个新的功能或实验轻松创建一个独立、隔离的工作环境而不会污染主分支的工作区。所有工作树的状态都在Codeg的UI中清晰展示和管理。可视化项目脚手架 (Project Boot)告别手动敲命令初始化项目的时代。Codeg提供了一个图形化界面来创建新项目特别是针对shadcn/ui这样的组件库。你可以在左侧选择主题、颜色、字体、圆角等样式右侧实时预览效果。确认后一键点击即可调用相应的CLI命令如shadcn init创建项目并自动在Codeg中打开。这大大降低了UI项目初始化的门槛和出错率。聊天通道集成 (Chat Channels)这是Codeg最具创新性的功能之一。它允许你将Telegram、飞书(Lark)、企业微信(iLink)等聊天应用连接到你的编码智能体。你可以直接在聊天软件里给智能体分派任务/task 为登录页面添加一个忘记密码的功能接收实时的代码生成进度和工具调用请求并通过快捷命令/approve进行授权。这使得远程协作和移动端轻度参与开发成为可能。MCP/Skills管理MCPModel Context Protocol是一种让AI模型安全、可控地使用外部工具和数据的协议。Codeg内置了MCP服务器管理功能可以扫描本地的MCP配置也可以从 registry 搜索和安装新的MCP技能。你可以在这里统一管理所有智能体可用的工具集。完整的工程闭环Codeg不仅仅是一个“查看器”。它集成了文件树浏览器、代码差异对比Diff、Git状态管理、提交界面以及一个内置终端。这意味着你可以在同一个应用内完成“接收AI建议 - 查看代码变更 - 运行测试 - 提交代码”的整个流程无需跳出。3. 深度实操从零部署与配置Codeg3.1 环境准备与桌面版安装对于个人开发者从桌面版开始体验是最直接的方式。以下是详细的步骤和避坑指南。系统依赖安装Codeg的桌面版本依赖于Tauri而Tauri需要一些系统级的库来构建和运行。以Ubuntu/Debian为例你需要安装以下依赖sudo apt-get update sudo apt-get install -y \ libwebkit2gtk-4.1-dev \ # Web视图渲染引擎 libayatana-appindicator3-dev \ # 系统托盘支持 librsvg2-dev \ # SVG图标渲染 patchelf # 二进制文件修补工具用于Linux发布对于macOS用户通常只需要安装Xcode Command Line Tools (xcode-select --install)。Windows用户则需要安装Microsoft Visual Studio C构建工具和WebView2运行时通常系统已自带或会自动安装。获取与构建源码Codeg推荐使用pnpm作为包管理器并且需要Node.js 22和Rust稳定版。# 1. 克隆仓库 git clone https://github.com/xintaofei/codeg.git cd codeg # 2. 安装前端依赖并构建静态资源 pnpm install pnpm build # 这一步会执行 next build 并输出到 out/ 目录 # 3. 开发模式运行前端热重载 Tauri窗口 pnpm tauri dev # 4. 构建生产版本的应用 pnpm tauri build执行pnpm tauri build后生成的应用程序会位于src-tauri/target/release/目录下Linux是.AppImage或.debmacOS是.appWindows是.msi。你可以直接安装或运行它。实操心得构建失败排查如果在pnpm install或pnpm build阶段失败最常见的原因是Node.js版本过低或pnpm版本不兼容。请务必使用node -v和pnpm -v确认版本。另一个常见坑点是Rust工具链确保通过rustup安装了stable版本并已更新 (rustup update)。如果Tauri构建报错关于GTK或WebKit请回头仔细检查系统依赖是否全部安装成功。3.2 独立服务器模式部署详解桌面版适合本地使用而服务器模式才是Codeg发挥其“企业级”和“远程协作”威力的地方。你有多种方式部署codeg-server。方式一使用一键安装脚本最快对于Linux/macOS官方提供了安装脚本# 安装最新版到默认路径通常是 /usr/local/bin curl -fsSL https://raw.githubusercontent.com/xintaofei/codeg/main/install.sh | bash # 安装特定版本到自定义目录 curl -fsSL https://raw.githubusercontent.com/xintaofei/codeg/main/install.sh | bash -s -- --version v0.5.2 --dir ~/.local/bin安装后直接运行codeg-server即可。服务启动后会随机生成一个访问令牌Token并打印在控制台你需要用这个令牌在浏览器中登录。方式二使用Docker部署最推荐用于生产Docker部署提供了最好的隔离性和可重复性。Codeg提供了官方镜像ghcr.io/xintaofei/codeg:latest。基础运行docker run -d -p 3080:3080 -v codeg-data:/data ghcr.io/xintaofei/codeg:latest这行命令做了几件事在后台运行容器将容器的3080端口映射到宿主机的3080端口并创建一个名为codeg-data的Docker卷来持久化SQLite数据库和配置。生产环境推荐配置一个更完整、更安全的Docker运行示例docker run -d \ --name codeg-server \ --restart unless-stopped \ # 容器退出时自动重启 -p 3080:3080 \ -v /path/to/your/codeg-data:/data \ # 使用宿主机路径便于备份 -v /path/to/your/projects:/projects \ # 挂载你的项目目录容器内可访问 -e CODEG_TOKENyour_strong_secret_token_here \ # 设置固定令牌而非使用随机值 -e CODEG_HOST0.0.0.0 \ -e CODEG_PORT3080 \ ghcr.io/xintaofei/codeg:latest使用Docker Compose更优雅的管理创建一个docker-compose.yml文件version: 3.8 services: codeg: image: ghcr.io/xintaofei/codeg:latest container_name: codeg restart: unless-stopped ports: - 3080:3080 environment: - CODEG_TOKEN${CODEG_TOKEN:-changeme} # 从.env文件读取默认值为changeme - CODEG_DATA_DIR/data volumes: - ./data:/data # 本地data目录映射到容器/data - /home/user/workspace:/projects # 映射你的代码工作空间 # 如果服务器在中国大陆可以配置镜像加速 # build: # args: # - NPM_REGISTRYhttps://registry.npmmirror.com然后运行docker compose up -d即可。所有配置集中管理一目了然。重要安全提示CODEG_TOKEN环境变量服务器模式默认没有密码而是使用令牌认证。如果启动时不设置CODEG_TOKEN程序会生成一个随机的UUID并打印在日志中。在生产环境务必通过-e CODEG_TOKEN...设置一个强密码避免令牌泄露导致未授权访问。同时考虑使用反向代理如Nginx配置HTTPS并对3080端口进行防火墙限制仅允许可信IP访问。3.3 关键配置解析与环境变量Codeg服务器可以通过环境变量进行灵活配置。理解这些变量对于定制化部署至关重要。环境变量默认值描述与配置建议CODEG_PORT3080服务监听的HTTP端口。如果3080已被占用可以修改为其他端口如8080。CODEG_HOST0.0.0.0服务绑定的网络接口。0.0.0.0表示监听所有网络接口。在Docker内通常保持默认即可。如果出于安全考虑只想本地访问可设置为127.0.0.1。CODEG_TOKEN(随机生成)最重要的安全配置。用于浏览器登录的认证令牌。建议设置为一个长且复杂的字符串。在Docker中通过-e传递在系统服务中可写入.env文件。CODEG_DATA_DIR~/.local/share/codeg存放SQLite数据库文件、缓存和配置的目录。在Docker中应将其映射到持久化卷如/data。CODEG_STATIC_DIR./web或./out前端静态资源HTML, JS, CSS的目录。在预构建的二进制版本或Docker镜像中资源已打包在内通常无需设置。如果你从源码构建服务器需要将其指向out/目录。配置示例系统服务Systemd对于Linux服务器创建Systemd服务可以保证Codeg开机自启和稳定运行。创建文件/etc/systemd/system/codeg.service[Unit] DescriptionCodeg Server Afternetwork.target [Service] Typesimple Usercodeguser # 建议创建一个专用用户 WorkingDirectory/opt/codeg EnvironmentCODEG_TOKENyour_super_strong_token_here EnvironmentCODEG_DATA_DIR/var/lib/codeg/data ExecStart/usr/local/bin/codeg-server Restarton-failure RestartSec5s [Install] WantedBymulti-user.target然后执行sudo systemctl daemon-reload sudo systemctl enable codeg sudo systemctl start codeg sudo systemctl status codeg # 查看状态4. 核心功能实战与技巧4.1 连接并管理你的AI编码智能体Codeg安装好后首次启动需要让它“发现”你本地的智能体。这个过程主要是自动扫描一些默认路径。打开设置在Codeg左侧边栏或右上角找到设置齿轮图标。进入“Agents”标签页这里会列出Codeg支持的所有智能体类型。等待扫描或手动添加路径Codeg会自动尝试从环境变量和默认路径读取会话数据。例如对于Claude Code它会查找$CLAUDE_CONFIG_DIR/projects或~/.claude/projects。如果智能体安装在非标准位置你可以手动指定会话目录的路径。连接成功后你会看到一个统一的会话列表按项目和智能体分类。每个会话的标题、创建时间、使用的模型和大概的令牌消耗如果智能体记录了的话。点击任意会话可以完整地回顾当时的对话历史、生成的代码片段以及智能体调用过的工具如读写文件、执行命令。注意事项智能体数据是只读的吗目前Codeg对大多数智能体的会话数据主要是读取和解析用于展示。这意味着你无法直接在Codeg的界面里与Claude Code进行一场“新的”对话。Codeg的交互性主要体现在其聊天通道和工程闭环功能上。你通过聊天通道发送任务智能体在其自己的环境中执行Codeg再摄取结果进行展示。这种设计保持了与原生智能体的兼容性但未来可能会增加更直接的交互方式。4.2 掌握并行开发Git Worktree工作流这是Codeg提升开发效率的杀手锏之一。假设你正在main分支开发一个核心功能突然需要紧急修复一个bug或尝试一个高风险的重构。传统做法git stash暂存当前修改切换分支修复后再切回来git stash pop。或者克隆一个新的仓库副本。前者有冲突风险后者浪费磁盘空间且同步麻烦。Codeg的Git Worktree流程在Codeg的文件树视图中右键点击你的Git仓库。选择“Create Worktree...”或类似选项。输入新分支名如feat/experimental-refactor和目标目录路径Codeg通常会建议一个相邻目录。点击创建。瞬间一个全新的、独立的工作目录就绪了它指向你仓库的新分支但与你的main分支工作区完全隔离。你现在可以在Codeg中同时打开两个项目窗口一个是main分支的原工作区一个是feat/experimental-refactor分支的新工作树。它们之间的文件修改互不干扰。在新工作树中你可以让AI智能体大胆地生成代码、运行测试。完成后提交、推送然后通过Codeg的界面轻松地合并回主分支或者直接删除这个工作树。实操技巧为每个功能或实验创建独立工作树保持主工作区清洁。Codeg的UI会清晰展示所有活跃的工作树及其对应的分支和路径管理起来非常直观。删除工作树时Codeg会自动执行git worktree remove并清理目录比手动操作更安全。4.3 配置聊天通道将开发搬进Telegram/飞书这是Codeg最“炫酷”的功能配置过程需要一些步骤但一旦完成体验将完全不同。以配置Telegram Bot为例创建Telegram Bot在Telegram中搜索BotFather发送/newbot按提示操作最终你会获得一个Bot Token一串类似1234567890:ABCdefGhIJKlmNoPQRsTUVwxyZ的字符串。妥善保存此Token。在Codeg中添加通道进入Settings - Chat Channels。点击“Add Channel”选择“Telegram”。在“Bot Token”字段粘贴你从BotFather那里获得的Token。Codeg会利用操作系统的密钥环Keyring安全地存储这个Token而不是写在配置文件里。你可以配置事件过滤器例如只接收错误通知或任务完成通知以及设置每日报告的时间。在Telegram中启动Bot在你刚创建的Bot的聊天窗口里发送/start命令。Bot会回复一个链接或指令让你将其与Codeg实例绑定。根据Codeg界面或日志的提示你可能需要在Bot聊天中发送一个特定的验证码或点击一个链接来完成绑定。开始远程编码绑定成功后你就可以在Telegram里向你的编码智能体发送命令了。/folder选择要操作的项目。/agent选择使用哪个智能体如Claude Code。/task 为项目添加一个用户个人资料页面包含头像上传和基本信息编辑功能。发送后智能体开始工作。你会在Telegram中实时收到进度更新、工具调用请求如“是否允许我修改src/app/profile/page.tsx文件”。你可以回复/approve来批准或者/approve always来总是自动批准该智能体的此类请求。任务完成后你会收到一个包含摘要和变更列表的总结消息。避坑指南网络与权限网络问题如果你的Codeg服务器部署在内网Telegram Bot需要能通过公网访问到你的服务器。这通常需要内网穿透如ngrok、frp或配置公网IP和端口转发。请确保CODEG_HOST设置为0.0.0.0且端口已开放。权限作用域通过聊天通道发起的任务其文件操作权限通常被限制在指定的项目目录内这是重要的安全设计。确保你通过/folder命令选择了正确的项目。企业应用配置飞书/企业微信配置Lark或iLink通道相对更复杂需要在对应的开发者平台创建应用、配置权限、获取App ID和Secret等。请务必仔细阅读官方文档中关于redirect_uri和scopes的配置要求。4.4 使用Project Boot快速初始化项目对于前端项目特别是基于shadcn/ui的项目这个功能能节省大量时间。在Codeg主界面找到“Project Boot”模块或通过菜单进入。左侧是配置面板从下拉框中选择框架Next.js, Vite, Astro等、包管理器pnpm, npm, yarn, bun、样式默认、CSS变量等、颜色主题、圆角大小、字体等。右侧是一个实时刷新的预览iframe直观地展示你当前配置下的UI组件大概是什么样子。配置满意后点击“Create Project”选择本地存放路径。Codeg会在后台调用shadcn init以及相应的框架CLI命令自动安装依赖并生成一个配置好的新项目。项目创建成功后Codeg会自动在左侧文件树中打开它你可以立即开始编码或让AI智能体介入。技巧这个功能依赖于本地已安装的CLI工具如shadcn、create-next-app。确保这些工具已全局安装或在Codeg可访问的环境路径中。目前主要支持shadcn/ui但模块化的设计意味着未来可以轻松添加对V0、Bootstrap等其他脚手架的支持。5. 常见问题排查与进阶技巧5.1 智能体会话无法识别或为空症状Codeg的“Agents”页面列表为空或者检测到了智能体但没有会话历史。排查步骤确认智能体已安装并产生过会话首先确保你确实在本地使用过Claude Code等工具并且它们已经在默认路径下创建了会话数据文件。可以去~/.claude/projects/Linux/macOS或%USERPROFILE%\.claude\projects\Windows目录下查看是否有JSON文件。检查Codeg中的路径配置在Settings - Agents中查看对应智能体的“Session Path”是否正确。Codeg会先尝试读取环境变量如$CLAUDE_CONFIG_DIR如果环境变量未设置则回退到默认路径。你可以尝试手动点击“Browse”或直接输入绝对路径。检查文件权限确保运行Codeg的用户有权限读取智能体的会话目录和文件。在Linux/macOS上可能需要检查目录的读权限ls -la ~/.claude。查看日志Codeg桌面版可以在“Help”菜单中打开开发者工具Developer Tools查看控制台日志。服务器版可以查看其输出日志。日志中通常会有解析文件时的错误信息。会话格式变更如果智能体更新了其会话数据的存储格式Codeg的解析器可能需要更新。此时可以关注Codeg的GitHub仓库Issue页面看是否有类似报告。5.2 聊天通道无法连接或收不到消息症状配置了Telegram Bot Token但Bot没有响应或者Codeg界面显示连接失败。排查步骤问题可能原因检查方法解决方案Token错误核对从BotFather复制的Token是否完全一致无多余空格。重新创建Bot或复制Token。Bot未启动在Telegram中给Bot发送/start。必须发送/start来激活Bot。网络不通检查Codeg服务器所在机器的3080端口或自定义端口是否在防火墙中开放并能被外网访问。配置防火墙规则或使用内网穿透工具。对于Docker确保端口映射正确 (-p 3080:3080)。Webhook设置失败Codeg连接Telegram使用的是长轮询(Long Polling)而非Webhook但初始握手仍需网络可达。查看Codeg日志。确保服务器IP/域名正确且Telegram的API可访问在某些网络环境下可能需要配置。企业应用配置错误飞书/企业微信检查开发者平台中应用的回调地址(redirect_uri)、权限(scopes)是否配置正确。仔细对照Codeg文档和对应开放平台的文档确保每一步配置都匹配。回调地址通常是https://your-codeg-server:3080/api/channels/lark/callback这种格式。5.3 Docker容器内无法访问宿主机Git仓库或执行命令症状在Docker中运行的Codeg其终端无法运行git命令或者文件树看不到宿主机上挂载的项目。解决方案确保挂载了项目目录在docker run命令中使用-v参数将宿主机目录挂载到容器内如-v /home/user/code:/projects。在Codeg中设置正确的项目根路径启动后在Codeg的Web界面设置中将“Project Directories”指向容器内的挂载点如/projects。确保镜像包含必要工具Codeg的官方Docker镜像已经包含了git和ssh客户端。如果你的操作需要其他工具如node,python,make你需要构建自定义镜像或者在启动容器时安装它们。# 自定义Dockerfile示例 FROM ghcr.io/xintaofei/codeg:latest USER root RUN apt-get update apt-get install -y python3 curl # 安装额外工具 USER codegSSH密钥问题如果Codeg需要克隆私有Git仓库需要将SSH私钥注入容器。注意安全风险。一种方式是将密钥作为文件挂载docker run -d ... -v ~/.ssh/id_rsa:/home/codeg/.ssh/id_rsa:ro ...更安全的方式是使用SSH代理转发ssh-agent但这在Docker中配置较为复杂。5.4 性能优化与数据管理数据库位置默认数据目录~/.local/share/codeg可能位于系统盘。如果会话历史非常多可以考虑将CODEG_DATA_DIR环境变量设置到更大容量的磁盘分区以提升IO性能并节省系统盘空间。会话数据清理Codeg会索引所有智能体的原始会话文件。这些文件本身不会被Codeg删除。定期清理不再需要的本地智能体会话文件如删除~/.claude/projects/下的旧项目文件夹可以减轻Codeg索引的压力并释放磁盘空间。服务器资源对于团队使用的服务器版如果用户量较大或会话数据极多需要关注服务器的内存和CPU使用情况。Rust后端本身效率很高但WebSocket连接和前端资源服务会占用一定资源。根据实际情况调整服务器配置。Codeg作为一个将前沿AI编码工具与经典软件开发流程深度融合的平台其价值在于它提供了一种“集中化、可远程、可协作”的新范式。它没有重新发明轮子而是用优雅的方式把散落的轮子组装成了一辆更高效的车。无论是个人开发者用来管理混乱的本地AI工具还是小团队用来搭建一个共享的AI辅助开发环境Codeg都提供了一个坚实且充满潜力的起点。在实际使用中从简单的会话管理入手逐步尝试其Git工作流和聊天通道功能你会逐渐发现它如何潜移默化地重塑你的开发习惯。