【 AtomCode 全平台安装与启动详细教程】

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默认安装路径说明WindowsC:\Users\你的用户名\.atomcode\binmacOS/Linux脚本会尝试安装到~/.local/bin如果失败则安装到~/.atomcode/bin一键脚本会自动将安装目录添加到系统PATH环境变量方式2Cargo源码编译安装注意**源码编译方式不会自动配置环境变量需要手动将编译生成的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操作步骤WinR 输入命令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.tomlMac/Linux~/.atomcode/config.toml七、总结优先使用PowerShell一键脚本安装安装后必须重启终端再执行命令打不开优先排查PATH环境变量把.atomcode/bin加入系统路径应急启动可以直接进入exe所在目录在当前文件夹内运行程序所有命令与路径严格对照官方文档无自定义修改可稳定复现。