三亩地 三亩地SAN MU DI · CODE DIARY
交流投稿
ARTICLE DETAIL

日记详情

真实记录编程学习的某一天，欢迎挑你感兴趣的翻一翻。

首页/学习日记/日记详情

原子AtomCode介绍和安装说明

发布时间：2026/8/11 12:56:02 三亩地 编程学习日记
原子AtomCode介绍和安装说明

原子 AtomCode

类别：国内智能体开发平台 ｜ 更新时间：2026-07

1. 基础信息

项目内容
开发商AtomGit（开放原子开源基金会 + CSDN 等生态伙伴）
是否开源是（开源）
开源协议MIT
官方网站https://atomcode.atomgit.com
底层模型任意 OpenAI 兼容 API（Claude / GPT / DeepSeek / GLM / Qwen 等）
定价模式开源免费 + CodingPlan 免费额度
适用人群开发者、个人程序员、开源社区用户

2. 核心设计思想

AtomCode 是运行在终端里的开源 AI 编程智能体，由 AtomGit 社区推出，被定位为 Claude Code / Cursor Agent 的"开源平替"。开发者用自然语言下达任务，它能自主读取代码库、编辑文件、执行命令并自我验证，直至任务完成，整个项目 100% 由 AI 生成、用 Rust 构建，主打性能与可移植性。

中立开放是 AtomCode 最大的差异化标签：不绑定任何厂商模型，任何 OpenAI 兼容 API 均可接入，国产大模型（DeepSeek、GLM、Qwen）与国际模型一视同仁。对想要 Claude Code 体验但希望自由选择模型、或对闭源工具存疑的开发者而言，它是低门槛的替代选择。

市场地位：背靠 AtomGit（开放原子开源基金会与 CSDN 等共建的开源 + AI 协作平台），2025 年底随平台升级正式亮相，处于快速迭代期。差异点在于其"多模型 + 开源 + 终端"组合，适合追求自主可控的开发者；生态体量与商业工具的成熟度仍有差距。

3. 特性

  • 终端原生：Rust 构建，跨平台（macOS / Linux / Windows / HarmonyOS PC）
  • 智能 Agent 循环：读取 → 编辑 → 运行 → 验证，循环直至任务完成
  • 多模型支持：任意 OpenAI 兼容 API，Claude / GPT / DeepSeek / GLM / Qwen / Ollama 皆可
  • 代码图谱工具：8 个内置工具（符号索引、调用链追踪、影响面分析等）
  • 21 个内置工具：文件、终端、检索、网络、技能调用全覆盖
  • Skills 与 Plugin 生态：与 Claude Code 生态兼容，/plugin install 一键安装
  • AtomGit 原生集成：OAuth 登录、Issue / PR / 仓库管理
  • 图片附件与 VL 预处理：不支持图片的模型自动走 OCR
  • 目标驱动与循环：/goal、/loop、/todo 实现自主多轮执行
  • IDE 插件：VS Code / JetBrains 侧边栏接入，Diff 预览
  • 远程接管：手机 App 扫码、Web UI 双向同步
  • 100% AI 生成：社区共创 + CodingPlan 免费额度降低使用门槛

4. 典型模式

  • 代码库理解与重构：用代码图谱工具梳理大型仓库，快速定位符号与调用链，辅助重构。
  • 自动修复与验证：描述 Bug 后由 Agent 自主编辑代码、跑测试、自我验证直至通过。
  • 自定义技能扩展：通过 Skills 编写斜杠命令，沉淀团队内部的代码审查、安全检查流程。

5. 关键对比

维度原子 AtomCodeClaude Code通义灵码
定位开源终端 AI 编程智能体闭源终端编程智能体阿里云 IDE 编程助手
是否开源是（MIT）否否
模型绑定任意 OpenAI 兼容 APIClaude 系列通义系列
运行形态终端跨平台终端IDE 插件为主
最佳场景开源/多模型开发者Claude 生态深度用户阿里云生态开发者

何时选 AtomCode：追求开源自主、想自由选择模型（尤其国产模型）的开发者优先；深度绑定 Claude 生态可选 Claude Code，阿里云生态内开发可考虑通义灵码。

6. 优缺点

优点

  • 开源 MIT 协议，代码可控、可自建
  • 模型中立，任意 OpenAI 兼容 API 皆可接入
  • 跨平台 + 代码图谱工具，大型代码库理解能力强

缺点

  • 项目尚处快速迭代期，稳定性与生态成熟度待提升
  • 终端形态对非技术用户门槛较高
  • 商业支持与文档体系不如闭源产品完善

7. 落地组合方案

方案一（个人开发提效）：AtomCode + DeepSeek / GLM API + CodingPlan 免费额度。以零成本在终端获得类 Claude Code 的编程智能体体验，覆盖日常开发、测试与重构。

