---
title: AiMaMi 使用教程
sidebarTitle: AiMaMi
description: 了解 AiMaMi 与 Codex 的关系，下载桌面管理工具并配置无限星河AI代理地址和模型。
---

AiMaMi 是一个第三方 Codex 桌面管理工具，可以查看账号、会话和本地配置，也可以通过本地代理接入其他模型。使用前需要先安装 Codex。

## 下载 AiMaMi

前往 [AiMaMi 下载页](https://github.com/borawong/AiMaMi/releases/latest)，选择 Windows 或 macOS 安装包。

第一次打开时，确认软件识别到了正确的 Codex 目录。修改配置前，先退出 Codex 并备份 `~/.codex`。

![AiMaMi 管理界面](/images/tutorials/aimami/console.png)

## 添加无限星河AI

1. 打开 **中转注入** 或当前版本中的中转管理入口。
2. 添加自定义 Provider，名称填写“无限星河AI”。
3. Base URL 填写 `https://infistar.cc/v1`。
4. 填写 API Key。
5. 添加模型广场中的原始模型 ID。
6. 协议优先选择 **Responses**。
7. 保存并启用配置。

AiMaMi 使用本地代理转发请求，所以使用 Codex 时需要保持 AiMaMi 运行。

## 检查是否成功

启动 Codex，发送：

```text
请只回复“配置成功”，不要读取或修改文件，也不要运行命令。
```

## 遇到问题

- **提示 401**：重新复制 API Key。
- **提示 404**：Base URL 应为 `https://infistar.cc/v1`。
- **本地代理不可用**：确认 AiMaMi 正在运行，然后重新启用配置。
- **需要恢复**：退出 Codex 和 AiMaMi，再恢复备份的 `.codex` 目录。

不要同时使用 AiMaMi、CC-Switch 或 Codex++ 修改 Codex 配置。
