# atomcode 基本入门教程 常用命令 和功能

atomcode 基本入门教程 常用命令 和功能atomcode:ask 技能 UseSkillatomcode:ask参数: {“name”: “atomcode:ask”, “arguments”: “atomcode 使用技巧 — 如何高效使用 AtomCodeslash commands、MCP、hooks、skills、memory 等日常用法”}加载中文文档索引查找使用技巧相关内容。 ReadFiledocs-zh.json参数: {“file_path”: “C:\Users\yang\.atomcode\plugins\marketplaces/atomcode-skills/atomcode\./skills\ask/docs-zh.json”, “limit”: 300}输出: 1 [{“slug”:“index”,“title”:“使用指南”,“group”:“概览”,“lede”:住在终端里的 AI 编码助手。给它一个自然语言任务它会自主读取、编辑、运行并自我验…任务清单已全部完成。继续读取文档索引的其余内容。 ReadFiledocs-zh.json参数: {“file_path”: “C:\Users\yang\.atomcode\plugins\marketplaces/atomcode-skills/atomcode\./skills\ask/docs-zh.json”, “offset”: 2, “limit”: 100}输出: [no lines in requested range (start2, total1)]任务清单已全部完成。继续读取文档索引的剩余内容——这个文件是单行 JSON 被截断了我试着用更大范围读取。 ReadFiledocs-zh.json参数: {“file_path”: “C:\Users\yang\.atomcode\plugins\marketplaces/atomcode-skills/atomcode\./skills\ask/docs-zh.json”, “limit”: 1}输出: 1 [{“slug”:“index”,“title”:“使用指南”,“group”:“概览”,“lede”:住在终端里的 AI 编码助手。给它一个自然语言任务它会自主读取、编辑、运行并自我验…任务清单已全部完成。继续回答 atomcode 使用技巧问题——文档索引是单行 JSONread_file 会被截断我用 node 只读解析提取相关章节内容。 Bashnode -e const fsrequire(‘fs’);const docsJSON.parse(fs.readFileSync(‘C:/Users/yang/.atomcode/plugins/marketplaces/atomcode-skills/atomcode/./skills/ask/docs-zh.json’,‘utf8’));docs.forEach(pconsole.log(p.slug.padEnd(22),‘|’,p.title,‘|’,(p.sections||[]).length’ sections’));参数: {“command”: “node -e “\nconst fsrequire(‘fs’);\nconst docsJSON.parse(fs.readFileSync(‘C:/Users/yang/.atomcode/plugins/marketplaces/atomcode-skills/atomcode/./skills/ask/docs-zh.json’,‘utf8’));\ndocs.forEach(pconsole.log(p.slug.padEnd(22),‘|’,p.title,‘|’,(p.sections||[]).length’ sections’));\n””}输出: index | 使用指南 | 17 sections提取使用技巧相关的文档章节内容。 Bashnode -e const fsrequire(‘fs’);const docsJSON.parse(fs.readFileSync(‘C:/Users/yang/.atomcode/plugins/marketplaces/atomcode-skills/atomcode/./skills/ask/docs-zh.json’,‘utf8’));const want[‘basic-usage’,‘slash-commands’,‘sessions’,‘memory’,‘project-instructions’];docs.filter(pwant.includes(p.slug)).forEach(p{console.log(‘ ‘p.slug’ | ‘p.title’‘);p.sections.forEach(sconsole.log(’## ‘s.heading’\n’s.body‘\n’));}); 21 | head -300参数: {“command”: node -e \nconst fsrequire(‘fs’);\nconst docsJSON.parse(fs.readFileSync(‘C:/Users/yang/.atomcode/plugins/marketplaces/atomcode-skills/atomcode/./skills/ask/docs-zh.json’,‘utf8’));\nconst want[‘basic-usage’,‘slash-commands’,‘sessions’,‘memory’,‘project-instructions’];\ndocs.filter(pwant.includes(p.slug)).forEach(p{\n console.log(’‘p.slug’ | ‘p.title’ ’);\n p.sections.forEach(sconsole.log(‘## ‘s.heading’\n’s.body‘\n’));\n});\n 21 | head -300}输出: basic-usage | 基本使用 补充提取斜杠命令、会话、快捷键等使用技巧章节。 Bashnode -e const fsrequire(‘fs’);const docsJSON.parse(fs.readFileSync(‘C:/Users/yang/.atomcode/plugins/marketplaces/atomcode-skills/atomcode/./skills/ask/docs-zh.json’,‘utf8’));const want[‘slash-commands’,‘sessions’,‘keybindings’];docs.filter(pwant.includes(p.slug)).forEach(p{console.log(‘ ‘p.slug’ | ‘p.title’‘);p.sections.forEach(sconsole.log(’## ‘s.heading’\n’s.body‘\n’));}); 21 | head -280参数: {“command”: node -e \nconst fsrequire(‘fs’);\nconst docsJSON.parse(fs.readFileSync(‘C:/Users/yang/.atomcode/plugins/marketplaces/atomcode-skills/atomcode/./skills/ask/docs-zh.json’,‘utf8’));\nconst want[‘slash-commands’,‘sessions’,‘keybindings’];\ndocs.filter(pwant.includes(p.slug)).forEach(p{\n console.log(’‘p.slug’ | ‘p.title’ ’);\n p.sections.forEach(sconsole.log(‘## ‘s.heading’\n’s.body‘\n’));\n});\n 21 | head -280}输出: slash-commands | 斜杠命令 补充提取斜杠命令的剩余部分和快捷键章节。 FetchOutput参数: {“artifact_id”: “206ffa74bd343718”, “offset”: 4096, “limit”: 6000}输出: down 文件: /save 用自动生成的文件名, /save 文件名 指定文件名 AtomGit Issue 现在由内置工具处理 /issue 已移除。执行 /login 后直接用自然语…任务清单是上一轮 setup 的已全部完成。我再补抓一下快捷键章节然后给出完整的使用技巧总结。 Bashnode -e const fsrequire(‘fs’);const docsJSON.parse(fs.readFileSync(‘C:/Users/yang/.atomcode/plugins/marketplaces/atomcode-skills/atomcode/./skills/ask/docs-zh.json’,‘utf8’));const pdocs.find(xx.slug‘keybindings’);console.log(‘ ‘p.title’‘);p.sections.forEach(sconsole.log(’## ‘s.heading’\n’s.body‘\n’)); 21 | head -60参数: {“command”: node -e \nconst fsrequire(‘fs’);\nconst docsJSON.parse(fs.readFileSync(‘C:/Users/yang/.atomcode/plugins/marketplaces/atomcode-skills/atomcode/./skills/ask/docs-zh.json’,‘utf8’));\nconst pdocs.find(xx.slug‘keybindings’);\nconsole.log( ‘p.title’ ’);\np.sections.forEach(sconsole.log(‘## ‘s.heading’\n’s.body‘\n’));\n 21 | head -60}输出: 快捷键 已收集齐文档内容下面给出整理好的 AtomCode 使用技巧。AtomCode 使用技巧AtomCode 是住在终端里的 AI 编码助手掌握下面这些用法可以显著提升效率。1. 启动与常用 CLI 参数atomcode# 当前目录启动 TUIatomcode-C/path/to/project# 指定工作目录atomcode-c# 继续上一次会话--continueatomcode-p简要介绍一下这个仓库# 非交互模式一次性执行输出到 stdoutatomcode--providerclaude--modelclaude-sonnet-4-6# 临时覆盖模型atomcode --max-turns N# 限制 Agent 循环轮数防止无限跑atomcode-y# 跳过所有权限确认仅限 CI/沙箱等可信环境2. 描述任务的三条原则说目标不说步骤—— “修复登录后跳 404 的 bug”而不是打开 src/auth/callback.ts 删第 27 行点明约束—— “保持 API 兼容”、“不改动测试文件”、“用 TypeScript 而不是 JS”给出验证方式—— “改完后跑 npm test 确认通过”让模型完成自我验证闭环3. 高频斜杠命令50 个自动补全类别命令用途会话/login一条命令完成 OAuth 免费额度申领 自动配置 provider/resume恢复任意历史会话含消息、目录、模型状态/bg·/bg list把当前会话放后台开新前台最多 16 个并行槽位模型真在后台干活/background 任务一次性派发只读探索任务不污染主对话工具/undo N回退对话记忆到第 N 轮prompt 还原回输入框只回退记忆不动磁盘文件/diff·/review查看未提交改动 / 审查当前改动/context·/compact看上下文预算分解 / 压缩历史腾出空间模式/plan→/build只读探索模式 ↔ 全工具模式动手前先理清方案/goal 目标设定目标让 agent 自动循环直到达成/loop 5m /diff固定间隔重复执行命令s/m/h10s–24h记忆/remember 内容·/remember --global记项目级 / 全局记忆/memory·/forget 关键词查看 / 删除记忆扩展/skills·/plugin·/mcp管理 skills / 插件市场 / MCP 连接其他/init扫描项目生成.atomcode.md指令文件/webui·/app浏览器界面 / 手机 App 远程接管会话小技巧/status、/diff、/cost等只读命令在 agent 流式输出时也能跑临时面板显示按 Esc 关闭不用等回合结束。4. 多行输入与文件引用\ Enter 换行所有终端通用或 ShiftEnter / AltEnter取决于终端输入框敲前面是空白或行首弹出文件/目录候选菜单把具体路径指给模型看由模型按需 read_file5. 上下文管理场景用什么同一会话重置对话/clear保留会话 ID上下文快撑爆但不想丢脉络/compact压缩成摘要开始完全不相关的新任务/session新 ID看花了多少 token/cost6. 项目级规范.atomcode.md在项目根放一个.atomcode.md启动时自动注入系统提示。查找顺序.atomcode.md→ATOMCODE.md→AGENTS.md→CLAUDE.md。也支持用/init自动生成。经验只写和一般情况不一样的部分、给出确切命令“跑测试用 pnpm test”、用祈使句、列禁区、控制在 30–80 行。记忆分工整篇规范放.atomcode.md进 git 共享零散偏好用/remember --global仅本机项目踩坑用/remember留在.atomcode/memory.md4000 字符上限。7. 快捷键速查Esc清空输入 / 打断输出输入框为空时再按一次 撤销上一轮↑/↓浏览输入历史Tab接受补全F2 / ShiftF2切换模型CtrlC一次取消连按两次退出权限对话框y允许一次a本次会话始终允许n/Esc拒绝始终允许按工具名参数模式授予重启归零参见: docs/zh/basic-usage基本使用、docs/zh/slash-commands斜杠命令、docs/zh/sessions会话与撤销、docs/zh/memory永久记忆、docs/zh/project-instructions项目指令文件、docs/zh/keybindings快捷键提示本项目刚装好的code-review、ascend-review、performance-analyzer、project-conventions也会以斜杠命令形式出现在补全菜单里直接/code-review、/ascend-review即可触发。