AtomCode 全平台安装与启动详细教程（命令行）
一、工具简介
AtomCode 是一款 Rust 编写的终端AI自主编码工具，支持Windows、macOS、Linux三平台，可以通过自然语言自动读写文件、修改代码、执行脚本。程序没有桌面快捷方式，只能通过终端命令启动，很多用户安装完成后无法打开，核心问题都是环境变量未生效。本文严格按照官方文档整理三种安装方案，以及对应的启动方法与排错方案。
二、系统前置条件
- 操作系统：Windows x64、macOS、Linux(x86_64)
- 源码编译才需要：Rust 1.80及以上版本
- 运行必备：AtomGit账号或者大模型API Key
三、三种正规安装方式（官方原版命令）
方式1：一键脚本安装（首选，官方推荐）
脚本会自动下载预编译二进制文件，并自动写入系统PATH环境变量。
Windows系统
- 右键开始菜单，打开PowerShell（管理员权限）
- 执行官方安装脚本：
irmhttps://atomgit.com/atomgit_atomcode/atomcode/releases/download/v4.22.2/install.ps1|iexmacOS / Linux / 鸿蒙PC
打开终端执行：
curl-fsSLhttps://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：全局命令启动（安装配置正常时使用）
- 打开CMD、PowerShell或者系统终端
- 直接输入启动指令并回车：
atomcode随后会弹出终端图形欢迎界面，选择AtomGit OAuth扫码登录即可使用。
方法2：直接运行exe文件（命令找不到时应急启动）
不需要配置环境变量，临时运行程序：
- 进入安装目录
C:\Users\你的用户名\.atomcode\bin - 在文件夹顶部地址栏输入
cmd，回车唤起命令行窗口 - 执行本地程序：
.\atomcode.exeMac/Linux对应命令：
./atomcode附加：无头单次执行（不进入交互界面）
一行指令直接完成代码生成任务：
atomcode-p"编写一个Python文件遍历文件夹脚本"五、高频问题：提示“atomcode不是内部命令 / command not found”
根本原因
一键脚本虽然自动配置PATH，但是旧终端不会加载新环境变量；部分系统权限拦截导致PATH写入失败，程序目录未加入系统环境变量。
分步解决方案
第一步：重启终端（90%的问题可以解决）
把所有CMD、PowerShell全部彻底关闭，重新新开窗口再执行命令。
第二步：手动永久添加环境变量
Windows操作步骤
- Win+R 输入命令：
SystemPropertiesAdvanced，打开高级系统设置 - 点击【环境变量】→ 用户变量里找到Path，点击编辑
- 新增一条路径：
%USERPROFILE%\.atomcode\bin- 一路保存确认，重启终端再次测试命令。
Mac / Linux操作步骤
- 编辑shell配置文件，zsh用户执行：
nano~/.zshrcbash用户执行：
nano~/.bashrc- 在文件末尾追加这一行：
exportPATH="$HOME/.atomcode/bin:$HOME/.local/bin:$PATH"- 保存并刷新环境：
source~/.zshrc# 或者 source ~/.bashrc再次执行atomcode --version验证。
第三步：检查文件是否存在
Windows在资源管理器地址栏粘贴：
%USERPROFILE%\.atomcode\bin确认文件夹内存在atomcode.exe，不存在则说明安装脚本没有执行完成，需要重新运行安装命令。
Mac额外报错：无法打开，无法验证开发者
执行放行命令：
xattr-dcom.apple.quarantine$(whichatomcode)即可绕过系统安全拦截。
六、首次登录配置说明
运行atomcode进入TUI界面后有两个选项：
- Login with AtomGit OAuth（推荐）：浏览器一键扫码，免费调用内置模型，无需手动填写API密钥。
- Configure manually API Key：自行填写DeepSeek、通义千问等大模型密钥，适合长期离线部署。
配置文件保存目录：
Windows：%USERPROFILE%\.atomcode\config.toml
Mac/Linux：~/.atomcode/config.toml
七、总结
- 优先使用PowerShell一键脚本安装，安装后必须重启终端再执行命令；
- 打不开优先排查PATH环境变量，把
.atomcode/bin加入系统路径； - 应急启动可以直接进入exe所在目录，在当前文件夹内运行程序；
- 所有命令与路径严格对照官方文档，无自定义修改，可稳定复现。
