把 Claude、文件和本地工具 放进一个桌面工作区。
Claude Desktop 是 Anthropic 官方桌面客户端，适合对话、文件处理、Projects、Artifacts、Connectors、MCP 和 Desktop Extensions。本教程重点介绍安装、MCP 扩展与 OmniDino 的正确协作方式。
Claude Desktop 与 Claude Code 有什么不同？
Desktop 面向图形化对话、文件和扩展；Claude Code 面向终端、代码仓库和 LLM Gateway。
Desktop 是 Claude 的桌面客户端，不是通用 API 客户端。
它通过 Claude 账号登录并使用 Anthropic 提供的客户端模型服务。MCP 可以为 Claude 添加工具，但不会自动把底层模型替换成任意 OpenAI 或 Anthropic 兼容网关。
Claude Desktop 不能直接填写 OmniDino Base URL 和 API Key。
当前 Claude Desktop 没有像 Claude Code 那样公开提供 ANTHROPIC_BASE_URL 网关配置入口。登录 Desktop 后的 Claude 对话仍由 Anthropic 账号和官方服务提供，不能通过修改普通 MCP JSON 将模型调用改成 OmniDino。OmniDino 可以作为你自己开发的 MCP Server 后端，为 Desktop 提供工具能力，但这会产生两层调用：Claude Desktop 本身的 Anthropic 使用，以及 MCP 工具内部的 OmniDino API 使用。
官方客户端与 GitHub 开源辅助工具。
Claude Desktop 本身不是开源软件，因此必须从 Anthropic 官方页面下载。其余开发与辅助工具均指向 GitHub。
Claude Desktop
Anthropic 官方桌面客户端。支持 macOS、Windows 和官方逐步提供的 Linux 版本。
MCP Reference Servers
Model Context Protocol 官方参考服务器与社区项目索引，用于了解 MCP 结构和选择服务器。
MCPB Desktop Extensions
用于将本地 MCP Server 打包成可安装 Desktop Extension 的开放格式与工具。
TypeScript MCP SDK
开发自定义 MCP Server 的官方 TypeScript SDK，可用于把 OmniDino API 封装成桌面工具。
Python MCP SDK
适合使用 Python 开发本地或远程 MCP Server，并连接 OmniDino API 或内部业务数据。
Visual Studio Code
用于开发和审阅 MCP Server、JSON 配置、日志和 OmniDino API 工具代码。
选择你的操作系统。
Windows 安装
从 Anthropic 下载 Windows 安装包，完成安装后通过开始菜单打开 Claude。
macOS 安装
下载对应 macOS 版本，将 Claude 安装到 Applications，然后登录账号。
Linux 安装
Anthropic 已逐步提供官方 Linux Desktop Beta，具体发行版、架构和安装方式以下载页面为准。
用工具扩展 Claude，而不是替换 Claude 模型。
Desktop Extensions 是打包后的本地 MCP Server；Remote Connectors 则通过 URL 连接远程 MCP 服务。
本地文件
在授权目录内读取和处理文件。只开放工作需要的最小目录范围。
日历与邮件
通过扩展或 Connector 连接日历、邮件和协作工具。
数据库工具
连接测试数据库进行查询，生产环境优先使用只读账号。
远程 MCP
使用 Streamable HTTP 和 OAuth 连接托管在服务器上的工具。
一键扩展包
将本地 MCP Server 打包成可安装扩展，简化依赖和配置。
OmniDino 工具
你可以开发 MCP Server，让 Claude 调用 OmniDino API 完成模型测试、图片生成或内部业务任务。
旧版或开发场景可使用 JSON 配置。
新用户优先使用 Desktop Extensions。只有开发和排障时才建议手动修改配置文件。
配置文件位置
不同系统的 Claude Desktop 本地 MCP 配置位置不同。
{
"mcpServers": {
"my-local-tool": {
"command": "/absolute/path/to/your-mcp-server",
"args": ["--stdio"],
"env": {
"EXAMPLE_TOKEN": "使用系统安全存储或受控环境变量"
}
}
}
}npx -y package-name 配置。运行前先检查包的 GitHub 仓库、维护状态、依赖和实际权限。
三种正确使用方案。
Claude Code + OmniDino
需要直接使用 OmniDino Claude API 时，这是最清晰的方案。Claude Code 支持 LLM Gateway 环境变量。
第三方客户端 + OmniDino
选择明确支持 Anthropic Base URL、Messages 和自定义 API Key 的客户端。
Claude Desktop + OmniDino MCP
开发一个 MCP Server，把 OmniDino 作为工具后端。注意这不是替换 Desktop 的底层 Claude。
Claude Desktop
↓ 调用 MCP Tool
Your OmniDino MCP Server
↓ 使用服务器端安全保存的 Key
https://api.omnidino.com/v1
↓
OmniDino 模型或图片接口
↓
MCP Server 返回结果给 Claude Desktop从安装到第一个 MCP 工具。
从 Anthropic 安装 Claude Desktop
根据操作系统下载官方版本，不使用第三方重打包客户端。
登录 Claude 账号
Claude Desktop 的基础模型访问依赖 Claude 账号和当前可用套餐。
检查 Extensions 与 Connectors
在 Settings 中查看可安装扩展、远程 Connectors 和组织策略。
从低权限工具开始
先连接只读文件、测试日历或开发数据库，不要直接开放生产系统。
测试 MCP 调用
要求 Claude 列出可用工具，然后运行一个不会修改数据的最小任务。
按需开发 OmniDino MCP
使用官方 TypeScript 或 Python SDK，把需要的 OmniDino API 封装成明确、有限的工具。
保护 OmniDino API Key
将 Key 保存在服务器端或安全存储中，不写进公开扩展包和客户端截图。
检查两套用量
Claude Desktop 的 Anthropic 使用和 MCP 内部的 OmniDino 调用是两套独立用量，需要分别检查。
配置失败时从这里排查。
Claude Desktop 或 MCP 仍然有问题？
联系支持时请提供操作系统、Claude Desktop 版本、扩展或 MCP 名称、配置方式、错误提示和日志。请隐藏 API Key、访问令牌和敏感文件路径。
[email protected]