新手友好:30 分钟上手 AtomCode 完全指南——从“终端恐惧“到“自然语言驱动开发“
2026/8/22 11:36:01 网站建设 项目流程

文章目录

    • 每日一句正能量
    • 一、写在前面:你不需要害怕终端
    • 二、AtomCode 是什么?一句话说清楚
    • 三、第一步:安装(0-5 分钟)
      • 3.1 确认你的电脑
      • 3.2 打开终端
      • 3.3 执行安装命令
    • 四、第二步:首次配置(5-10 分钟)
      • 4.1 运行 AtomCode
      • 4.2 选择模型提供商
      • 4.3 获取 API Key(以 DeepSeek 为例)
      • 4.4 完成配置
    • 五、第三步:第一个自然语言任务(10-20 分钟)
      • 5.1 进入你的项目目录
      • 5.2 发出你的第一个指令
      • 5.3 学会与 AI 对话
    • 六、第四步:安全使用与回滚(20-25 分钟)
      • 6.1 权限确认机制
      • 6.2 /undo:你的后悔药
      • 6.3 /help:你的随身手册
    • 七、第五步:进阶一小步(25-30 分钟)
      • 7.1 项目指令文件:.atomcode.md
      • 7.2 Skills:可复用的工作流
      • 7.3 下一步学习建议
    • 八、常见问题速查
    • 九、结语:你已经跨过了那道门槛

每日一句正能量

面对生活的玩笑,我们应当给时间一点时间,因为时间相信的,唯有变化本身。
时间从不执着于某个状态,它只负责流动。困境会变,你也会变。把一部分交给时间,不是放弃,是知道有些改变需要它来参与。

如果你从未用过终端命令行,从未接触过 AI 编码工具,甚至对"API Key"这个词感到陌生——这篇文章就是为你写的。不需要任何前置知识,跟着做就行。

一、写在前面:你不需要害怕终端

很多新手看到"打开终端"四个字就退缩了。让我们先破除一个迷思:终端只是一个更直接的聊天窗口。你平时用微信打字发消息,终端也是打字发消息——只不过你的聊天对象是电脑本身。

AtomCode 的神奇之处在于,它把这个"聊天窗口"变成了一个能理解自然语言的智能助手。你不需要记住复杂的命令,不需要背诵语法,只需要像和同事说话一样告诉它你的需求。

接下来的 30 分钟,我们会完成五件事:安装 → 配置 → 做第一个任务 → 学会安全使用 → 了解进阶方向。每一步都有具体的命令,你可以直接复制粘贴。


二、AtomCode 是什么?一句话说清楚

想象你有一个24 小时在线的资深程序员同事。你告诉他:“帮我给这个登录功能加上密码强度校验”,然后他自动打开代码文件、分析现有逻辑、写出校验代码、运行测试确认没问题——全程不需要你动手写一行代码。

AtomCode 就是这个"同事"。它是 AtomGit 开源社区开发的 AI 编码智能体,运行在终端里,用纯 Rust 编写,速度极快。它支持多种 AI 模型(DeepSeek、OpenAI、Claude、通义千问、GLM 等),你可以根据自己的情况选择。

最重要的是:它是免费的(开源 MIT 协议),你的代码永远留在本地。


三、第一步:安装(0-5 分钟)

3.1 确认你的电脑

AtomCode 支持以下系统:

  • macOS 12 及以上
  • Windows 10/11
  • Linux(Ubuntu、Debian、CentOS 等主流发行版)
  • 鸿蒙 PC 版

3.2 打开终端

macOS/Linux:按Command + 空格(或Ctrl + Alt + T在 Linux 上),输入terminal回车。

Windows:按Win + R,输入cmd回车;或者安装 Windows Terminal(推荐,微软商店可下载)。

你会看到一个黑底白字(或白底黑字)的窗口,里面有一个闪烁的光标。这就是终端。

3.3 执行安装命令

把下面这行命令复制到终端里,按回车:

curl-fsSLhttps://atomcode.atomgit.com/install.sh|sh

这行命令在做什么?简单来说,它从 AtomCode 的官方网站下载一个安装脚本,然后自动执行。整个过程大约需要 1-3 分钟,取决于你的网络速度。

安装完成后,你会看到类似这样的提示:

✓ AtomCode installed successfully! Run 'atomcode --version' to verify.

