---
url: https://limapi.com/docs/agents/limapi-agent.md
---
# LimAPI Agent 桌面客户端

**LimAPI Agent** 是 LimAPI 官方桌面 AI 助手（支持 macOS / Windows / Linux），除了内置对话能力外，最大的特色是可以**一键安装并自动配置**主流 AI 编程工具，让它们直接接入 LimAPI。

## 下载安装

从 [LimAPI 官网](https://limapi.com) 或管理员处获取对应操作系统的安装包：

| 操作系统 | 安装包 | 安装方式 |
|------|--------|---------|
| 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），选择工具后自动完成：
  1. 检测是否已安装，未安装则执行平台对应的安装命令；
  2. 自动写入/合并对应工具的配置文件（Base URL + API Key）；
  3. 修改前自动备份原配置文件（`.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 | 仅支持界面配置，客户端提供手动配置指引 |

## 使用流程

1. 按上文「下载安装」完成安装，使用 Portal 账号登录。
2. 进入「Agent 装机 / Skills」页面，选择要安装的工具（如 Claude Code）。
3. 客户端自动执行安装与配置，全程显示进度与结果。
4. 配置完成后，打开对应工具即可使用 LimAPI 的模型。

## 常见问题

### 一键配置会覆盖我已有的配置吗？

不会直接覆盖。JSON 类配置采用合并写入，其他配置文件在修改前会自动备份为 `.bak.时间戳`，如有问题可随时恢复。

### 不想使用桌面客户端？

可以按照各工具的[接入教程](/agents/)手动配置，效果完全一致。