从零打造 Cursor 平替：基于 VS Code 二开的 AI 编程编辑器 CodexaX

CodexaX

AI 原生代码编辑器 · 基于 VS Code 二次开发

CodexaX 是一款基于 VS Code（code-oss）深度二开的 AI 原生代码编辑器 ，内置 AI 对话、智能体（Agent）、行内补全、代码库语义检索，并配套自研的多模型路由后端、账号计费体系与管理后台。支持私有化部署。

🎬 演示视频

✨ 功能特性

🗨️ AI 对话：编辑器内流式问答、上下文感知、Mermaid 图表渲染、多会话管理。
🤖 智能体 Agent：自主多步执行、工具调用、代码自动编辑与逐项回滚、后台任务。
⌨️ 行内补全：基于光标前后文（FIM）的 Tab 补全，独立限流、低延迟。
🔍 代码库检索（RAG）：工作区向量索引 + 语义搜索，让 AI 理解整个项目。
🔀 多模型路由：Claude / DeepSeek / GPT / Gemini / xAI / Ollama 一键切换，统一计费。
👤 账号与计费：手机验证码登录、JWT、SSO、API Key、用量统计、月度上限、Stripe 订阅。
🛠️ 管理后台：模型 / 供应商 / 用户 / 用量可视化运营。
🚀 运维：自动更新、多平台发布、私有化部署。

完整功能说明见：CodexaX-产品功能说明.md

📸 产品截图

📁 仓库结构

复制代码

.
├── vscode-src/      # 编辑器：VS Code（code-oss）二开，含 CodexaX 品牌与 AI 扩展
│   └── extensions/  #   codexax-chat（对话/Agent）、codexax-auth（登录/多模型）、theme-codexax ...
├── codexax/         # 后端 monorepo（pnpm workspace）
│   ├── apps/api/    #   API 服务（Node + Hono + SQLite，端口 8787）
│   ├── apps/web/    #   官网（Next.js，端口 3000）
│   ├── apps/admin/  #   管理后台（Next.js，端口 3001）
│   ├── editor/      #   编辑器扩展源码
│   └── packages/    #   共享代码
├── 参考源码/         # 参考项目（仅研究用）
├── 截图/             # 产品截图
└── CodexaX-产品功能说明.md

🚀 快速开始（本地开发）

环境要求：Node.js ≥ 20、pnpm 9、（编辑器）Node 22。

1）启动后端（API + 官网 + 后台）

bash 复制代码

cd codexax
pnpm install
pnpm dev
# API   → http://localhost:8787
# Web   → http://localhost:3000
# Admin → http://localhost:3001

2）启动编辑器（CodexaX 客户端）

bash 复制代码

cd vscode-src
npm install            # 首次安装依赖（含原生模块编译）
npm run watch          # 持续编译（常驻，勿关）
./scripts/code.sh      # 启动编辑器

开发模式下编辑器默认连接本地 http://localhost:8787；如需连接生产，在设置中配置 codexax.apiBase。

⚙️ 配置

后端环境变量见 codexax/.env.development / .env.production（端口、JWT_SECRET、DB_PATH、短信、Stripe 等）。
模型与供应商 通过管理后台可视化配置（增删模型、密钥、定价倍率、上下架），无需改代码。
数据默认存于 SQLite，可平滑升级到 Postgres / pgvector。

📦 部署

后端（API + Web + Admin）与编辑器客户端均可独立部署：后端可用 PM2 / Docker 托管；编辑器内置自动更新服务（/update、/download），支持 macOS / Windows / Linux 出包发布。模型密钥与数据完全自控。

🔗 仓库地址

Gitee：https://gitee.com/bright-boy/codexa-x
GitHub：https://github.com/694475668/CodexaX