验证安装:

atomcode--version

如果看到版本号(比如atomcode 5.0.6),说明安装成功。

如果安装失败怎么办?最常见的原因是网络问题。如果你在国内,可以尝试使用 AtomGit 的镜像源,或者检查你的网络连接。


四、第二步:首次配置(5-10 分钟)

4.1 运行 AtomCode

在终端里输入:

atomcode

第一次运行会进入一个友好的配置向导。你会看到类似这样的界面:

Welcome to AtomCode! Let's get you set up. Choose your LLM provider: [1] DeepSeek (推荐,国内访问稳定) [2] OpenAI [3] Claude (Anthropic) [4] 通义千问 (阿里云) [5] GLM (智谱 AI) [6] Ollama (本地运行,无需联网) [7] Configure manually

4.2 选择模型提供商

如果你已经有 AI 平台的账号和 API Key,选择对应的提供商即可。

如果你是纯新手,推荐选择 DeepSeek(选项 1)或Ollama(选项 6):

  • DeepSeek:国内访问稳定,价格便宜,注册简单(访问 deepseek.com 注册即可)
  • Ollama:完全本地运行,不需要 API Key,不需要联网,但对你的电脑配置有一定要求(建议 16GB 内存以上)

4.3 获取 API Key(以 DeepSeek 为例)

如果你选择了需要 API Key 的提供商,向导会提示你输入。API Key 相当于你的"身份凭证",让 AI 服务知道是谁在调用它。

