AtomCode 全平台安装与启动详细教程（命令行）

一、工具简介

AtomCode 是一款 Rust 编写的终端AI自主编码工具，支持Windows、macOS、Linux三平台，可以通过自然语言自动读写文件、修改代码、执行脚本。程序没有桌面快捷方式，只能通过终端命令启动，很多用户安装完成后无法打开，核心问题都是环境变量未生效。本文严格按照官方文档整理三种安装方案，以及对应的启动方法与排错方案。

二、系统前置条件

1. 操作系统：Windows x64、macOS、Linux(x86_64)
2. 源码编译才需要：Rust 1.80及以上版本
3. 运行必备：AtomGit账号或者大模型API Key

---

三、三种正规安装方式（官方原版命令）

方式1：一键脚本安装（首选，官方推荐）

脚本会自动下载预编译二进制文件，并自动写入系统PATH环境变量。

Windows系统

1. 右键开始菜单，打开 PowerShell（管理员权限）
2. 执行官方安装脚本：

irm https://atomgit.com/atomgit_atomcode/atomcode/releases/download/v4.22.2/install.ps1 | iex

macOS / Linux / 鸿蒙PC

打开终端执行：

curl -fsSL https://atomgit.com/atomgit_atomcode/atomcode/releases/download/v4.22.2/install.sh | sh

默认安装路径说明：

• Windows：C:\Users\你的用户名\.atomcode\bin
• macOS/Linux：脚本会尝试安装到 ~/.local/bin，如果失败则安装到 ~/.atomcode/bin
• 一键脚本会自动将安装目录添加到系统PATH环境变量

方式2：Cargo源码编译安装注意**：源码编译方式不会自动配置环境变量，需要手动将编译生成的 atomcode 可执行文件复制到系统PATH目录或手动添加环境变量。

安装校验命令（必做）

关闭所有旧终端，重新打开窗口，执行版本查询：

atomcode --version

输出版本号（atomcode 4.22.2）代表安装成功。

---

四、正确打开AtomCode的两种方法

方法1：全局命令启动（安装配置正常时使用）

1. 打开CMD、PowerShell或者系统终端
2. 直接输入启动指令并回车：

atomcode

随后会弹出终端图形欢迎界面，选择AtomGit OAuth扫码登录即可使用。

方法2：直接运行exe文件（命令找不到时应急启动）

不需要配置环境变量，临时运行程序：

1. 进入安装目录 C:\Users\你的用户名\.atomcode\bin
2. 在文件夹顶部地址栏输入 cmd，回车唤起命令行窗口
3. 执行本地程序：

.\atomcode.exe

Mac/Linux对应命令：

./atomcode

附加：无头单次执行（不进入交互界面）

一行指令直接完成代码生成任务：

atomcode -p "编写一个Python文件遍历文件夹脚本"

---

五、高频问题：提示“atomcode不是内部命令 / command not found”

根本原因

一键脚本虽然自动配置PATH，但是旧终端不会加载新环境变量；部分系统权限拦截导致PATH写入失败，程序目录未加入系统环境变量。

分步解决方案

第一步：重启终端（90%的问题可以解决）

把所有CMD、PowerShell全部彻底关闭，重新新开窗口再执行命令。

第二步：手动永久添加环境变量

Windows操作步骤

1. Win+R 输入命令：SystemPropertiesAdvanced，打开高级系统设置
2. 点击【环境变量】→ 用户变量里找到Path，点击编辑
3. 新增一条路径：

%USERPROFILE%\.atomcode\bin

4. 一路保存确认，重启终端再次测试命令。

Mac / Linux操作步骤

1. 编辑shell配置文件，zsh用户执行：

nano ~/.zshrc

bash用户执行：

nano ~/.bashrc

2. 在文件末尾追加这一行：

export PATH="$HOME/.atomcode/bin:$HOME/.local/bin:$PATH"

3. 保存并刷新环境：

source ~/.zshrc
# 或者 source ~/.bashrc

再次执行 atomcode --version 验证。

第三步：检查文件是否存在

Windows在资源管理器地址栏粘贴：

%USERPROFILE%\.atomcode\bin

确认文件夹内存在 atomcode.exe，不存在则说明安装脚本没有执行完成，需要重新运行安装命令。

Mac额外报错：无法打开，无法验证开发者

执行放行命令：

xattr -d com.apple.quarantine $(which atomcode)

即可绕过系统安全拦截。

---

六、首次登录配置说明

运行 atomcode 进入TUI界面后有两个选项：

1. Login with AtomGit OAuth（推荐）：浏览器一键扫码，免费调用内置模型，无需手动填写API密钥。
2. Configure manually API Key：自行填写DeepSeek、通义千问等大模型密钥，适合长期离线部署。

配置文件保存目录：
Windows：%USERPROFILE%\.atomcode\config.toml
Mac/Linux：~/.atomcode/config.toml

---

七、总结

1. 优先使用PowerShell一键脚本安装，安装后必须重启终端再执行命令；
2. 打不开优先排查PATH环境变量，把 .atomcode/bin 加入系统路径；
3. 应急启动可以直接进入exe所在目录，在当前文件夹内运行程序；
4. 所有命令与路径严格对照官方文档，无自定义修改，可稳定复现。