Alma 客户端配置指南

简介

Alma 是一款功能丰富的 AI 编程客户端工具，集成了代码编辑、终端操作、Git 管理和浏览器功能，为开发者提供全面的 AI 辅助编程支持。

官网： https://alma.now/

核心功能

• 智能代码生成和补全
• 集成终端命令执行
• 可视化 Git 管理
• 内置浏览器支持
• 多模型支持（Claude、Gemini 等）
• 自定义 API 供应商集成

安装与配置

第一步：安装 Alma

从官网下载并安装对应版本。

第二步：配置中文界面

1. 打开 Alma 应用
2. 进入 Settings → General → Language
3. 选择中文

第三步：添加 CodeKey 自定义供应商

1. 点击 Select Provider → Add Custom Provider
2. 填写配置：
   • Provider Name：CodeKey
   • Base URL：https://api.codekey.cc/v1
   • API Key：从 CodeKey 控制台获取
3. 点击 Fetch 获取可用模型列表

注意

• 使用 C 前缀 API Key 访问 Claude 模型
• 使用 Gemini 前缀 Key 访问 Gemini 模型

第四步：配置多组（可选）

不同的 API Key 组可以访问不同的模型集合，按需配置多个 Key。

开始新对话

重要设置

创建新对话时，将上下文范围设置为 "Select All" 而非 "Auto"。测试表明 "Auto" 模式会导致幻觉问题，模型可能引用不存在的文件或误解项目结构。

最佳实践

模型选择建议

模型	适用场景
Claude Sonnet	日常编码任务，响应速度更快
Claude Opus	复杂架构和高难度问题
Gemini	多模态任务，需要图像理解

使用技巧

• 小项目选择全部文件；大项目选择相关模块
• 定期清理无关上下文以节省 Token
• 利用终端集成验证 AI 生成的代码
• 使用 Git 功能进行版本管理

常见问题

模型无法访问？

检查 API Key 权限、账户余额和 CodeKey 控制台中的令牌组设置。

Alma 与 Claude Code 的区别？

Alma 提供图形界面和集成工具；Claude Code 是命令行工具，适合终端工作流。