在 VS Code 和终端中安装 Andromity
通过 VS Code Marketplace、pipx 或安装脚本，在 Windows、macOS 和 Linux 上安装 Andromity AI 编程智能体，并验证安装结果。
Andromity 可以作为原生 VS Code 扩展或独立的 CLI/TUI 应用程序安装，也可以从源码安装以用于开发。
前提条件
安装 Andromity 之前，请确保你的系统满足以下要求：
- Python：
>= 3.11（完全支持 Python 3.12 和 3.13） - Git：已安装，且可通过系统
PATH访问 - 操作系统：macOS（Apple Silicon / Intel）、Linux（x86_64 / arm64）、Windows 10/11（PowerShell 和 WSL2）
- Node.js （可选）：
>= 18.0.0（仅在运行自定义 TypeScript MCP 服务器时需要）
1. 安装 VS Code 扩展
VS Code 扩展提供丰富的 UI 体验，包括停靠在辅助侧边栏、交互式差异 (diff) 叠加视图，以及实时瀑布图性能分析器。
通过 Marketplace 安装
- 打开 VS Code。
- 按
Ctrl + P（macOS 上为Cmd + P）。 - 粘贴以下命令并按 Enter：
ext install agenticmarket.andromity-agent通过命令行安装扩展
如果你更习惯在终端中安装：
code --install-extension agenticmarket.andromity-agent2. 安装独立终端 CLI
终端运行时提供底层引擎，以及基于 Textual 和 Rich 构建的终端用户界面（TUI）。
curl -fsSL https://raw.githubusercontent.com/agenticmarket/andromity/main/install.sh | bash安装程序会自动：
- 检查 Python 3.11+ 是否可用。
- 在
~/.andromity/venv创建隔离的虚拟环境。 - 将
andromity可执行文件符号链接到/usr/local/bin或~/.local/bin。
3. 验证安装
验证 CLI 可执行文件在你的 shell 中可用：
andromity --version启动交互式会话：
andromity以无头 (headless) 模式运行一次性脚本命令：
andromity run "analyze git status and report pending changes" --dry-run4. 平台相关说明
Windows Store 版 Python
如果 Python 是通过 Microsoft Store 安装的，Windows 会对本地应用数据进行虚拟化。你的配置文件将位于：
%LOCALAPPDATA%\Packages\PythonSoftwareFoundation.Python.3.12_qbz5n2kfra8p0\LocalCache\Roaming\andromity\对于标准的原生 Python 或 pyenv-win 安装，文件存储在 %APPDATA%\andromity\config.toml。
Linux 无头服务器
通过 SSH 在远程服务器上运行 Andromity 时，请确保终端支持 256 色或真彩色模式（export TERM=xterm-256color），以获得最佳的 Textual 渲染效果。
其余文档页面仅提供英文版。 浏览英文文档