Appearance
手动切换配置
手动切换配置不是一个工具，也没有需要下载的安装包。它只是把 AIDMX 的 Base URL、API Token 和模型名称写进当前终端、系统环境变量或项目配置文件，再让目标工具读取这些值。
适用场景
- 只在少量项目中使用 AIDMX。
- 想明确控制当前终端会话使用哪个 API 服务。
- CC Switch 尚未验证或不适合当前系统环境。
- 想先用最透明的方式排查 Token、Base URL 和模型名称。
下载和官方入口
| 入口 | 地址 | 说明 |
|---|---|---|
| 本页 | 无需下载 | 手动切换配置不是工具，只是把 AIDMX 配置写进环境变量或配置文件。 |
| 目标工具官方入口 | 下载入口总览 | 如果目标工具本身还没安装，先选择对应工具的官方 HTTPS 入口。 |
| AIDMX Token | 令牌管理 | 创建并复制本次手动配置要使用的 API Token。 |
| AIDMX 日志 | 使用日志 | 保存配置后验证请求是否到达 AIDMX。 |
不要从非官方镜像复制安装包、脚本或配置片段作为主要来源。
平台支持
| 平台 | 可用方式 | 注意事项 |
|---|---|---|
| Windows PowerShell | 当前会话 $env:... 或用户环境变量 | 重新打开终端后才会读取持久化用户变量。 |
| macOS / Linux / WSL | 当前会话 export、shell profile 或项目 .env | export 只影响当前终端和它启动的子进程。 |
| Docker / systemd / 后台服务 | 服务环境变量、compose 文件或启动脚本 | 后台进程通常读不到你当前 shell 里的临时变量。 |
| IDE / 桌面应用 | 应用设置页或从终端启动应用 | 双击启动的应用不一定继承终端环境变量。 |
安装后检查
手动方式没有安装步骤，配置前先检查：
- 已在 令牌管理 创建 AIDMX API Token。
- 已确认目标工具支持自定义 Base URL 或 OpenAI Compatible Provider。
- 已知道目标工具读取哪些变量名或配置字段。
- 已确认项目的
.env、shell profile 或配置文件不会被公开提交。 - 已准备 AIDMX 控制台可用模型名称。
配置 AIDMX
在当前终端临时设置 AIDMX 变量。macOS、Linux 或 WSL 可使用：
bash
export AIDMX_BASE_URL="https://ai.aidmx.xyz/v1"
export AIDMX_API_KEY="你的 API Token"
export AIDMX_MODEL="控制台可用模型名称"Windows PowerShell 当前会话可使用：
powershell
$env:AIDMX_BASE_URL = "https://ai.aidmx.xyz/v1"
$env:AIDMX_API_KEY = "你的 API Token"
$env:AIDMX_MODEL = "控制台可用模型名称"对 OpenAI 兼容工具，按工具要求映射为常见变量：
bash
export OPENAI_BASE_URL="$AIDMX_BASE_URL"
export OPENAI_API_KEY="$AIDMX_API_KEY"powershell
$env:OPENAI_BASE_URL = $env:AIDMX_BASE_URL
$env:OPENAI_API_KEY = $env:AIDMX_API_KEY如果目标工具要求完整聊天端点，才填写 https://ai.aidmx.xyz/v1/chat/completions。大多数工具只需要 Base URL：https://ai.aidmx.xyz/v1。模型名称通常在工具界面或配置文件中单独填写为 AIDMX 控制台可用模型名称。
手动配置时，可以把图中的供应商名称、API Key、API 请求地址和模型名称理解为变量或配置文件的四个来源。API Key 对应 AIDMX API Token，API 请求地址 对应 https://ai.aidmx.xyz/v1。
启动目标工具并发送测试请求。使用完成后，关闭终端会话，或执行：
bash
unset OPENAI_API_KEY AIDMX_API_KEYPowerShell 当前会话可执行：
powershell
Remove-Item Env:OPENAI_API_KEY
Remove-Item Env:AIDMX_API_KEY成功验证
- 当前终端中
OPENAI_BASE_URL指向https://ai.aidmx.xyz/v1。 - 目标工具能返回模型结果。
- AIDMX 使用日志 中出现对应请求。
- 使用日志里的模型名称、请求时间、状态和消耗与本次测试一致。
常见失败
- 新终端变量丢失：临时
export只对当前会话生效。 - 变量名不匹配：不同工具可能读取
OPENAI_BASE_URL、OPENAI_API_BASE或自有字段。 - 桌面应用读不到变量：从同一个终端启动应用，或改用应用设置页填写。
- Base URL 重复：最终请求不应变成
/v1/v1/chat/completions。 - 模型名称错误：使用 AIDMX 控制台或价格页展示的可用模型名称。
- 使用日志无记录：请求没有到达 AIDMX，优先检查当前 Provider、Base URL 和代理设置。
- Token 被写进 Git：把
.env加入.gitignore，并立即轮换泄露 Token。
下一步
- 阅读 OpenAI 兼容工具 理解字段映射。
- 针对具体工具阅读 Codex CLI、Cursor 或 Postman。