Appearance
LimAPI Agent 桌面客户端
LimAPI Agent 是 LimAPI 官方桌面 AI 助手（支持 macOS / Windows / Linux），除了内置对话能力外，最大的特色是可以一键安装并自动配置主流 AI 编程工具，让它们直接接入 LimAPI。
下载安装
从 LimAPI 官网 或管理员处获取对应操作系统的安装包：
| 操作系统 | 安装包 | 安装方式 |
|---|---|---|
| macOS | LimAPI Agent-<版本>-mac.dmg | 双击打开 DMG，将应用拖入「应用程序」文件夹 |
| Windows | LimAPI Agent-<版本>-win.exe | 双击运行，按安装向导提示完成安装（可自定义安装目录） |
| Linux | LimAPI Agent-<版本>-linux.AppImage | 执行 chmod +x 赋予执行权限后直接运行 |
系统要求：macOS 11 及以上、Windows 10 及以上、主流 Linux 发行版。
安装完成后启动应用，使用 Portal 账号登录即可。登录后客户端会自动关联你的 API Key，无需手动复制粘贴。
macOS 首次打开如提示「无法验证开发者」，请在「系统设置 → 隐私与安全性」中允许打开。
功能特性
- AI 对话：内置对话界面，直接使用 LimAPI 账号与余额调用平台模型。
- Agent 一键装机：自动检测操作系统（macOS / Windows / Linux），选择工具后自动完成：
- 检测是否已安装，未安装则执行平台对应的安装命令；
- 自动写入/合并对应工具的配置文件（Base URL + API Key）；
- 修改前自动备份原配置文件（
.bak.时间戳）。
- 账号集成：使用 LimAPI Portal 账号登录，自动使用你的 API Key，无需手动复制粘贴。
支持一键配置的工具
| 工具 | 协议 | 配置方式 |
|---|---|---|
| Claude Code | Anthropic | 合并 ~/.claude/settings.json（env 全套模型映射）+ ~/.claude.json 跳过登录验证 |
| OpenAI Codex | OpenAI | 追加 OPENAI_BASE_URL / OPENAI_API_KEY 环境变量到 shell profile |
| OpenClaw | Anthropic | 深合并 ~/.openclaw/openclaw.json（limapi provider + 模型清单） |
| OpenCode | Anthropic | 深合并 ~/.config/opencode/opencode.json（limapi provider + 模型清单） |
| Qwen Code | OpenAI | 深合并 ~/.qwen/settings.json（modelProviders 模型清单） |
| Hermes Agent | Anthropic | 写入 ~/.hermes/config.yaml |
| Cursor / Cline / Qoder | OpenAI | 仅支持界面配置，客户端提供手动配置指引 |
使用流程
- 按上文「下载安装」完成安装，使用 Portal 账号登录。
- 进入「Agent 装机 / Skills」页面，选择要安装的工具（如 Claude Code）。
- 客户端自动执行安装与配置，全程显示进度与结果。
- 配置完成后，打开对应工具即可使用 LimAPI 的模型。
常见问题
一键配置会覆盖我已有的配置吗？
不会直接覆盖。JSON 类配置采用合并写入，其他配置文件在修改前会自动备份为 .bak.时间戳，如有问题可随时恢复。
不想使用桌面客户端？
可以按照各工具的接入教程手动配置，效果完全一致。