
文章目录每日一句正能量一、写在前面你不需要害怕终端二、AtomCode 是什么一句话说清楚三、第一步安装0-5 分钟3.1 确认你的电脑3.2 打开终端3.3 执行安装命令四、第二步首次配置5-10 分钟4.1 运行 AtomCode4.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.md7.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/11LinuxUbuntu、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! Lets get you set up. Choose your LLM provider: [1] DeepSeek (推荐国内访问稳定) [2] OpenAI [3] Claude (Anthropic) [4] 通义千问 (阿里云) [5] GLM (智谱 AI) [6] Ollama (本地运行无需联网) [7] Configure manually4.2 选择模型提供商如果你已经有 AI 平台的账号和 API Key选择对应的提供商即可。如果你是纯新手推荐选择 DeepSeek选项 1或Ollama选项 6DeepSeek国内访问稳定价格便宜注册简单访问 deepseek.com 注册即可Ollama完全本地运行不需要 API Key不需要联网但对你的电脑配置有一定要求建议 16GB 内存以上4.3 获取 API Key以 DeepSeek 为例如果你选择了需要 API Key 的提供商向导会提示你输入。API Key 相当于你的身份凭证让 AI 服务知道是谁在调用它。获取步骤打开浏览器访问 platform.deepseek.com注册账号用手机号或邮箱进入API Keys页面点击创建 API Key复制生成的长串字符类似sk-abc123def456...回到终端粘贴这串字符按回车。4.4 完成配置向导会询问几个简单的问题比如是否启用分析数据收集选否即可然后你会进入 AtomCode 的主界面——一个漂亮的终端 UI。恭喜配置完成。你现在站在了一个全新开发方式的起点上。五、第三步第一个自然语言任务10-20 分钟这是最关键的一步你要亲身体验说人话就能写代码的感觉。5.1 进入你的项目目录在终端里用cd命令进入你想让 AtomCode 帮忙的代码项目。如果你还没有项目可以创建一个测试目录mkdir~/my-first-atomcode-projectcd~/my-first-atomcode-project然后在这个目录下启动 AtomCodeatomcode为什么要在项目目录里启动因为 AtomCode 需要读取你项目里的代码文件才能理解上下文并做出准确的修改。5.2 发出你的第一个指令在 AtomCode 的输入框里底部闪烁光标处输入帮我创建一个简单的 Python 脚本实现一个待办事项管理器支持添加、列出和删除任务数据保存在本地 JSON 文件中按回车。然后观察屏幕上发生的事情规划阶段AtomCode 会分析你的需求列出它打算做的事情比如创建 todo.py 文件、实现 add_task 函数等确认请求当它准备执行某些操作比如写入文件、运行命令时会弹出一个确认提示询问你是否允许执行阶段你确认后它会自动创建文件、编写代码验证阶段它可能会自动运行代码测试是否正常工作5.3 学会与 AI 对话在 AtomCode 里你和 AI 的对话是连续的。你可以基于上一步的结果继续提问给待办事项加上优先级功能高优先级任务显示在前面帮我把这个脚本改成命令行工具支持子命令 add/list/remove为这个项目写一个 README 文件说明如何使用核心原则说目标不说步骤。你不需要告诉它打开文件 A在第 15 行插入代码 B。你只需要说我要什么它会自己规划怎么做。六、第四步安全使用与回滚20-25 分钟6.1 权限确认机制AtomCode 有一个非常重要的安全设计任何可能修改你代码或系统的操作都需要你的确认。当 AtomCode 想要创建/修改/删除文件执行终端命令比如npm install、python test.py访问网络它都会停下来问你“我打算做 X你同意吗”你的选项通常是y或Enter确认执行n拒绝跳过这个操作a批准所有后续同类操作适合批量任务d查看详细差异后再决定新手建议前几次使用都选择逐个确认按y直到你熟悉它的行为模式。6.2 /undo你的后悔药如果 AtomCode 的修改不符合预期或者你只是想回退到之前的状态输入/undoAtomCode 会撤销最近一次会话中的所有文件变更。这是原子级的回滚——要么全部撤销要么保持现状不会出现改了一半的尴尬局面。如果你不确定某个修改是否安全可以先在 Git 仓库里使用 AtomCode。这样即使/undo不够用你还可以用git diff查看变更用git checkout彻底回退。6.3 /help你的随身手册忘记命令了随时输入/helpAtomCode 会列出所有可用的斜杠命令和快捷键。七、第五步进阶一小步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-reviewAtomCode 会按照内置的代码审查 Skill自动检查你的代码质量。你也可以创建自己的 Skill但这属于进阶内容今天先了解它的存在即可。7.3 下一步学习建议30 分钟过去了你已经完成了从安装到实际使用的全过程。以下是推荐的学习路径阶段目标时间本周每天用 AtomCode 完成一个小任务改 Bug、写测试、重构代码每天 15 分钟第二周学习 Headless 模式尝试在脚本中调用 AtomCode2 小时第三周创建自定义 Skill固化团队工作流3 小时持续关注 AtomCode 开源社区参与讨论和贡献长期八、常见问题速查QAtomCode 会偷走我的代码吗A不会。AtomCode 是开源软件代码在本地运行。只有当你选择需要联网的 AI 模型时代码片段才会被发送到对应的 AI 服务如 DeepSeek、OpenAI。如果你选择 Ollama 本地模型代码完全不会离开你的电脑。Q我没有 API Key能用吗A可以。选择 Ollama 作为 Provider在本地运行开源模型如 Llama 3、Qwen 2.5完全免费且无需联网。QAtomCode 和 Cursor、GitHub Copilot 有什么区别ACursor 和 Copilot 是在你写代码时提供建议AtomCode 是你描述需求它自动执行。前者是辅助后者是代理。Q修改错了怎么恢复A输入/undo回滚最近一次会话的变更。如果已经退出 AtomCode可以用 Git 回退。Q支持中文吗A完全支持。界面、对话、代码注释都可以使用中文。九、结语你已经跨过了那道门槛30 分钟前你可能对终端感到陌生对 AI 编码工具充满好奇又略带忐忑。现在你已经✅ 成功安装并配置了 AtomCode✅ 用自然语言完成了第一个编程任务✅ 理解了权限确认和安全回滚机制✅ 知道了如何让 AtomCode 更懂你的项目自然语言驱动开发不是未来而是现在。AtomCode 让说人话成为写代码的合法方式。你不需要成为命令行专家不需要背诵复杂的语法只需要清晰地表达你的意图。打开终端输入atomcode开始你的下一段对话吧。转载自https://blog.csdn.net/sghtgjfhv/article/details/163862821欢迎 点赞✍评论⭐收藏欢迎指正