原子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. 关键对比
| 维度 | 原子 AtomCode | Claude Code | 通义灵码 |
|---|---|---|---|
| 定位 | 开源终端 AI 编程智能体 | 闭源终端编程智能体 | 阿里云 IDE 编程助手 |
| 是否开源 | 是（MIT） | 否 | 否 |
| 模型绑定 | 任意 OpenAI 兼容 API | Claude 系列 | 通义系列 |
| 运行形态 | 终端跨平台 | 终端 | 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:7b10. 简单示例
示例一：用 AtomCode 直接生成一个 HTML 小游戏（贪吃蛇）。
- 空目录中运行
atomcode，在提示符输入：“帮我写一个用 HTML + CSS + JavaScript 实现的贪吃蛇小游戏，单文件，用方向键控制，得分显示在页面上，保存为 snake.html”。 - Agent 自动创建
snake.html，包含画布、游戏循环、键盘事件与计分逻辑。 - 继续输入：“在本地起一个静态服务器并打开页面验证游戏能正常运行”。
- Agent 运行
python -m http.server 8000（或 node/npx 方式）并验证文件无语法错误，必要时自动修复循环直至通过。 - 浏览器打开 http://localhost:8000/snake.html 即可试玩；不满意可继续描述需求（如"增加音效"“改为 20 格 x 20 格”“加一个重新开始按钮”）让 Agent 迭代修改。
说明：AtomCode 按你配置的厂商 API 计费（CodingPlan 免费额度或自备 Key），生成 HTML 小游戏这类任务消耗 Token 较少，可用免费额度完成。