方案二（团队自主可控）：自部署 AtomCode + 私有化大模型网关 + AtomGit 仓库托管。统一团队 AI 编程工具链，代码不出内网，同时借助 Skills 沉淀团队专属工作流。

8. 安装步骤

AtomCode 是开源终端工具（MIT 协议），无需云端账号，安装方式任选其一。

方式一：npm 一键安装（需要 Node.js）：

npminstall-g@atomgit.com/atomcode

方式二：官方一键脚本（macOS / Linux）：

curl-fsSLhttps://atomgit.com/atomgit_atomcode/atomcode/raw/main/install.sh|sh

方式三：Windows PowerShell 一键脚本：

irmhttps://atomgit.com/atomgit_atomcode/atomcode/raw/main/install.ps1|iex

方式四：从源码构建（需要 Rust 1.88+）：

gitclone https://atomgit.com/atomgit_atomcode/atomcode.gitcdatomcodecargoinstall--pathcrates/atomcode-cli--locked

安装后运行atomcode --version验证。首次运行需配置一个模型 Provider：可用 AtomGit CodingPlan 免费额度，或填入任意 OpenAI 兼容 API（DeepSeek、GLM、Qwen、Claude 等）的 Key。

9. 登录与模型配置

AtomCode 不绑定任何厂商，首次运行通过 3 步向导选择语言并配置 Provider。接入方式有三种：AtomGit OAuth 登录（CodingPlan 免费额度）、第三方 OpenAI 兼容 API Key、本地 Ollama 模型。

9.1 方式一：CodingPlan 免费额度（OAuth 登录）

零成本获得类 Claude Code 体验，无需单独申请 API Key：

atomcode login# 弹出浏览器，用 AtomGit 账号 OAuth 授权atomcode auth status# 查看登录状态与剩余免费额度

登录后自动使用 CodingPlan 免费额度，支持 /goal、/loop、/todo 等目标驱动指令，适合日常开发。

9.2 方式二：第三方厂商 API Key（OpenAI 兼容）

支持任意 OpenAI 兼容 API，配置命令与常见厂商示例：

# DeepSeek（深度求索）atomcode provideradddeepseek --base-url https://api.deepseek.com/v1--modeldeepseek-chatexportDEEPSEEK_API_KEY=sk-xxxxxxxx# GLM（智谱清言，OpenAI 兼容地址）atomcode provideraddglm --base-url https://open.bigmodel.cn/api/paas/v4--modelglm-4.5exportZHIPU_API_KEY=xxxxxxxx.yyyyyyyy# Qwen（阿里云百炼 / DashScope）atomcode provideraddqwen --base-url https://dashscope.aliyuncs.com/compatible-mode/v1--modelqwen-maxexportDASHSCOPE_API_KEY=sk-xxxxxxxx# OpenAI / Claude（也支持国际模型）atomcode provideraddopenai --base-url https://api.openai.com/v1--modelgpt-4oexportOPENAI_API_KEY=sk-xxxxxxxx

也可写入全局配置文件~/.atomcode/config.yaml持久化：

providers:deepseek:base_url:https://api.deepseek.com/v1api_key:sk-xxxxxxxxmodel:deepseek-chattemperature:0.7

会话内随时切换：/provider切换厂商，/model切换该厂商下的模型。

9.3 方式三：本地 Ollama（完全离线）

# 启动本地模型（如 qwen2.5:7b），再接入 AtomCodeollama serve atomcode provideraddollama --base-url http://localhost:11434/v1--modelqwen2.5:7b

10. 简单示例

示例一：用 AtomCode 直接生成一个 HTML 小游戏（贪吃蛇）。

  1. 空目录中运行atomcode，在提示符输入：“帮我写一个用 HTML + CSS + JavaScript 实现的贪吃蛇小游戏，单文件，用方向键控制，得分显示在页面上，保存为 snake.html”。
  2. Agent 自动创建snake.html，包含画布、游戏循环、键盘事件与计分逻辑。
  3. 继续输入：“在本地起一个静态服务器并打开页面验证游戏能正常运行”。
  4. Agent 运行python -m http.server 8000（或 node/npx 方式）并验证文件无语法错误，必要时自动修复循环直至通过。
  5. 浏览器打开 http://localhost:8000/snake.html 即可试玩；不满意可继续描述需求（如"增加音效"“改为 20 格 x 20 格”“加一个重新开始按钮”）让 Agent 迭代修改。

说明：AtomCode 按你配置的厂商 API 计费（CodingPlan 免费额度或自备 Key），生成 HTML 小游戏这类任务消耗 Token 较少，可用免费额度完成。

编程学习 学习日记 实战经验
← 返回列表