Claude Code 的国产平替？AtomCode 功能解读与新手入门教程-平芜编程栈

- 写在前面
- 为什么要了解 AtomCode？
- AtomCode 核心定位与功能特点
- 新手快速上手指南
- - 4.1 系统要求
  - 4.2 安装方法（任选一种）
  - 4.3 验证安装
  - 4.4 首次运行

写在前面

AI 编程，简单来说就是利用人工智能技术辅助编写代码、甚至主导软件开发的过程。根据 JetBrains 2026 年全球开发者生态调查，90% 的专业开发者每周至少使用一次 AI 编程工具，其中 68% 每天都在使用，可以看出 AI 编程已从“尝鲜”变为开发者的日常基础设施。

与一开始 AI 编程工具仅辅助编写代码不同，当下 AI 编程工具整体格局其实正在从“代码助手”到“自主智能体”转变。行业竞争的焦点从“AI 会不会写代码”转向了“AI 能不能独立完成软件工程”。Gartner 在 2026 年 5 月发布的《企业级 AI 代码智能体魔力象限》报告中，正式将这一品类从“AI 代码助手”升级为“企业级 AI 代码智能体”，定义为“能够感知上下文、将人类意图转化为多步骤计划，并在代码、测试及相关工程产物上执行和验证这些步骤的自主或半自主软件工程解决方案”。通俗一点说就是目前 AI 编程工具简单辅助写代码已经无法满足市场以及开发者的需求，工具能自主开发、自主进行软件工程才是行业趋势。

为什么要了解 AtomCode？

从 AI 编程工具的整体格局来看，目前还是海外巨头领跑。

Anthropic 于 2025 年 2 月发布编程工具Claude Code，率先将行业带入“Agentic Coding”阶段（Agentic Coding：AI 辅助编程演进中的关键里程碑，代表着一个从"AI 提供建议"到"AI 自主执行任务"的根本性转变）。后来 OpenAI 快速追赶，从起初将将编码需求混在 ChatGPT 订阅中，再到 2025 年也正式推出单独的编程工具OpenAI Codex。

此外还有 Google 的Antigravity、Microsoft 的GitHub Copilot、基于 VS Code 分支的Cursor等等，几乎每隔几个月就有一款新产品刷新人们对“AI 能做什么”的认知。但当你真正想用上这些工具时，问题就来了。

当前 AI 编程工具市场现状：强者很强，但各有各的门槛。

就拿 Claude Code 来说，能力顶尖，但国内开发者基本用不上。作为全球开发者使用率和满意度都最高的 AI 编程工具，但对中国开发者并不友好。Anthropic 公司从成立之初就不对中国用户开放服务。而且在 2026 年 7 月，Claude Code 客户端被曝内置了一套隐蔽的用户识别系统，通过读取本地系统时区、浏览器语言、中文字体等信息来判断用户是否与中国相关，过去两周大量中国用户的 Claude 账号在毫无预警的情况下遭到封禁。

Cursor 也是有着较高的门槛，体验出色但价格昂贵。Pro 版每月 20 美元，企业版每人每月 40 美元，对个人开发者来说并不算便宜。

AtomCode 的出现：填补了一个精准的空白。

当前的现状就是如此，海外产品用不了、用不起、不够用。而AtomCode的定位非常清晰 —— 纯国产、MIT开源、免翻墙、免费 Token 起步的终端 AI 编码智能体。为什么说它精准填补空白？

第一，国产自主可控。基于 Rust 构建，包体小于 50MB、秒级启动，深度适配国产芯片，数据安全可控。此外也原生支持 DeepSeek 等国内主流大模型，不需要依赖任何海外 API 服务。
第二，真正免费可用。AtomCode 提供 CodingPlan 免费计划，登录 AtomGit 即可领取免费Token，足够新手完整体验 AI 编程的全流程。
第三，开源透明。AtomCode 采用 MIT 开源协议，代码完全公开在 AtomGit 上，可审计、可自建。

AtomCode 核心定位与功能特点

AtomCode 是一款定位为“终端 AI 编程智能体”的国产开源工具，于 2026 年 4 月 18 日正式发布。

正如官网介绍：“为需要 ClaudeCode 强大能力但想用任意大模型的开发者打造”，“为开发者而生的能力组合”。它的能力体系我归纳为四个核心支柱：

一、核心工作流：智能 Agent 循环

AtomCode 的核心是自主多步执行引擎，即能像人类开发者一样完成开发工作的闭环：读取→编辑→运行→网络检索→自我验证→循环，执行直至任务完成。

