快速入门：在 VS Code 或终端中开始 AI 编程任务
安装 Andromity、连接模型、信任工作区，并在 VS Code 或终端中审查你的第一个代码更改。
本指南将引导你安装 Andromity、连接你偏好的 AI 提供商，并完成你的第一个自主结对编程任务。
安装 Andromity
选择你偏好的运行环境：
从 Visual Studio Marketplace 安装官方扩展：
code --install-extension agenticmarket.andromity-agent或者在 VS Code 的扩展视图（Ctrl+Shift+X 或 Cmd+Shift+X）中搜索 Andromity AI Coding Agent。
打开工作区并信任文件夹
在 VS Code 中打开任意仓库，或在终端中进入你的项目目录：
cd my-project
andromity安全第一：文件夹默认不受信任。在你授予工作区信任之前，针对仓库的工具读取、写入和命令执行都会被阻止。
在聊天输入框中输入 /trust，为该工作区授予信任：
/trust配置模型和 API 密钥
Andromity 支持 BYOK（Bring Your Own Key，自带密钥），也支持无需云端 API 费用的本地 Ollama。你可以通过提供商控件或密钥命令设置提供商密钥：
将 API 密钥保存到本地配置中：
/keys set anthropic sk-ant-api03-...
# 若使用 OpenAI：
/keys set openai sk-proj-...
# 若使用 Google Gemini：
/keys set gemini AIzaSy...
# 若使用 Groq：
/keys set groq gsk_...你可以随时使用 /model 或快捷键 Ctrl+L 切换模型。
运行你的第一个自主任务
让 Andromity 分析、规划或实现代码库中的某个功能：
Refactor src/auth.py to use async/await and add comprehensive pytest unit tests在 SAFE 模式（默认）下：
- Andromity 生成交互式实现蓝图。
- 你审查后点击 Approve Plan（批准计划）。
- 智能体编辑文件，并显示交互式的红绿差异 (diff) 供你审批。
- 它在终端中执行
pytest，自主验证测试是否通过。
常用键盘快捷键
| 快捷键 | 操作 | 说明 |
|---|---|---|
Ctrl + L / Cmd + L | 切换模型 | 在会话中途热切换 LLM 提供商 |
Ctrl + J / Cmd + J | 切换角色 | 在 builder、coder、reviewer、planner 之间切换 |
Ctrl + O / Cmd + O | 会话管理器 | 浏览并行会话和子智能体 |
Ctrl + E / Cmd + E | 设置面板 | 调整权限模式和遥测 |
/undo | 轮次回滚 | 一键撤销上一轮及其修改的所有文件 |
/waterfall | 执行轨迹 | 查看实时延迟和工具调用时间线 |
后续步骤
其余文档页面仅提供英文版。 浏览英文文档