langshenclaude
v1.8.0
Published
Claude Desktop - AI assistant with native-like capabilities, runs as a web app via npx
Maintainers
Readme
Claude Web App
把 Claude Code 的开源引擎套上 claude.ai 的前端——一个能接任意 API 的网页版 Claude。
手头有 Claude 中转站 API?想像 claude.ai 网页版那样跟 Claude 聊天,不想折腾纯净外卡 / 外号 / 住宅 IP?这个项目就是为你准备的。
为什么做这个
Claude Code 本身强得离谱,但只能在命令行里当"打工人"用——它的系统提示词是为编程任务写的,不适合当成日常对话助手。
claude.ai 网页版体验顶级,但国内用户几乎用不了:注册要纯净国外信用卡、纯净国外手机号、住宅 IP,缺一个就封号。
所以大部分国内程序员的状况是:手里有 Claude 中转站 API → 只能在 Claude Code CLI 里编程用 → 想聊天只能退回 Gemini / GPT → 体验差 Claude 一截。
这个项目把 Claude Code 的开源引擎套上了 claude.ai 几乎一模一样的前端。结果就是:
- 拿你手里的中转站 API,像 claude.ai 一样跟 Claude 聊天
- 同时拥有 Claude Code 原生的全部 agent 能力(读写文件、跑命令、上下文管理、网页搜索、Skills、Projects 等)
- 不要外卡、不要外号、不要住宅 IP、不怕封号
亮点
- 🎨 界面 1:1 还原 claude.ai——深色模式、流式输出、thinking 块折叠、工具卡片、Artifacts 面板、Projects 知识库,基本体验跟官方完全对齐
- 🔌 任意模型接入——内置 Anthropic ↔ OpenAI 格式双向代理,能接 Claude 中转站、Qwen、DeepSeek、GLM、GPT、Gemini,只要对方兼容 OpenAI 或 Anthropic 格式
- 🛠️ 完整 agent 能力——读写文件、执行命令、网页搜索、多轮工具调用、上下文压缩,全套 Claude Code 原生工具
- 🎯 两种使用模式
- 自部署模式:填你自己的 API Key 和 Base URL,完全本地使用,零服务器依赖
- Clawparrot 模式:不想折腾就注册 clawparrot.com 账号,按量付费直接用
- 🧠 Claude 原生对话风格——保留了 claude.ai 的说话节奏和深度,不是 Claude Code 的"干练打工人"腔调
- 🌐 纯 Web 架构——浏览器直接访问,无需安装客户端
演示
丢一句 "写一个中国象棋游戏,玩家和 AI 对战,AI 三个难度等级",模型会自己:
- 规划任务 → 拆分成几个文件
- 用 Write 工具从零创建
index.html - 用 Edit 工具实现 AI 评估函数、alpha-beta 剪枝、走子规则、UI 交互
- 全程流式展示每一步操作
跑完就是一个能直接在浏览器打开玩的完整象棋游戏。所有代码由模型自主生成、自主写入、自主验证。
功能特性
对话 (Chat) ✅
- Markdown 完整渲染(代码高亮、KaTeX 数学公式、Mermaid 图表)
- 流式输出 + thinking 块折叠
- 图片附件(缩略图 + lightbox 查看)
- 多种文件格式上传(zip、pdf、docx 等)
- GitHub 仓库一键导入对话
- 消息编辑 / 重新生成 / 上下文回退(基于 Claude Code 原生
--resume-session-at) - 左下角实时显示额度使用情况
- 跨模式切换保护(切换模式时对现有对话的模型自动检测并提示)
工具调用
- Read / Write / Edit / MultiEdit——文件读写与多处编辑
- Bash——执行 shell 命令
- Glob / Grep——代码库搜索
- WebSearch / WebFetch——网页搜索和抓取
- Agent——派生子任务并行处理(Deep Research 的基础)
- Skills——调用自定义指令集
Skills 系统
- 输入框
+菜单选 Skills →/skill-name以蓝色 tag 出现在消息里 - 模型通过 Skill 工具读取指令集内容(UI 里可见)
- 内置 skill-creator 用于创建自定义 Skill
- Skill 存在
~/.claude/skills/目录,引擎自动加载
Projects(项目知识库)
- 上传参考文档(代码、文档、PDF)作为项目知识库
- 跨对话共享知识
- 文件按需通过 Read 工具读取,不会塞爆上下文
- 每个项目可设独立的 instructions 注入到对话
Deep Research 模式
- 针对复杂问题展开深度调研
- 主 agent 规划子问题 → 派生多个 sub-agent 并行搜索 → 汇总成带引用的报告
- 启用方式:输入框左下角切换
Artifacts(可视化产出)
- 模型生成的 HTML / JSX 直接在右侧面板实时预览
- 支持双面板对比、编辑、重新生成
- 在 Artifacts 页面浏览所有产出,带灵感画廊
快速开始
部署
- 启动服务
- Onboarding 页面选择使用模式:
- 自部署:用你自己的 API Key(中转站 / 官方 / 任意兼容 OpenAI 格式的模型)
- Clawparrot:用我们托管的服务,需要先在 clawparrot.com 注册
- 自部署用户:进入 Settings → Models 添加 Provider,填入 Base URL 和 API Key,选择模型
- Clawparrot 用户:登录 clawparrot.com 账号即可使用
两种模式都进主界面后,就可以开始聊天。
从源码构建
git clone https://github.com/pretend1111/claude-desktop-app.git
cd claude-desktop-app
# 装依赖
npm install
# 开发模式(前端 + 后端同时启动)
npm run dev
# 生产构建
npm run build依赖:Node.js 20+、Bun(Windows 上 Claude Code 引擎还需要 Git Bash)
开发模式
npm run dev启动前端 Vite 开发服务器 + 后端 Bridge Server- 改
electron/bridge-server.cjs重启后端即可 - 改
engine/src/源码不用 rebuild,下次 spawn 引擎时自动生效
架构
┌─────────────────────────────────────────────────┐
│ React 前端 (Vite, 浏览器) │
│ ├── 对话界面、Skills / Projects │
│ ├── Artifacts、Settings │
│ └── HTTP 请求 → Bridge Server │
└────────────────────┬────────────────────────────┘
│
┌───────────────┴──────────────────┐
│ │
┌────▼──────────────┐ ┌────────────▼──────────┐
│ Vite Dev Server │◄────►│ Bridge Server │
│ (开发模式) │ Proxy│ (Express, :30080) │
│ │ │ │
│ • 热更新 │ │ • 对话 / 项目 CRUD │
│ • HMR │ │ • Chat → spawn 引擎 │
│ │ │ • OpenAI ↔ Anthropic │
│ │ │ 双向格式代理 │
└───────────────────┘ │ • 文件上传、图片服务 │
└──────────┬────────────┘
│ stdin/stdout
│ (stream-json)
┌──────────▼────────────┐
│ Claude Code 引擎 │
│ (engine/, Bun 运行) │
│ │
│ • 19+ 内置工具 │
│ • Session 持久化 │
│ • Skill 加载 │
│ • 上下文管理 │
└──────────┬────────────┘
│ HTTPS
▼
上游 API
(Claude / Qwen / GPT ...)配置
自部署模式的 Providers
在 Settings → Models 中添加 Provider。常见配置:
| Provider | Base URL | 格式 |
|----------|----------|--------|
| Claude 中转站(Anthropic 格式) | 中转站提供的 URL | Anthropic |
| Qwen(阿里云) | https://dashscope.aliyuncs.com/compatible-mode | OpenAI |
| DeepSeek | https://api.deepseek.com | OpenAI |
| SiliconFlow | https://api.siliconflow.cn | OpenAI |
| GLM(智谱) | https://open.bigmodel.cn/api/paas/v4 | OpenAI |
| OpenAI | https://api.openai.com | OpenAI |
| Anthropic 官方 | https://api.anthropic.com | Anthropic |
任何兼容 OpenAI 或 Anthropic 格式的 provider 都能接。
Skills
Skills 存在 ~/.claude/skills/,每个 skill 一个目录 + 一个 SKILL.md:
~/.claude/skills/
├── skill-creator/
│ └── SKILL.md
├── code-review/
│ └── SKILL.md
└── your-custom-skill/
└── SKILL.md通过 app 内的 /skill-creator 创建,或手动放文件都行。
技术栈
| 层 | 技术 | |-------|-----------| | 前端 | React 19、TypeScript、TailwindCSS | | 构建 | Vite 6 | | 后端 | Express (Bridge Server) | | 引擎 | Claude Code(TypeScript,Bun 运行) | | 格式代理 | Node.js HTTP server | | Markdown | react-markdown、highlight.js、KaTeX、Mermaid |
Roadmap
顶部 tab 目前有 Chat / Cowork / Code,已完成的是 Chat。如果这个项目反响不错,接下来会按顺序攻破 Cowork(多人协同编辑 / 项目协作模式),然后是 Code(IDE 化编程体验)。
贡献
欢迎提 Issue 和 PR。如果是大功能建议先开 Issue 讨论方向,避免白费力气。
许可
仅允许非商业使用。详见 LICENSE。
Star History
觉得有用的话请点个 Star,帮助更多人发现这个项目。
