AtomCode 使用指南

住在终端里的 AI 编码助手。给它一个自然语言任务，它会自主读取、编辑、运行并自我验证。本文档带你从零开始，逐步掌握 AtomCode 的每一项能力。

三步开始

  1. 安装 —— 一条 curl 命令或者从源码构建，参见 快速开始。
  2. 登录或配置模型 —— AtomGit OAuth 一键登录最省事，也支持任意 OpenAI 兼容 API Key，参见 登录方式 和 配置文件。
  3. 开始提问 —— 在项目目录下运行 atomcode，用自然语言描述你的任务即可。
Tip

如果只是想快速体验，跑一条命令即可：atomcode -p "简要介绍一下这个仓库"。这是 headless 模式，一次性执行并把结果输出到 stdout。

文档导览

快速开始

安装方式、首次运行欢迎界面、完成第一个任务。

配置文件

~/.atomcode/config.toml 字段说明，以及各家 provider 的配置示例。

登录方式

AtomGit OAuth 一键登录(自动持久化)与 API Key 配置对比。

基本使用

如何描述任务、常用 CLI 参数、文件引用与多行输入。

斜杠命令

17 个内置斜杠命令参考表,涵盖会话、模型、撤销、Issue 等操作。

快捷键

输入、导航、选区复制等全部 TUI 快捷键。

内置工具

21 个内置工具:文件/Shell、代码图谱、Web、自动化分类说明。

会话与撤销

持久化会话恢复、/undo 回滚、清空与压缩上下文。

项目指令文件

用 .atomcode.md 给 AtomCode 定制项目级规范。

Skills 扩展

编写用户自定义 skill,扩展斜杠命令生态。

常见问题

安装、连不上模型、权限确认、上下文超限等常见疑问解答。

反馈与参与

AtomCode 是开源项目,欢迎提交 issue 或 PR: