Alma 客户端配置指南 工具

功能强大的 AI 编程客户端工具

📋 简介

Alma 是一款功能强大且界面精美的 AI 客户端工具，集成了代码编写、终端操作、Git 管理、浏览器等多种功能，为开发者提供完整的 AI 辅助编程体验。

• Alma 官网：https://alma.now/

功能特点

• ✅ 代码编写：智能代码生成和补全
• ✅ 终端操作：集成终端，直接执行命令
• ✅ Git 管理：可视化 Git 操作
• ✅ 浏览器集成：内置浏览器支持
• ✅ 多模型支持：支持 Claude、Gemini 等多种模型
• ✅ 自定义供应商：可接入自定义 API 提供商

安装与配置

第一步：安装 Alma

访问 Alma 官网 下载并安装适合你操作系统的版本。

第二步：设置中文界面

打开 Alma 应用 → 设置 → 通用 → 语言 → 选择「中文」

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

进入供应商设置：

点击「选择供应商」→「Add Custom Provider」（添加自定义提供商）

配置 CC Code 供应商：

填写以下信息：

• Provider Name：CC Code（或自定义名称）
• Base URL：https://ai.cccode.org/v1
• API Key：粘贴你从 CC Code 控制台 创建的 API Key

💡 提示

• Claude 模型：确保使用「只允许逆向分组」的 API Key
• Gemini 模型：确保使用「gemini 分组」的 API Key
• CodeX 暂不支持第三方客户端调用

获取可用模型：

添加完成后，在 CC Code 供应商界面点击「Fetch」（获取）按钮，系统会自动获取所有可用模型。

重要设置提醒

⚠️ 强烈建议

在新建聊天时，上下文范围设置非常重要：

选择「全选」而非「自动」！

经测试，选择「自动」时模型会产生严重的幻觉问题，可能导致：

• 引用不存在的文件
• 生成错误的代码逻辑
• 误解项目结构

选择「全选」可以确保模型获得完整的上下文信息，提供更准确的响应。

最佳实践

选择合适的模型

• Claude Sonnet：适合日常编码任务，速度快
• Claude Opus：适合复杂的架构设计和难题
• Gemini：适合需要多模态能力的任务（如图片理解）

合理使用上下文

• 对于小型项目，可以「全选」所有文件
• 对于大型项目，选择相关的模块和文件
• 定期清理不相关的上下文，避免 token 浪费

Alma vs Claude Code 对比

特性	Alma	Claude Code
界面	图形化界面	命令行界面
适用场景	全功能开发环境	终端快速操作
集成功能	终端、Git、浏览器等	纯命令行工具
学习曲线	较低	较高