如何5分钟上手Atlas:让Claude Code与Codex首次并行的完整入门指南
【免费下载链接】atlasSource control for agents. Use multiple coding agents, track their changes and query them in one place项目地址: https://gitcode.com/GitHub_Trending/atlas115/atlas
Atlas是一款为 AI 编程智能体打造的桌面工作台,主打"智能体源代码管理"(Source control for agents):你可以同时运行 Claude Code、Codex 等多个编码智能体,在一个窗口里统一追踪它们的每一次代码改动、查看 Diff、审阅提交,并对它们随时提问。对于刚接触 AI 编程的新手来说,本文是一份 5 分钟上手的完整入门指南,带你快速完成安装、连接智能体、并跑通 Claude Code 与 Codex 首次并行对话。
为什么需要 Atlas?
传统命令行智能体(如 Claude Code、Codex)各自为战:
- 改动散落各处——多个智能体同时改代码时,你很难看清"谁改了什么";
- 上下文互相隔离——Claude Code 的会话记忆(
CLAUDE.md)与 Codex 的线程状态(~/.codex/)彼此独立; - 没有统一审查——智能体提交的代码缺少可视化的变更追踪与爆炸半径分析。
Atlas 把这些都收进一个原生桌面应用:左侧是 Git 图谱,中间是智能体对话,右侧是变更分析与复杂度热力图,底部还有 token 用量与工具调用统计。
准备工作:3 项前置检查 ✅
Atlas 基于 Tauri 2 构建,智能体通过 ACP(Agent Client Protocol)协议接入。开始前请确认:
- 系统:macOS(Apple Silicon 优先),或支持 Tauri 的 Linux;
- Node.js ≥ 18:Claude Code 与 Codex 的 ACP 桥接器通过
npx启动(如npx -y @agentclientprotocol/claude-agent-acp),见 registry.rs 中的智能体定义; - 账号:Claude Code 需要 Anthropic 登录,Codex 需要 ChatGPT 登录或
OPENAI_API_KEY。
若从源码构建,可先克隆仓库:
git clone https://gitcode.com/gh_mirrors/atlas115/atlas前端与桌面端的整体结构可参考 src/ 与 src-tauri/ 两个目录。
第 1 步:安装并启动 Atlas(1 分钟)
最快捷的方式是直接下载官方 Release 的 macOS 安装包(.dmg),双击拖入 Applications 即可。若你是开发者,想本地跑起来:
# 安装前端依赖并启动开发模式 bun install bun dev启动后你会看到典型的三栏布局:会话列表、对话区、变更分析面板——这就是整个"5 分钟体验"的主战场。
第 2 步:连接 Claude Code 与 Codex(2 分钟)
Atlas 内置了主流智能体的启动规格,无需手动写配置:
| 智能体 | 启动方式 | 说明 |
|---|---|---|
| Claude Code | npx -y @agentclientprotocol/claude-agent-acp | 官方 ACP 桥接,首次运行需按提示登录 |
| Codex | npx -y @agentclientprotocol/codex-acp | 复用~/.codex的登录态 |
| OpenCode / Cursor | opencode acp/cursor-agent acp | 原生支持 ACP |
在聊天面板底部的输入框旁选择智能体即可。若检测到 Node.js 环境缺失,应用会展示 Node 环境引导横幅 指引你修复;Claude 的登录流程则封装在 claude-setup/ 模块中,按弹窗操作完成授权即可。
第 3 步:首次并行对话,见证"双智能体协作"(2 分钟)
现在见证核心功能——同一项目里同时和两个智能体工作:
- 在左侧新建两个会话,一个选Claude Code,一个选Codex;
- 给两者相同的任务,例如"为 utils 模块补充单元测试";
- 切换查看两边的流式输出、工具调用与文件 Diff。
几个新手最关心的细节:
- 变更追踪:每个智能体的改动都会进入 Git 图谱(git-graph 组件),谁提交了哪一行一目了然;
- 记忆互通:Atlas 会把 Claude 的 markdown 记忆与 Codex 的线程历史统一抽取为可检索的记忆文档,逻辑见 agent_memory.rs;
- 用量统计:状态栏实时显示 token 消耗与工具调用次数,统计逻辑在 agent_analytics.rs;
- 权限审批:智能体执行危险操作前会弹出审批卡片(approval-card 组件),你可以逐项放行或拒绝。
上手后的进阶玩法
- @ 引用文件:在输入框用
@提及代码文件,为智能体精准投喂上下文; - Knowledge 面板:用笔记与图谱沉淀项目知识,让智能体"越用越懂你";
- Git 面板:可视化提交图、冲突解决与提交信息生成(git 特性目录)。
常见问题速查 🛠️
| 问题 | 解决方法 |
|---|---|
npx启动智能体失败 | 检查 Node.js 版本,重新打开终端使 PATH 生效 |
| Codex 提示未登录 | 先在命令行执行 Codex 登录,或配置OPENAI_API_KEY |
| 会话历史丢失 | Atlas 读取~/.claude与~/.codex状态,确认目录可读 |
💡 小贴士:智能体协议层实现在 crates/atlas-acp/(Rust 编写的 ACP 客户端),想深入了解 Atlas 如何调度多智能体,可以从 driver.rs 和 spawn.rs 看起。
总结
5 分钟回顾一下你完成的事:安装 Atlas → 连接 Claude Code 与 Codex → 双智能体并行开工。从此你可以像管理 Git 分支一样管理 AI 智能体——追踪它们的每一次改动、对比它们的输出、并放心审阅最终提交。这就是 Atlas 的核心价值:Source control for agents。
【免费下载链接】atlasSource control for agents. Use multiple coding agents, track their changes and query them in one place项目地址: https://gitcode.com/GitHub_Trending/atlas115/atlas
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考