二、模型生态：多模型自由选择

AtomCode 原生支持 Claude、OpenAI、DeepSeek、智谱 GLM、Qwen、Ollama 等主流模型，同时支持接入 OpenAI 所有兼容 API，国产大模型一视同仁，国产开发者可以按需切换，不被任何单一模型绑定。

三、深度理解能力：代码图谱

代码图谱我认为是 AtomCode 的核心差异化功能之一。它提供 8 个内置工具，包括符号索引、调用链追踪、引用查找、影响面分析等，让 AI 真正读懂代码库的上下文关系，而不是像传统工具那样平面地扫描文件。

四、扩展与协作：从截图到生态集成

图片附件与 VL 预处理：Ctrl+V 粘贴截图、Finder 拖拽、iTerm2 路径自动识别。当主模型不支持图片处理时，系统自动调用 VL 模型进行 OCR 预处理，将图片内容转化为文本信息传递给主模型。
AtomGit 原生集成：支持 AtomGit OAuth 一键登录、内置工具管理 Issue / PR / 仓库、企业微信扫码登录，与开源生态无缝对接。
Skills + Plugin 生态：支持通过/plugin install <git-repo>安装插件，一键复用 Claude Code 生态中的命令、Hook 和 Skill。开发者还可以自定义自己的斜杠命令（如/review代码审阅、/test测试生成、/security安全审查），扩展工作流。
目标驱动与循环：支持以目标为导向的自主工作模式。比如使用/goal命令设定一个明确目标，AtomCode 会自动进入多轮循环执行，持续尝试、验证、调整，直至目标达成。/loop按固定间隔或自定节奏重复任务；/todo实时跟踪多步任务清单。
手机 App 远程接管：AtomCode 还提供了灵活的远程协作与跨设备能力，/app吐出二维码，手机扫码即可实时查看并接管当前会话；/webui浏览器界面双向同步，启动一个浏览器界面，实现终端会话的双向同步,随时换设备继续。

新手快速上手指南

4.1 系统要求

操作系统：macOS、Linux、Windows、HarmonyOS PC均可。还需要一个 AtomGit 账号用于 OAuth 登录领取免费额度。

4.2 安装方法（任选一种）

方法一：命令行一键安装

macOS/Linux 系统：

curl -fsSL https://raw.atomgit.com/atomgit_atomcode/atomcode/raw/main/scripts/install.sh | sh

Windows 系统 PowerShell：

irm https://raw.atomgit.com/atomgit_atomcode/atomcode/raw/main/scripts/install.ps1 | iex

方法二：npm 安装（需Node.js 18+）

npm install -g @atomgit.com/atomcode

方式三：Homebrew 安装

已安装 Homebrew 时，可以通过 cask 安装(支持 macOS x64 / arm64、Linux x64 / arm64)：

brew install --cask atomcode

在这里，使用命令行终端 PowerShell 进行安装，安装成功显示如下：

4.3 验证安装

atomcode --version

验证时建议关掉终端重新打开后验证。输入命令可以看到 atomcode 的版本号，安装成功。

4.4 首次运行

输入atomcode运行，第一次启动会弹出 3 步首次启动向导（或者随时用/welcome打开启动向导）；

第一步：欢迎

第二步：选择语言

第三步：配置（你想怎么开始）

如果是想先单纯体验 AtomCode 的话，这里我们选择【[1] 配置Codingplan，这是 AtomCode 为我们提供的免费额度方案，等价于执行/login浏览器唤起 AtomGit OAuth，登录后可自动申领免费额度，并把额度模型列表写成 provider 配置。

如果有自己的大模型 API 可选择手动配置，等价于执行/provider。先添加供应商账号，再为它添加模型。

以上配置完成之后，就可以开始第一个任务了。在项目目录下运行 atomcode，然后直接用自然语言描述需求即可。例如：“写一个 Python 脚本，把当前目录下所有 .txt 文件合并成一个 CSV”。

小提示：在实操过程中，如果提示no provider · /provider to configure，意思是你还没有配置大模型服务商（Provider），因为我们安装好的 AtomCode 本身是一个“外壳”或“框架”，自己目前不包含大模型能力，需要连接一个大模型服务商（Provider）来提供 AI 智能。通常第一次启动 AtomCode 时，它会发现你还没有配置任何模型服务，因此会显示这个提示。这时就需要/provider进行手动配置。