如何5分钟上手Atlas:让Claude Code与Codex首次并行的完整入门指南
2026/9/17 3:57:51 网站建设 项目流程

如何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)协议接入。开始前请确认:

  1. 系统:macOS(Apple Silicon 优先),或支持 Tauri 的 Linux;
  2. Node.js ≥ 18:Claude Code 与 Codex 的 ACP 桥接器通过npx启动(如npx -y @agentclientprotocol/claude-agent-acp),见 registry.rs 中的智能体定义;
  3. 账号: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 Codenpx -y @agentclientprotocol/claude-agent-acp官方 ACP 桥接,首次运行需按提示登录
Codexnpx -y @agentclientprotocol/codex-acp复用~/.codex的登录态
OpenCode / Cursoropencode acp/cursor-agent acp原生支持 ACP

在聊天面板底部的输入框旁选择智能体即可。若检测到 Node.js 环境缺失,应用会展示 Node 环境引导横幅 指引你修复;Claude 的登录流程则封装在 claude-setup/ 模块中,按弹窗操作完成授权即可。

第 3 步:首次并行对话,见证"双智能体协作"(2 分钟)

现在见证核心功能——同一项目里同时和两个智能体工作

  1. 在左侧新建两个会话,一个选Claude Code,一个选Codex
  2. 给两者相同的任务,例如"为 utils 模块补充单元测试";
  3. 切换查看两边的流式输出、工具调用与文件 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),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询