玩转 AtomCode在云服务器部署并让 AI 替你写代码的实战记录征文活动码动四季 · 夏季主题「玩转 AtomCode」类型实战体验类 —— 我在云服务器上部署 AtomCode 并用它自动编写、运行、验证一个 Python 命令行工具的真实记录环境Ubuntu 22.04 云主机 × AtomCode 5.0.0 × AtomGit CodingPlan 免费模型原创声明本文为作者实操记录所有命令输出均来自真实服务器截图/日志未经任何平台发表。0. 为什么要在服务器上玩 AtomCodeAtomCode 是一款「开源 多模型 免费 Token」的终端 AI 编码智能体agentic coding assistant。它和常见的聊天式 AI 编程最大的区别在于它能直接在你的文件系统里读、写、跑——一句话需求下去它自己写代码、建测试文件、执行命令、看报错、再修直到跑通。把它装到一台常驻的云服务器上有 3 个实实在在的好处7×24 无人值守headless 模式-p参数让你可以把帮我写个工具并验证这种任务丢给服务器关掉本地终端也不中断。远程 WebUI 协作自带浏览器 WebUI手机/平板也能随时调教项目。免费额度不浪费登录 AtomGit 即可领取 CodingPlan 限免模型额度对日常脚本、Demo、运维小工具来说完全够用。下面是我在一台 2C/4G 的 Ubuntu 22.04 云主机上从零部署到跑通一个真实编码任务的完整过程含踩坑记录。1. 环境与部署架构目标服务器基础信息真实ssh采集项值系统Ubuntu 22.04.3 LTS (x86_64)CPU / 内存2 vCPU / 3.8 GiB磁盘59G已用 31G可用 26G预装Node.js 20.18.1、Python 3.10.12、Git 2.34.1二进制/usr/local/bin/atomcodeRust 编译不依赖 Node部署后的服务拓扑systemd 托管双服务┌──────────────────────────────────────┐ │ Ubuntu 22.04 云主机 │ │ 117.72.182.3 │ │ │ 终端 (SSH/TTY) ──────┤ atomcode (CLI / headless -p) │ │ │ │ 浏览器 ──token────────┤ atomcode-webui :13457 (systemd) │ │ │ │ IDE 扩展 ────────────┤ atomcode-daemon :13456 (IDE 集成) │ │ │ │ │ ~/.atomcode/ (config/sessions/plugins)│ └────────┬───────────────────────────────┘ │ OAuth 模型 API ▼ AtomGit CodingPlan免费 Token llm-api.atomgit.com/v1 · deepseek-v4-flash 等端口设计细节webui默认 13457daemon默认 13456刻意错开以避免与 IDE 扩展抢端口导致 401/无响应——这是官方刻意的设计部署时无需改端口。2. 安装与版本管理自动更新是真香的官方提供一键安装脚本自动检测平台并下载预编译二进制到PATHcurl-fsSLhttps://raw.atomgit.com/atomgit_atomcode/atomcode/raw/main/scripts/install.sh|sh我当时部署报告记录的初装版本是4.26.0$ atomcode --version atomcode 4.26.0 $ which atomcode /usr/local/bin/atomcode但当我一周后回来看时版本已经静默自更新到了 5.0.0$ atomcode--versionatomcode5.0.0(unknown)$ systemctl status atomcode-webui --no-pager|head-3● atomcode-webui.service - AtomCode WebUI Active: active(running)since Fri2026-07-1014:08:52 CST;1week2days ago这对运维是好事config.toml里auto_update true小版本自动升级零维护。万一升级翻车还有原地对滚atomcode upgrade# 原地升级到最新发布版--force 强制重装atomcode rollback# 回退到上一个版本磁盘上 .bak 互换atomcode status# 查看登录态与当前模型踩坑提示自动更新依赖二进制所在目录可写 PATH稳定。用官方脚本装到/usr/local/bin最省心别手挪二进制。3. 登录与免费模型配置AtomCode 是外壳真正干活要靠模型。首次运行atomcode会进启动向导配置方式三选一/login走AtomGit OAuth推荐可领取 CodingPlan 限免额度手动填 OpenAI 兼容 API KeyDeepSeek / GLM / Qwen / Claude 等暂时跳过后续用/config配置我的服务器已登录并领取了 CodingPlan 模型状态如下真实输出$ atomcode status Loggedinas: cpyaxjq(66612fcc2da91e28f2501347)Name: cpyaxjq Email: cpyaxjqnoreply.gitcode.com Auth file: /root/.atomcode/auth.toml落盘的~/.atomcode/config.toml节选含真实模型名default_provider AtomGit-deepseek-v4-flash auto_update true vision_preprocessor_provider AtomGit-Qwen-Qwen3-VL-8B-Instruct [providers.AtomGit-deepseek-v4-flash] type openai model deepseek-v4-flash base_url https://llm-api.atomgit.com/v1 context_window 1000000 # 100 万 token 上下文 [providers.AtomGit-Qwen-Qwen3-VL-8B-Instruct] type openai model Qwen/Qwen3-VL-8B-Instruct base_url https://llm-api.atomgit.com/v1 context_window 64000 # 视觉预处理模型要点默认主力模型deepseek-v4-flash上下文 1M日常脚本、长日志分析、整库重构都不虚。视觉模型Qwen3-VL-8B用于图片/截图理解例如把报错截图丢给它看。web_search.provider exa内置联网搜索能查文档、查报错。subagent默认开启max_turns12, max_concurrent3复杂任务会自动拆子任务并行跑。4. 核心实战让 AtomCode 从零写一个工具并自己验证这是本文最硬核的部分。我不想只问它怎么写而是让它真正落地——写代码、建测试文件、运行、看结果。4.1 一句话需求headless 模式-p进入非交互模式-y跳过所有权限确认自动批准工具调用-C指定工作目录cd/root/atomcode_demo_blog atomcode-y-C/root/atomcode_demo_blog-p用 Python 写一个命令行工具 wordcount.py 读取一个文本文件统计行数、单词数、字符数类似 wc支持 --top N 参数输出 出现频率最高的 N 个单词。要求含 argparse 和 if __name__ 入口、代码规范、含中文注释。 然后创建 sample.txt 测试文件并实际运行 python3 wordcount.py sample.txt --top 3 验证输出正确。它实际做了什么从生成的产物反推 agent 的 tool 调用链用Write创建wordcount.py含argparse/collections.Counter/ 中文注释 /main()入口。用Write创建sample.txt测试语料。用Bash执行python3 wordcount.py sample.txt --top 3验证。读取运行结果确认正确后结束。4.2 它生成的代码节选自wordcount.pydefcount_stats(file_path):读取文件并返回行数, 单词数, 字符数, 单词频率 Counterwithopen(file_path,r,encodingutf-8)asf:contentf.read()line_countcontent.count(\n)ifcontentandnotcontent.endswith(\n):line_count1char_countlen(content)wordscontent.split()word_countlen(words)word_freqCounter(word.strip(\(),.!?;:-[]{}…—).lower()forwordinwords)returnline_count,word_count,char_count,word_freqif__name____main__:main()代码质量评价结构清晰、异常处理齐全对FileNotFoundError/PermissionError都做了sys.exit(1)、词频统计做了大小写归一与标点清洗达到了直接可用的水平不是玩具代码。4.3 真实运行结果服务器实跑输出行数: 10 单词数: 83 字符数: 443 文件: sample.txt 出现频率最高的前 3 个单词: ------------------------------ 1. the 8 次 2. hello 5 次 3. is 5 次结论它不只是写出了代码而是真的跑通了、数据对得上“the” 出现 8 次、“hello” 5 次手动核对一致。这正是 agentic coding 区别于AI 补全的关键——闭环自验证。踩坑记录重要我最初用nohup ... 非登录 shell 跑 headless结果直接报错No provider configured并空手而归。原因是nohup子 shell 没继承登录环境atomcode找不到config.toml里的 provider。改用直接exec_command的登录 shell执行即恢复正常。教训headless 自动化脚本务必在登录 shell中运行或显式export HOME/root并保证config.toml可达。5. 远程 WebUI手机也能调项目服务端以 systemd 常驻atomcode webui --host 0.0.0.0 --port 13457启动日志会打印访问地址与 token请手动在浏览器打开http://172.16.0.3:13457/?token5314e1bb218a4a1d8ede7f6d31550363 ⚠️ 主地址为局域网 IP仅同一网络内的设备可访问公网访问请用隧道。 无 TLS凡能访问者凭 token 即可进入。 Warning: binding to non-loopback address 0.0.0.0. The daemon exposes sensitive endpoints (chat, file-edit, tool-execution). Ensure the network is trusted or use a reverse proxy with authentication.安全要点务必看0.0.0.0绑定 仅 token 保护、无 TLS意味着任何能连到你机器 13457 端口的人凭 token 即可读写文件、执行命令。正确做法不要裸奔到公网。用cloudflared/Tailscale等隧道或前面套一层带认证的 Nginx 反代 HTTPS。我当前是内网/隧道访问安全可控。6. 插件 / MCP / Hooks可扩展性是真家伙AtomCode 的可玩性不止于聊天写码还提供完整的扩展面能力命令说明插件市场atomcode plugin marketplace list管理插件源官方atomcode-plugins-official装插件atomcode plugin install atomcode-workflowsatomcode安装工作流技能包MCPatomcode mcp add name -- command args接入 stdio 型 MCP server扩展工具集Hooksatomcode hooks list/test生命周期钩子可自动化前置/后置动作卸载atomcode uninstall清理二进制与数据官方插件市场我服务器上已同步含三大类atomcode-workflows/plan/review/debug/brainstorm四个高频技能驱动先规划再写码、写完整自审、失败自调试。commit-craft提交信息生成类技能。git-worktree基于 git worktree 的隔离实验环境/worktree命令 worktree-runneragent。这些让 AtomCode 从会写代码的助手升级成带流程纪律的编码搭档。7. 使用建议与小结经过一周实际部署与多次编码验证我的结论开源 免费 Token 是真福利。AtomGit CodingPlan 额度对脚本/运维/Demo 场景够用零成本上手。headless 模式是云服务器最美用法。把写码验证任务丢上去自己睡觉/开会回来拿结果。自动更新省心。4.26→5.0 无感升级运维负担低rollback兜底。安全别马虎。WebUI 暴露公网务必加 TLS 反向代理不要裸 token。扩展面完整。plugins / MCP / hooks 让它能嵌进你的工程流程而不只是玩具。如果你也常需要在服务器上临时搓个小工具“改个脚本跑一下”AtomCode 值得装一台常驻——把重复劳动交给它把脑子留给真正难的问题。附本文实测命令速查# 安装curl-fsSLhttps://raw.atomgit.com/atomgit_atomcode/atomcode/raw/main/scripts/install.sh|sh# 登录领取免费 CodingPlan 模型atomcode login# 版本 / 状态 / 升级atomcode--versionatomcode status atomcode upgrade# headless 自动编码登录 shell 内执行cd项目目录atomcode-y-C项目目录-p你的需求描述# 常驻 WebUI建议用 systemd 隧道/反代atomcode webui--host0.0.0.0--port13457注安装脚本与模型 API 地址以 AtomGit 官方最新文档为准文中为作者实测时的取值。作者已登录 AtomGit 账号 cpyaxjq本文涉及的免费模型额度来自 CodingPlan 活动。
