如果你用过 Cursor、GitHub Copilot 或 Claude Code,那你一定知道:
- AI 写代码快得飞起 ✨
- 但改完代码后,不知道它到底动了哪些文件 😱
- 更可怕的是——它可能直接在你的 main 分支上乱改!
终端的去点就是缺乏可视化反馈,难以并行处理多个任务,且容易误操作主分支。 好消息是:1Code 出现了!它不是另一个聊天窗口,而是一个为 Claude 量身打造的安全编程环境,主打:
- ✅ 本地运行,代码不出门
- ✅ 每个会话独立 worktree,绝不污染主分支
- ✅ 实时 diff 预览 + 内置 Git 客户端
- ✅ 背景执行 AI 代理,你继续写你的代码
下面,带你快速上手这个“AI 编程驾驶舱”!
🚀 什么是 1Code?
1Code 是由 21st.dev 团队开发的开源工具,目标很明确:
让 Claude 成为你的“可信赖编程副驾”,而不是“盲盒代码生成器”。
它基于 Electron + Bun 构建,提供类似 Cursor 的 UI,但更强调 隔离性、可控性和透明度。
🔒 核心特性:为什么它比网页版更安全?
1️⃣ Git Worktree 隔离:每个会话一个“沙盒”
当你开启一个新聊天任务,1Code 会自动:
- 创建一个 Git Worktree(不是分支!)
- 所有 AI 修改都在这个隔离目录中进行
- 主分支完全 untouched
🎯 场景:你想让 Claude 重构用户模块,但又怕它把登录逻辑搞崩?
→ 放心让它跑!改坏了?删掉 worktree 就行,main 分支毫发无损。
2️⃣ 实时 Diff 预览:AI 改了啥,一眼看清
不像网页版 Claude 只给你一段代码,1Code 会在右侧实时显示文件变更 diff:
- 绿色:新增
- 红色:删除
- 支持逐行审查
3️⃣ 内置 Git 客户端:审完直接提交
确认 AI 改得没问题?
→ 直接在 1Code 里 Stage → Commit → Push,无需切换到终端或 VS Code!
支持:
- 查看分支状态
- 切换分支
- 查看提交历史
4️⃣ 背景执行 + 终端集成:AI 跑它的,你写你的
启动一个耗时任务(比如“生成整个 API 层”)?
→ 点击 Run in Background,1Code 会在后台执行,同时你还能继续编码!
内置终端还能看到:
- Bash 命令执行过程
- 文件写入日志
- Web 搜索结果(如果启用了)
同时支持plan模式帮助你思考。
🛠️ 快速上手
第一步:安装依赖
# 安装依赖
bun install
# 下载 Claude CLI 二进制(关键步骤!)
bun run claude:download
# 构建并打包
bun run build
bun run package:mac # 或 package:win / package:linux
🤖 使用流程:从提问到安全落地
- Claude 先问你问题(比如:“要支持 JWT 还是 OAuth?”)
- 生成结构化计划(Markdown 清单,可预览)
- 你审核计划 → 点击 ✅ 执行 或 ✏️ 修改
- AI 在隔离 worktree 中执行
- 你查看 diff → 满意就提交,不满意就丢弃
整个过程透明、可控、可逆。
🎯 这才是真正的“人机协作”,不是“盲信 AI”。