CLAUDE CODEX

Claude Codex · 本地 AI 工作流与对话客户端

631 COMMITS

6 PACKAGES

6 VALIDATION REPORTS

LOCAL FIRST

OVERVIEW ── 这是什么01

把 Claude Agent SDK 装进桌面端：对话与工作流跑在本地，账号、配额和子账户桥接放在云端。pnpm monorepo 装下 Electron 桌面端、Express 云端后端、react-admin 运营后台和共享类型层——每个阶段先写验证报告再开工，六份报告都在仓库里。

ARCHITECTURE ── 架构分层02

01桌面端

Electron + React · Claude Agent SDK 直连 · better-sqlite3 本地库 · Drizzle ORM · electron-log

02云端

Express + Drizzle + PostgreSQL · argon2 口令散列 · JWT · express-rate-limit · pino 结构化日志

03后台

React + react-admin 风格运营后台 · TanStack Query · Zustand

04共享

pnpm workspaces · shared 类型包 · Zod 校验 · Biome 统一 lint/format

05记忆

Mem0 本地模式 + Vectra 向量检索（Phase 0 已验证）

FEATURES ── 功能与取舍03

对话与数据落在本机 SQLite，云端只管账号与配额。

云端签发子账户，桌面端凭它访问上游，密钥不下发到客户端。

Phase 0 六份验证报告：SDK 透传、Mem0 本地模式、子账户 API 全部先跑通再进入实现。

Phase 0 脚手架 → 1.A 云端基础设施 → 1.B 桌面业务，每阶段有独立实施计划。

MILESTONES ── 里程碑04

2026-05-28

立项：设计文档 + Phase 0 验证与脚手架计划

2026-06

Phase 1.A 上线：账号系统 + sub2api 桥接 + Admin 后台

2026-06-23

桌面端进入 Phase 1.B 业务实现

RELATED LOGS ── 相关复盘05