配置 AI 模型、提供商和 API 密钥

Andromity 将用户偏好、当前角色 (profile) 和提供商凭据存储在本地配置文件 ~/.andromity/config.toml 中（Windows 上为 %APPDATA%\andromity\config.toml）。

该文件会在首次运行时自动初始化。

config.toml 示例复制标题链接

[default]
provider   = "anthropic"
model      = "claude-3-7-sonnet"
profile    = "builder"
permission_mode = "safe"
telemetry  = true              # 设为 false 可禁用匿名指标

[[providers]]
name       = "anthropic"
type       = "anthropic"
api_key    = "sk-ant-api03-..."

[[providers]]
name       = "openai"
type       = "openai"
api_key    = "sk-proj-..."

[[providers]]
name       = "gemini"
type       = "google"
api_key    = "AIzaSy..."

[[providers]]
name       = "groq"
type       = "groq"
api_key    = "gsk_..."

[[providers]]
name       = "openrouter"
type       = "openrouter"
api_key    = "sk-or-v1-..."

[[providers]]
name       = "ollama"
type       = "ollama"
base_url   = "http://localhost:11434"

支持的环境变量复制标题链接

除 config.toml 外，Andromity 还会自动检测标准的提供商环境变量：

通过聊天命令管理密钥复制标题链接

无需直接编辑 .toml 文件，即可查看和更新密钥：

/keys

/keys set anthropic sk-ant-...
/keys set openai sk-proj-...
/keys set gemini AIzaSy...

模型选择与热切换复制标题链接

Andromity 基于 LiteLLM，支持云端和本地提供商的 396+ 个模型。你可以在对话中的任何时候热切换当前模型：

在终端中使用 /model，或在 VS Code 中使用模型控件，即可打开模型选择器。选择提供商及其确切的模型标识符。该终端命令只会打开选择器，不会根据命令后附带的参数切换模型。

快捷键：按 Ctrl + L（macOS 上为 Cmd + L）可立即调出模型切换器。

数据隐私与遥测复制标题链接

Andromity 遵循零 PII（个人身份信息）原则：

1. 提供商路由：请求按所选的提供商路由发送。直连的 BYOK 提供商会接收推理所需的提示词和代码上下文；Andromity 网关路由则通过无状态边缘代理转发请求。网关不会持久化存储提示词、补全结果或源代码。本地 Ollama 端点在其所在机器上运行推理。请查阅你的提供商的数据政策以及已启用的网络工具。
2. 本地存储：对话会话和轮次历史仅存储在你本地机器的 ~/.andromity/sessions/ 中。
3. 遥测控制：匿名的延迟指标和错误代码会被上报，用于优化边缘路由。你可以随时选择退出：
   • 在 ~/.andromity/config.toml 中设置 telemetry = false
   • 或在 shell 配置文件中导出 DO_NOT_TRACK=1

其余文档页面仅提供英文版。 浏览英文文档