主题
Alma 客户端配置指南
功能强大的 AI 编程客户端工具。
📋 简介
Alma 是一款功能强大且界面精美的 AI 客户端工具，集成了代码编写、终端操作、Git 管理、浏览器等多种功能，为开发者提供完整的 AI 辅助编程体验。
🔗 相关链接
- 官方网站：https://alma.now/
✨ 功能特点
Alma 提供以下强大功能：
- ✅ 代码编写：智能代码生成和补全
- ✅ 终端操作：集成终端，直接执行命令
- ✅ Git 管理：可视化 Git 管理
- ✅ 浏览器集成：内置浏览器支持
- ✅ 多模型支持：支持 Claude、Gemini 等多种模型
- ✅ 自定义供应商：可接入自定义 API 提供商
🛠️ 安装与配置
第一步：安装 Alma
访问 Alma 官网 下载并安装适合你操作系统的版本。
第二步：设置中文界面
为了更好的使用体验，建议将界面设置为中文：
- 打开 Alma 应用
- 进入 设置 → 通用 → 语言
- 选择「中文」
第三步：添加自定义供应商
1. 进入供应商设置
点击 选择供应商 → Add Custom Provider（添加自定义提供商）
2. 配置供应商信息
填写以下信息：
| 字段 | 值 |
|---|---|
| Provider Name | 自定义名称（如 my-proxy） |
| Base URL | https://api.nassaapi.xyz |
| API Key | 粘贴你从控制台创建的 API Key |
💡 提示
- Claude 模型：确保使用允许逆向分组的 API Key
- Gemini 模型：确保使用 gemini 分组的 API Key
- CodeX 模型暂不支持第三方客户端调用（仅支持官方 CodeX CLI）
3. 获取可用模型
添加完成后，在供应商界面点击 Fetch（获取） 按钮，系统会自动获取所有可用模型。选择你需要的模型即可开始使用。
第四步：配置多个分组（可选）
支持通过不同的 API Key（不同分组） 访问不同的模型集合。
在供应商界面，你可以：
- 填写不同分组的 API Key
- 获取对应分组的模型列表
- 根据需求切换使用
💡 提示
如需使用 Gemini 3 的画图功能，需要选择 default 渠道的 API Key。
💬 新建聊天与使用
- 点击左上角 「+」 新建对话
- 顶部选择模型
- 输入提示词开始对话
重要设置提醒
- 为 Claude 模型选择对应的 Claude Key
- 为 Gemini 模型选择对应的 Gemini Key
- 模型切换后记得重新选择 Key
使用技巧
- 使用
/触发快捷指令（翻译、总结、改写） - 在「Prompt 库」中保存常用提示词，一键复用
- 利用终端集成直接运行生成的命令
- 使用 Git 可视化快速提交代码
🎯 最佳实践
1. 合理选择模型
- 复杂任务：使用
gpt-5.5或claude-sonnet-4 - 简单对话：使用
gpt-5.4-mini节省费用 - 编程专用：使用
gpt-5.3-codex
2. 合理使用上下文
- 开新对话前清理上下文避免污染
- 长文档分段投喂，避免一次性超长输入
3. 充分利用 Alma 的集成功能
- 结合终端和 Git 快速完成修改 → 提交的闭环
- 使用浏览器集成直接查看结果
常见问题
如何切换不同的 API 提供商？
在供应商下拉列表中直接选择即可，无需重启应用。
为什么有些模型无法使用？
检查你使用的 API Key 是否在对应模型的分组中。不同模型分组的 Key 不通用。
Alma 和 Claude Code 有什么区别？
- Alma：桌面 GUI 客户端，适合交互式对话和日常使用
- Claude Code：CLI 终端工具，适合项目级深度代码操作
更多问题
请查阅 疑难杂症 或 常见问题 (FAQ)。
✅ 完成
至此，Alma 已成功接入本站。尽情享受强大的 AI 辅助编程体验吧！