前几天看到 AtomCode 的介绍——开源、免费 Token、不需要翻墙、支持国产大模型——第一反应是：这是真的吗？

于是我就试了。结果发现……是真的。而且比我预期的还好用。

这篇文章就是写给"和我一样的新手"的：不需要你懂 Rust，不需要你是大厂工程师，只需要 30 分钟，你就能让 AI 在你的项目里自己读代码、改代码、跑测试。

---

AtomCode 是什么？用大白话说

AtomCode 是一个住在你终端（命令行）里的 AI 编程助手。

你用自然语言跟它说"帮我修复这个登录 bug"，它就会：

1. 自己去读相关代码文件
2. 分析问题原因
3. 修改代码
4. 跑测试验证
5. 告诉你它做了什么

全程你不用写一行代码，只需要用中文说清楚你要什么。

它的定位是 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/