斜杠命令
在 TUI 输入框中以 / 开头即可触发命令,并获得自动补全菜单。按功能分类的 50+ 个内置命令如下;Skills 和 Plugin 加载的命令也会自动出现在补全菜单里。
核心功能
| 命令 | 作用 |
|---|
/login | 推荐 — 一条命令完成 AtomGit OAuth + 申领 CodingPlan 免费额度 + 自动根据额度模型列表写好 provider 配置。首次启动最省事的入口;已登录后重跑会幂等地同步最新模型列表。v4.25.0 起 /codingplan 已折进 /login,旧入口已移除 |
/resume | 打开会话选择器,恢复任意一个之前的持久化会话(含消息、目录和模型状态) |
/session | 创建一个全新的、干净的会话 |
/bg | 将当前会话放到后台并打开新的前台会话;子命令: /bg list、/bg <N>、/bg drop <N>、/bg help。详见 后台会话 |
/background <task> | 兼容入口:在一个 /bg 槽位中启动一次性后台任务(详解) |
/rename <新名字> | 重命名当前会话(影响 /resume 选择器里的显示名) |
/provider | 打开 provider 管理界面,增删改切换 |
/model | 在当前 provider 下切换模型,或跨 provider 切换 |
/cd | 切换工作目录,并写回 default_workdir。也可以直接输入 cd /path(无需斜杠前缀) |
工具与实用操作
| 命令 | 作用 |
|---|
/view <文件路径> | 以只读浮层打开文件内容（支持方向键翻页、PageUp/Down、g/G 跳转到首/末行） |
/undo · /undo N | 把对话记忆回退到上一轮(或第 N 轮)之前,并把那一轮的 prompt 还原回输入框;只回退记忆,不恢复磁盘文件 |
/diff | 显示当前工作目录未提交改动的 git diff |
/review | 对当前改动做代码审查:/review 审查未提交改动,/review staged 审查暂存区,/review <base> 对比某个基准 ref |
/paste | 从剪贴板粘贴图片(Windows 下 Ctrl+V 被终端拦截时的备用入口) |
/cost | 展示当前会话输出 token 数。不支持 usage 报告的 API 会自动估算 |
/context | 显示本轮上下文预算分解:系统提示、工具定义、冷区压缩、总消息数、context window 占用 |
/compact | 压缩历史消息,把早期对话压缩成摘要以腾出上下文预算 |
/clear | 清空当前会话的消息(保留工作目录和模型) |
/init | 扫描当前工作目录,生成 / 刷新 .atomcode.md 项目指令文件 — 内含 build / test 命令、技术栈摘要、目录结构等,后续每次启动都会作为系统提示注入 |
/background <任务> | 把任务派发给一个隔离的后台 agent(只读为主的工具子集),不污染当前主对话上下文。用于"顺手让它去查一下 X"这类轻探索。详见 后台会话 |
/worktree <子命令> | Git worktree 隔离:create 在新分支上拉一份独立 worktree、list 查看现有 worktree、done 把 worktree 改动 squash 回主分支、cleanup 清理已完成的 worktree |
/issue | 交互式向导:在当前 git 仓库对应的 AtomGit 仓库创建一个新 issue(需先 OAuth 登录,cwd 必须是 atomgit.com 仓库的 clone) |
/todo | 重新打印当前待办清单 —— 从会话记录里派生(定位最近一次 todowrite 工具调用并重渲染),带「进行中 / 已完成」状态标记。清单是无状态派生的,不额外落盘;模型执行长任务时会自己维护它,你也可以随时用此命令查看进度 |
/copy | 把上一条回复里的代码块复制到剪贴板:/copy 复制唯一代码块、/copy N 复制第 N 个、/copy all 复制全部代码块、/copy msg 复制整条回复的 markdown 原文 |
/save | 把当前会话导出成 markdown 文件:/save 用自动生成的文件名,/save <文件名> 指定文件名 |
对话模式与思考
| 命令 | 作用 |
|---|
/plan | 切到 Plan 模式:只读探索,模型可以调用 read_file / grep / list_directory 等不写盘的工具,但 edit_file / bash 等会被屏蔽。适合在动手之前让模型先理清方案 |
/build | 切回 Build 模式(默认):全部工具可用,可以读、写、执行。/plan 和 /build 之间可随时来回切 |
/goal <目标> | 设定一个完成目标,让 agent 自动循环——一轮接一轮——直到目标达成。/goal(无参数)查看当前目标与轮数,/goal clear 停止 |
/loop <间隔> <prompt 或 /命令> | 按固定间隔重复执行一个 prompt 或斜杠命令。例 /loop 5m /diff 每 5 分钟跑一次 /diff;/loop 30s 检查一下构建 每 30 秒发一次该 prompt。间隔单位 s/m/h,范围 10s–24h |
/loop <prompt> | 不带间隔时进入自定节奏模式:任务交给模型,由它自己决定何时进行下一轮,适合「盯着某件事直到收敛」这类不好用固定周期表达的任务 |
/loop · /loop stop | /loop(无参数)查看当前循环状态;/loop stop(或 off / clear / cancel)停止循环。/loop 与 /goal 互斥,设定其中一个会自动取消另一个 |
/think on / off | 开关 extended thinking(对支持的模型 — Claude / DeepSeek-R1 / GLM-4.5 等)。开启后模型会输出推理过程,代价是更慢更费 token |
/think budget <N> | 给 thinking 设个 token 预算上限(对 Claude 系列生效),控制推理长度 |
/effort <high|max|off> | DeepSeek 推理努力控制——在 DeepSeek 模型上用更多延迟/token 换取更深的推理 |
永久记忆
| 命令 | 作用 |
|---|
/remember <内容> | 记一条到项目级记忆(默认作用域,绑定当前工作目录) |
/remember --global <内容> | 记一条到全局记忆(所有项目共享) |
/forget <关键词> | 删除全局 + 项目记忆中含该关键词的所有条目(大小写不敏感) |
/memory | 查看当前生效的所有记忆,按 [Global] / [Project] 分组 |
详细使用与最佳实践见 永久记忆。
扩展生态
| 命令 | 作用 |
|---|
/setup | 第一次执行时,把内置的 atomcode-automation-recommender skill 解压到 ~/.atomcode/skills/,在项目 .gitignore 追加 .atomcode/local/,并写 .atomcode/setup-state.json(signals 哈希 + atomcode 版本 + 已安装列表),全程持项目级锁。然后自动调用 recommender skill — 它会扫描项目(语言、框架、已有 hook 等)、联网检索并推荐适合该代码库的其他 atomcode skill 安装。后续执行会跳过 seed 安装、直接重跑 skill。命令后跟的文字会作为 steering 传给 skill,例如 /setup 重点关注测试。CLI 形式 atomcode setup --force 会按内容哈希强制重装 seed 文件 |
/skills | 浏览当前已加载的 skills(项目级 + 用户级)。每个 skill 也会以独立的斜杠命令形式出现在补全菜单里,可以直接 /<skill-name> 触发 |
/plugin | 打开交互式插件管理器,可浏览 marketplace、安装/卸载插件、添加/移除 marketplace |
/plugin marketplace add|remove|update|list | 管理 marketplace 注册(add 克隆 git 仓库,remove 移除,update 拉最新,list 列出) |
/plugin install <plugin>@<marketplace> | 从指定 marketplace 安装插件 |
/plugin uninstall <plugin>@<marketplace> | 卸载已安装的插件(保留 marketplace 注册) |
/plugin list | 列出本地已安装的插件 |
/plugin reload | 重新加载所有插件(扫描磁盘变更、刷新 skill/hook 注册) |
详细配置与使用见 Skills 扩展 和 Plugin 系统。
插件可以注册自己的斜杠命令。例如官方频道插件会新增 /wechat(显示 AtomCode 微信用户群二维码):
/plugin marketplace add https://atomgit.com/atomgit_atomcode/AtomCode-Channel
/plugin install weixin@atomcode-channel
MCP 集成
| 命令 | 作用 |
|---|
/mcp | 列出已成功连接的 MCP server 及其状态(连接失败的 server 不在此列表,只在会话区有红色错误行) |
/mcp tools <server> | 异步列出某个 MCP server 实际暴露的远端 tools(若超时/失败会提示) |
/mcp reload | 重新读取 .mcp.json / ~/.atomcode/mcp.json 并后台重连所有 server |
详细配置与使用见 MCP 集成。
WebUI 与同步
| 命令 | 作用 |
|---|
/webui | 启动浏览器界面并自动打开浏览器(默认绑定 127.0.0.1:13457,仅本机)。当前 TUI 会话会自动接入实时同步 |
/webui --host <addr> | 把服务绑定到指定地址;/webui lan 等价于 --host 0.0.0.0(暴露到局域网)。配合蒲公英虚拟 IP 可远程访问,见 远程访问指南 |
/webui stop | 关闭 webui 服务 |
/sync | 把当前 TUI 接入正在运行的 webui 会话(需先 /webui)。两端实时双向同步,多个浏览器 / 终端可同时围观同一会话 |
/sync off | 退出同步,回到独立会话 |
/app | 把当前会话通过官方中继暴露给 手机 App:终端里直接吐出一个二维码,用 App 扫码即可配对,在手机上实时查看并接管这段对话(与 /webui 同源共用同一段会话,双向实时同步;区别是不开浏览器、走中继而非局域网)。需先 /login 登录 |
/app stop | 停止 App 远程访问,断开中继并回到本地会话 |
详细见 WebUI 界面 与 远程访问指南。
配置与帮助
| 命令 | 作用 |
|---|
/status | 显示登录状态、当前 provider、模型、上下文预算、CodingPlan 用量和重置时间 |
/whoami | 显示当前 AtomGit 登录用户的用户名 / 邮箱 |
/config | 显示 ~/.atomcode/config.toml 的路径 |
/reload | 从磁盘热加载 ~/.atomcode/config.toml,不需要重启 atomcode 就能让外部修改(或另一个终端的 /login 带来的变更)生效 |
/proxy | 切换出站代理模式:跟随系统代理(默认)/ 指定固定代理 / 直连不走代理。适合公司代理网、需要强制走某个代理或强制直连等场景,选择会写回配置 |
/language | 切换界面语言:自动检测(LC_ALL / LANG)、English、或 简体中文。立即生效并写回 ~/.atomcode/config.toml |
/welcome | 重新打开 3 步首次启动向导(欢迎页 → 语言 → 接入方式)。会话非空时会先弹 y/N 二次确认,确认后清屏。语言和默认接入方式都可以从这里再调一次 |
/logout | 清除 AtomGit OAuth token |
/upgrade | 自动升级到最新版本;子命令 /upgrade rollback 回滚到上一个版本 |
/guide | 内置上手向导:/guide 列出可问的主题(快速开始、换模型、MCP、Skills、记忆、后台任务、上下文、快捷键、配置),/guide <主题> 直接在对话里讲解(首次会自动安装 atomcode-skills 插件) |
/help | 展示所有可用斜杠命令的列表 |
/keys | 展示键盘快捷键参考(分组列出输入 / 历史 / 会话 / 弹层导航,并标注 Shift+Enter、Alt+Enter 在不同终端的兼容性)。详见 键盘快捷键 |
/quit · /exit | 退出 atomcode(也可以连按两次 Ctrl+C) |
命令使用技巧
- 自动补全 —— 输入
/ 后会立刻弹出补全菜单,用 ↑↓ 选择,Tab / Enter 确认。
- 模糊匹配 —— 补全支持子串匹配,比如输入
/prov 就能命中 /provider。
- 打断正在进行的操作 —— 模型正在流式输出时按
Esc 可以打断,然后再输入新的命令或 prompt。
- Skills 也会出现在菜单里 —— 当你在 Skills 目录中添加了自定义命令后,它们会以相同格式出现在补全菜单里。
典型工作流
第一次启动 — 一键接入
> /login
✔ Logged in as alice (alice, alice@example.com)
✔ CodingPlan claimed — CodingPlan Free · expires 2026-05-22 (29d / 30d)
✔ 3 models registered as AtomGit-* providers
✔ Default provider set to AtomGit-GLM
> 你好
做完一件事前把成本看一眼
> 重构 src/db 使用连接池
... (AI 执行)
> /cost
Session token usage
- Total output tokens: 8342
- Current turn tokens: 2156
- Context: 42K / 128K
问歪了就回退重问
> 给所有函数加 JSDoc
... (回复跑偏了)
> /undo
已回退到第 3 轮(共 3 轮)。
⚠ 仅回滚了对话记忆,磁盘文件未恢复。如需还原代码,请手动处理或用 /diff 查看。
(刚才那条 prompt 已还原到输入框,可改完重发)
模型表现不好换一个再试
> /model
> (在弹出的菜单里选择 claude-opus-4-6)
> 再试一次,这次注意保留原有注释
下一步
- 快捷键 —— 命令和快捷键配合使用效率翻倍
- 会话与撤销 ——
/resume、/undo、/compact 的详细行为
