前言2026 年的 AI 编码工具赛道已经卷到了一个新阶段。Cursor、Copilot、Claude Code 各占山头但有一个项目正在用一种截然不同的方式切入这场竞争——AtomCode。它不依赖 IDE不需要浏览器甚至不需要图形界面。它就是终端里的一个二进制文件用 Rust 编译体积小、启动快、不吃资源。你告诉它做什么它会自动读代码、改代码、跑命令、验证结果完事了回来交差。这篇文章面向第一次听说 AtomCode 的开发者带你从零把它跑起来完成第一个 AI 编码任务。AtomCode 是什么AtomCode 是一个运行在终端里的 AI 编码代理。它和 Claude Code、Cursor Agent 定位相似但有一个核心差异完全开源、MIT 协议、纯 Rust 编写可以接入任何兼容 OpenAI 接口的大模型。它有这些特点自主执行你只需要用自然语言描述目标它会自动规划、读取文件、编辑代码、运行测试、修复错误循环直到任务完成。验证回路每次编辑后自动做语法检查确认无误才算完成。多模型兼容Claude、OpenAI、DeepSeek、GLM、Qwen、Ollama 本地模型……任何实现了 function calling 的 OpenAI 兼容接口都能接。跨平台macOS、Linux、Windows、HarmonyOS PC 四个平台全覆盖。还有一个有意思的背景这个项目100% 由 AI 生成代码、架构决策、commit 信息全部是 AI 写的。人类只扮演产品经理的角色——定义做什么不定义怎么做。安装 AtomCodeAtomCode v4.26.0 目前提供三种安装方式。方式一从源码构建推荐编译依赖 Rust 1.88安装好 Rust 工具链后git clone https://atomgit.com/atomgit_atomcode/atomcode.git cd atomcode cargo install --path crates/atomcode-cli --locked编译产物在target/release/atomcode。macOS / Linux 下会被安装到~/.cargo/bin/atomcodeWindows 下在%USERPROFILE%\.cargo\bin\atomcode.exe。务必确保对应路径已加入PATH环境变量。方式二包管理器安装# npm npm install -g atomgit.com/atomcode # Homebrew (macOS) brew install --cask atomcode方式三一行脚本Windows / macOS / Linux官方提供了一键安装脚本免去手动编译的麻烦具体命令见 atomcode.atomgit.com 官网。首次运行三步启动向导终端输入atomcode第一次运行会弹出一个三步骤引导向导第 1 步 —— 欢迎页显示版本号和能力概要按 Enter 继续。第 2 步 —— 语言选择支持自动检测根据LC_ALL/LANG环境变量、简体中文、英文三种选项。后续任何时候都可以用/language切换。第 3 步 —— 模型配置三种路径可选CodingPlan 免费额度推荐通过 AtomGit OAuth 登录自动获取免费模型额度零成本起步。手动配置 API Key填入任意兼容 OpenAI 接口的 API Key。暂时跳过先进去逛逛后面再配。如果选择手动配置 API Key配置文件位于~/.atomcode/config.toml一个最简配置长这样default_provider deepseek [providers.deepseek] type openai api_key sk-你的密钥 model deepseek-chat base_url https://api.deepseek.com/v1 context_window 64000可以配置多个 provider在对话中用/model实时切换。改完配置后在 TUI 里执行/reload即可生效不用重启。重要提醒不要用sudo启动 AtomCode。它把配置、会话和日志都存在~/.atomcode下一旦 root 跑过留下 root 属主的文件之后普通用户启动就会报Permission denied。如果已经踩坑了执行sudo chown -R $(id -un):$(id -gn) ~/.atomcode收回权限即可。进入项目下达第一个任务配置搞定之后进入任意项目目录运行cd 你的项目 atomcode终端会进入一个 TUI 界面底部出现输入提示符。这时候直接用自然语言描述任务。举几个真实可用的例子修复 OAuth 回调后用户被重定向到 404 的登录 bug给设置页加一个深色模式切换把数据库模块重构为使用连接池给支付处理模块写单元测试AtomCode 会自己分析项目结构找到相关文件编辑代码跑测试验证然后汇报结果。Headless 模式也是新人最常用的入口之一适合只想快速完成一件事、不想进入交互式 TUI 的场景# 单条命令结果输出到 stdout atomcode -p 简要介绍这个仓库的架构 # 从文件读取 prompt atomcode --prompt-file task.md # 指定模型 atomcode --model gpt-4o -p 解释 agent loop 的设计斜杠命令速览你最先需要知道的几个在 TUI 中输入/就能浏览完整命令列表。入门阶段先记住这几个命令作用/model切换模型或 provider/resume恢复历史会话/diff查看 AI 做了哪些文件改动/undo撤销上一轮的文件编辑/cost查看本次会话的 token 消耗/clear清空上下文开始新对话/compact压缩对话历史释放上下文空间/plan切换到只读探索模式只看不改/build切回完整执行模式/review代码审查当前改动/quit退出其中有几个特别实用。/diff能让你快速看到 AI 改了什么改了哪几行心里有底。/undo是一键后悔药——对 AI 改动的代码不满意直接撤销上一轮所有文件编辑。图片也能当输入AtomCode 支持把截图作为上下文输入。macOS 和 Linux 下直接CtrlV粘贴截图终端会把图片附加上去。如果用的是不带视觉能力的模型AtomCode 会自动调用视觉预处理器OCR 图片描述让普通模型也能看懂图片。Windows 用户的CtrlV会被终端自身拦截改用/paste命令即可效果完全一样。TUI 右下角也会自动提示剪贴板有图片 · /paste 粘贴。安全性不会偷偷搞破坏AtomCode 内置了一整套安全机制破坏性命令拦截rm -rf、git push --force、DROP TABLE等操作必须用户显式确认。敏感路径保护写入/etc、~/.ssh、shell 配置文件、.env文件时会触发更强的确认流程。源码删除确认对代码文件执行rm从不自动放行即便你选了始终允许也绕不过去。按会话授权每个工具模式的授权范围只限当前会话下一次启动需要重新确认。这套体系对新人和老手都友好——该拦的拦住该放的放行。碰到问题怎么办连不上模型先检查config.toml里的base_url和api_key是否正确代理设置可以用/proxy调整。权限确认太频繁正常现象。AtomCode 的安全性设计就是宁可多问不能乱动。用得多了可以按模式设始终允许。上下文超限用/compact压缩历史或者/clear另起新对话。想反馈 bugTUI 里直接/issue会弹出交互式向导帮你提交 issue 到 AtomGit 仓库。卸载如果不需要了干净卸载也很简单atomcode uninstall # 交互模式分组询问 atomcode uninstall --purge # 彻底清除包括 ~/.atomcode 目录 atomcode uninstall --dry-run # 先看计划不执行总结AtomCode 的上手门槛很低。装好 Rust 工具链一条cargo install三步向导配好模型进项目目录就能干活。它的价值不在于比 Cursor 或 Copilot 多了什么炫酷功能而在于一种更轻量的工作流——终端打开描述任务等 AI 改完代码回来告诉你结果。不需要切窗口不需要点按钮不需要在那等补全。对于习惯命令行工作流的开发者来说这是一个值得加入工具箱的利器。相关链接官网atomcode.atomgit.comhttps://atomcode.atomgit.com/仓库atomgit.com/atomgit_atomcode/atomcodehttps://atomgit.com/atomgit_atomcode/atomcode文档atomcode.atomgit.com/docs/zh/https://atomcode.atomgit.com/docs/zh/index.html