前几天看到 AtomCode 的介绍——开源、免费 Token、不需要翻墙、支持国产大模型——第一反应是：这是真的吗？
于是我就试了。结果发现……是真的。而且比我预期的还好用。
这篇文章就是写给"和我一样的新手"的：不需要你懂 Rust，不需要你是大厂工程师，只需要 30 分钟，你就能让 AI 在你的项目里自己读代码、改代码、跑测试。
AtomCode 是什么？用大白话说
AtomCode 是一个住在你终端（命令行）里的 AI 编程助手。
你用自然语言跟它说"帮我修复这个登录 bug"，它就会：
全程你不用写一行代码，只需要用中文说清楚你要什么。
它的定位是 Claude Code / Cursor Agent 的国产开源替代品：
- 🆓 完全免费：通过 AtomGit 登录可白嫖 Token
- 🌍 无需翻墙：国内直连，接入 DeepSeek、通义千问等国产模型
- 📦 超轻量：基于 Rust 构建，安装包不到 50MB
- 🔓 MIT 开源：代码完全公开，100% 由 AI 生成（是的，这个工具本身也是 AI 写的）
第一步：安装（约 3 分钟）
macOS / Linux / 鸿蒙 PC
打开终端，粘贴这一行命令，回车：
curl -fsSL https://atomgit.com/atomgit_atomcode/atomcode/raw/main/install.sh | sh
脚本会自动下载适合你系统的版本，放到 ~/.local/bin/atomcode。
Windows
打开 PowerShell，粘贴：
irm https://atomgit.com/atomgit_atomcode/atomcode/raw/main/install.ps1 | iex
验证安装成功
atomcode –version
能看到版本号就代表安装成功了。
提示：如果提示"找不到命令"，需要把 ~/.local/bin 加入 PATH 环境变量。不懂怎么加？直接问 AtomCode 本身：atomcode -p "如何把 ~/.local/bin 加入 PATH，我用的是 macOS"
第二步：登录 / 配置模型（约 5 分钟）
在终端输入 atomcode，第一次运行会启动一个配置向导：
Welcome to AtomCode! Let's set up your first provider.
Select provider:
[1] Claude (Anthropic)
[2] OpenAI
[3] OpenAI Compatible (DeepSeek, Qwen, Zhipu, Moonshot…)
[4] Ollama (local)
方案 A：AtomGit OAuth 一键登录（最省事，免费 Token）
选任意 provider 后，在 TUI 界面里输入：
/login
会跳转到浏览器，用 AtomGit 账号授权。授权完成后，AtomCode 自动配置好，不需要你手动填 API Key。
方案 B：自己的 API Key（用国产模型）
选 [3] OpenAI Compatible，然后按提示填写：
API Key: sk-你的deepseek密钥
Base URL: https://api.deepseek.com/v1
Model: deepseek-chat
DeepSeek V3 比较便宜，日常使用成本极低，推荐新手用这个。
第三步：试跑第一个任务（约 5 分钟）
找一个你自己的项目目录，或者随便新建一个测试文件夹：
mkdir my-test-project
cd my-test-project
echo "print('hello')" > hello.py
atomcode
进入 AtomCode 的 TUI 界面后，用中文输入你的需求：
> 看一下这个项目里有什么文件，然后把 hello.py 里的英文注释换成中文，再加一个打印当前时间的函数
然后看着它自己动起来——读文件、理解代码、修改、保存——全程自主完成。
核心功能速览（新手最常用的几个）
1. 自主多步执行
这是 AtomCode 最厉害的地方：你不需要一步步指导它，只需要说清楚目标，它会自己规划步骤并执行。
> 帮我分析这个 Python 项目的目录结构，找出所有 TODO 注释，然后把它们整理成一个 todo.md 文件
它会：自己找文件 → 读内容 → 提取 TODO → 生成文档，一气呵成。
2. /undo 反悔键
改错了？不要慌。在 TUI 里输入：
/undo
AtomCode 会撤销上一次的修改。这是新手的保命功能，大胆让它改，改坏了就 undo。
3. 持久化会话
关闭了终端也不用怕，对话历史都保存着。下次想继续：
atomcode –continue
# 或者简写：
atomcode -c
4. headless 一次性模式
不想打开 TUI，只想快速跑一个任务？用 -p 参数：
atomcode -p "简要介绍一下当前目录的项目结构"
结果直接输出到终端，非常适合放进脚本里自动化。
5. 斜杠命令速查
在 TUI 里输入 / 会弹出命令补全，常用的有：
| /model | 切换大模型 |
| /provider | 切换 provider |
| /undo | 撤销上次修改 |
| /diff | 查看代码改动 |
| /cost | 查看本次会话花了多少 Token |
| /clear | 清空对话上下文 |
| /compact | 压缩上下文（省 Token） |
| /resume | 恢复历史会话 |
实战演练：用 AtomCode 修一个 bug
下面用一个真实场景来演示完整流程。
背景：我有一个 Flask 写的小工具，用户登录后总是被重定向到 404 页面，我不知道哪里出了问题。
在终端里：
cd ~/my-flask-app
atomcode
我说：
> 帮我排查一下用户登录后被重定向到 404 的 bug。
主要逻辑在 auth.py 和 routes.py 里。
AtomCode 的操作过程（我看着它自动执行）：
[read_file] auth.py
[read_file] routes.py
[grep] 搜索 redirect 相关代码
[read_symbol] login_redirect 函数定义
…
[分析] 发现 login_redirect 中 url_for 参数拼写错误：
'dashboard' → 应为 'main.dashboard'
[edit_file] 修正 auth.py 第 42 行
[bash] python -m pytest tests/test_auth.py
✓ 测试通过
AtomCode 说：
找到问题了。auth.py 第 42 行的 url_for('dashboard') 应该是 url_for('main.dashboard')，因为你的 dashboard 路由注册在 main Blueprint 下。已修复，测试通过。
总用时：约 45 秒。我一行代码没动。
使用建议：让 AtomCode 发挥最大效果
1. 说清楚验收标准
模糊："帮我优化这段代码"
清晰："帮我优化 utils.py 里的 parse_data 函数，要求：(1) 处理空值不抛异常；(2) 不改变函数签名；(3) 跑通现有测试"
2. 配合 Git 使用
每次让 AtomCode 做大改动之前，先 git commit 一下。这样就算 /undo 不够用，也可以 git checkout 回来。
3. 先做代码图谱分析
第一次在大项目里用，先让它做个全局了解：
> 帮我分析一下这个项目的整体架构，主要模块有哪些，各自负责什么
后续的任务会更准确。
4. 善用 .atomcode.md
在项目根目录创建 .atomcode.md，写上你的项目规范，比如：
# 项目规范
– 使用 Python 3.10+
– 所有函数必须有类型注解
– 代码风格遵循 PEP8
– 禁止使用 var 关键字（前端部分）
– 测试文件放在 tests/ 目录
AtomCode 每次启动都会自动读取，省去每次重复说明规则的麻烦。
总结
如果你是编程新手，或者是想提升效率的开发者，AtomCode 值得一试：
- 安装：一条命令搞定，不到 3 分钟
- 上手：用中文说需求，不需要学特殊语法
- 成本：免费 Token 起步，国产模型接力
- 安全：有撤销、有确认、有 Git 兜底
从 0 到第一个任务完成，真的只需要 30 分钟。剩下的，就是用中文跟 AI 说你想要什么。
开源仓库：https://atomgit.com/atomgit_atomcode/atomcode
官方文档：https://atomcode.atomgit.com/docs/zh/