获取步骤:

  1. 打开浏览器,访问 platform.deepseek.com
  2. 注册账号(用手机号或邮箱)
  3. 进入"API Keys"页面
  4. 点击"创建 API Key"
  5. 复制生成的长串字符(类似sk-abc123def456...

回到终端,粘贴这串字符,按回车。

4.4 完成配置

向导会询问几个简单的问题(比如是否启用分析数据收集,选"否"即可),然后你会进入 AtomCode 的主界面——一个漂亮的终端 UI。

恭喜!配置完成。你现在站在了一个全新开发方式的起点上。


五、第三步:第一个自然语言任务(10-20 分钟)

这是最关键的一步:你要亲身体验"说人话就能写代码"的感觉。

5.1 进入你的项目目录

在终端里,用cd命令进入你想让 AtomCode 帮忙的代码项目。如果你还没有项目,可以创建一个测试目录:

mkdir~/my-first-atomcode-projectcd~/my-first-atomcode-project

然后在这个目录下启动 AtomCode:

atomcode

为什么要在项目目录里启动?因为 AtomCode 需要读取你项目里的代码文件,才能理解上下文并做出准确的修改。

5.2 发出你的第一个指令

在 AtomCode 的输入框里(底部闪烁光标处),输入:

帮我创建一个简单的 Python 脚本,实现一个待办事项管理器,支持添加、列出和删除任务,数据保存在本地 JSON 文件中

按回车。

然后,观察屏幕上发生的事情:

  1. 规划阶段:AtomCode 会分析你的需求,列出它打算做的事情(比如"创建 todo.py 文件"、"实现 add_task 函数"等)
  2. 确认请求:当它准备执行某些操作(比如写入文件、运行命令)时,会弹出一个确认提示,询问你是否允许
  3. 执行阶段:你确认后,它会自动创建文件、编写代码
  4. 验证阶段:它可能会自动运行代码测试是否正常工作

5.3 学会与 AI 对话

在 AtomCode 里,你和 AI 的对话是连续的。你可以基于上一步的结果继续提问:

给待办事项加上优先级功能,高优先级任务显示在前面
帮我把这个脚本改成命令行工具,支持子命令 add/list/remove
为这个项目写一个 README 文件,说明如何使用

核心原则:说目标,不说步骤。你不需要告诉它"打开文件 A,在第 15 行插入代码 B"。你只需要说"我要什么",它会自己规划"怎么做"。


六、第四步:安全使用与回滚(20-25 分钟)

6.1 权限确认机制

AtomCode 有一个非常重要的安全设计:任何可能修改你代码或系统的操作,都需要你的确认。

当 AtomCode 想要:

  • 创建/修改/删除文件
  • 执行终端命令(比如npm installpython test.py
  • 访问网络

它都会停下来问你:“我打算做 X,你同意吗?”

你的选项通常是:

  • yEnter:确认执行
  • n:拒绝,跳过这个操作
  • a:批准所有后续同类操作(适合批量任务)
  • d:查看详细差异后再决定

新手建议:前几次使用都选择逐个确认(按y),直到你熟悉它的行为模式。

6.2 /undo:你的后悔药

如果 AtomCode 的修改不符合预期,或者你只是想回退到之前的状态,输入:

/undo

AtomCode 会撤销最近一次会话中的所有文件变更。这是原子级的回滚——要么全部撤销,要么保持现状,不会出现"改了一半"的尴尬局面。

如果你不确定某个修改是否安全,可以先在 Git 仓库里使用 AtomCode。这样即使/undo不够用,你还可以用git diff查看变更,用git checkout彻底回退。

6.3 /help:你的随身手册

忘记命令了?随时输入:

/help

AtomCode 会列出所有可用的斜杠命令和快捷键。


七、第五步:进阶一小步(25-30 分钟)

7.1 项目指令文件:.atomcode.md

在你的项目根目录创建一个名为.atomcode.md的文件:

# 用你喜欢的编辑器创建文件,比如:touch.atomcode.md

然后写入你的项目信息:

# 项目说明 这是一个 Python 命令行工具项目。 ## 技术栈 - Python 3.10+ - 使用标准库,不依赖第三方包 - 代码风格遵循 PEP 8 ## 常用命令 - 运行:python main.py - 测试:python -m pytest

保存后,AtomCode 会在每次对话时自动读取这个文件,把它作为背景知识。这意味着你不需要每次都告诉它"我们用 Python 3.10"——它自己就知道。

7.2 Skills:可复用的工作流

AtomCode 支持"Skills"——预定义的工作流模板。比如输入:

/code-review

AtomCode 会按照内置的代码审查 Skill,自动检查你的代码质量。

你也可以创建自己的 Skill,但这属于进阶内容,今天先了解它的存在即可。

7.3 下一步学习建议

30 分钟过去了,你已经完成了从安装到实际使用的全过程。以下是推荐的学习路径:

阶段目标时间
本周每天用 AtomCode 完成一个小任务(改 Bug、写测试、重构代码)每天 15 分钟
第二周学习 Headless 模式,尝试在脚本中调用 AtomCode2 小时
第三周创建自定义 Skill,固化团队工作流3 小时
持续关注 AtomCode 开源社区,参与讨论和贡献长期

八、常见问题速查

Q:AtomCode 会偷走我的代码吗?
A:不会。AtomCode 是开源软件,代码在本地运行。只有当你选择需要联网的 AI 模型时,代码片段才会被发送到对应的 AI 服务(如 DeepSeek、OpenAI)。如果你选择 Ollama 本地模型,代码完全不会离开你的电脑。

Q:我没有 API Key,能用吗?
A:可以。选择 Ollama 作为 Provider,在本地运行开源模型(如 Llama 3、Qwen 2.5),完全免费且无需联网。

Q:AtomCode 和 Cursor、GitHub Copilot 有什么区别?
A:Cursor 和 Copilot 是"在你写代码时提供建议",AtomCode 是"你描述需求,它自动执行"。前者是辅助,后者是代理。

Q:修改错了怎么恢复?
A:输入/undo回滚最近一次会话的变更。如果已经退出 AtomCode,可以用 Git 回退。

Q:支持中文吗?
A:完全支持。界面、对话、代码注释都可以使用中文。


九、结语:你已经跨过了那道门槛

30 分钟前,你可能对终端感到陌生,对 AI 编码工具充满好奇又略带忐忑。现在,你已经:

  • ✅ 成功安装并配置了 AtomCode
  • ✅ 用自然语言完成了第一个编程任务
  • ✅ 理解了权限确认和安全回滚机制
  • ✅ 知道了如何让 AtomCode 更懂你的项目

自然语言驱动开发不是未来,而是现在。AtomCode 让"说人话"成为写代码的合法方式。你不需要成为命令行专家,不需要背诵复杂的语法,只需要清晰地表达你的意图。

打开终端,输入atomcode,开始你的下一段对话吧。


转载自:https://blog.csdn.net/sghtgjfhv/article/details/163862821
欢迎 👍点赞✍评论⭐收藏,欢迎指正

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询