> ## Documentation Index
> Fetch the complete documentation index at: https://docs.syon.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Claude 客户端

> 将 Claude Desktop 接入 Syon

# Syon接入 Claude 客户端

Claude 客户端（Claude Desktop）是 Anthropic 官方推出的桌面端应用，内置 Claude Code 编程能力。接入 Syon 有两种方式：使用 Teamo 客户端一键接入（推荐），或使用 CC Switch 手动接入。

## 方式一：Teamo 客户端一键接入（推荐）

[Teamo 客户端](https://syon.ai/zh/download)是 Syon 的官方桌面客户端，可以傻瓜式完成Claude客户端的下载、免订阅Syon接入、模型配置等流程，真正做到5分钟开箱即用，免去用户自己摸索和试错的烦恼。

【[下载windows版](https://ama-download.floatai.cn/syon/windows/Teamo-latest-Windows.msi)】 【[下载mac版](https://ama-download.floatai.cn/syon/mac/Teamo-latest-macOS.dmg)】

TIP：下载安装过程中，如遇系统误报风险提示，请选择信任或继续。

安装完成后，如图所示，请完成账号注册。

<img src="https://mintcdn.com/xiaokai/U0NqFyfQrMnHF9Xm/images/install-codex-desktop-teamo-switch-register.png?fit=max&auto=format&n=U0NqFyfQrMnHF9Xm&q=85&s=46bc0b7027e78ed719ca4ae4dfeec5e8" alt="" width="2160" height="1400" data-path="images/install-codex-desktop-teamo-switch-register.png" />

进入客户端后，找到 Claude 客户端 进行下载&安装（或自行[从 Claude 官网下载](https://claude.ai/downloads)）。

而后，点击"一键接入"按钮，客户端会自动将您本机的 Claude 客户端，与Syon完成连接&配置。

若您需要切换回 Anthropic 官方订阅套餐，可点击"断开 Syon"按钮，即可断开Claude客户端与Syon的连接。

自动接入完成后，就可以正常开始使用Claude了。

您可以在Syon的控制台，看到每条请求的用量情况。

## 方式二：CC Switch 手动接入

CC Switch 是一个图形界面工具，用来管理和切换 Claude 客户端的接入地址与密钥，一键切换。

### 安装 Claude 客户端和 CC Switch

本节为安装教程。如果您已安装 Claude 客户端和 CC Switch，接入 Syon 请直接看下一节。

#### 安装 Claude 客户端

* 到 [Claude 官网](https://claude.ai/code/family) 下载对应系统的 Claude 客户端并安装。

<img src="https://mintcdn.com/xiaokai/U0NqFyfQrMnHF9Xm/images/claude-code-desktop-latest-1.png?fit=max&auto=format&n=U0NqFyfQrMnHF9Xm&q=85&s=8d9a80f6b25fd0463073e73f11dc05d8" alt="Claude 客户端下载页面" width="1998" height="1244" data-path="images/claude-code-desktop-latest-1.png" />

#### 安装 CC Switch

请安装 v3.16.5 及以上版本。macOS 用户（推荐）通过 Homebrew 安装：

bash复制

```
brew install --cask cc-switch

``

或访问 [CC Switch Releases](https://github.com/farion1231/cc-switch/releases) 下载对应平台安装包：

- macOS：`.dmg` / `.zip`

- Windows：`.msi` 安装版 / Portable `.zip` 绿色版

- Linux：`.deb` / `.rpm` / `.AppImage`

首次打开如被 macOS Gatekeeper 拦截，到「系统设置 → 隐私与安全性」点 「仍要打开」。

### 接入 Syon

在 CC Switch 的 Claude Desktop 标签中，点击右上角【橙色加号】按钮。

![CC Switch 添加供应商入口](/images/claude-code-desktop-latest-2.png)

- 在 「预设供应商中」 找到 「Syon」（或直接搜索"Syon"）。

![CC Switch 选择 Syon 供应商](/images/claude-code-desktop-latest-3.png)

- 填入你在 [Syon 控制台](https://syon.ai/dashboard?tab=api-keys) 获取的 API Key。

![CC Switch 填写 Syon API Key](/images/claude-code-desktop-latest-4.png)

- 完成后，点击右下角保存。

在主页启用 Syon，打开 Claude 客户端即可生效。

如果已经打开了 Claude 客户端，需要重启一次生效。

![CC Switch 启用 Syon](/images/claude-code-desktop-latest-5.png)

打开 Claude 客户端，即可开始使用了。

![Claude 客户端使用界面](/images/claude-code-desktop-latest-6.png)

## 常见问题

Windows 系统用户在使用 Claude 客户端时，如遇以下报错：

Virtual Machine Platform not available

Claude's workspace requires the Virtual Machine Platform on Windows. Enable this feature, then restart.

请按照下述步骤完成操作，即可正常使用：

- `Win + R` 输入 `optionalfeatures` 回车；

- 找到并勾选「虚拟机平台」（英文叫 Virtual Machine Platform），确定；

- 重启电脑，再打开 Claude 客户端，即可使用。

准备好了？三步即可开始登录控制台 · 购买额度 · 创建 API Key
[获取 API Key](/dashboard?tab=api-keys)[查看定价](/zh/pricing)

![微信扫码加入交流群](https://ama-static.floatai.cn/syon/images/kefu/contact-qr.png)遇到问题？微信扫码加入交流群

[上一篇Claude Code 命令行](/zh/docs/install-claude-code)[下一篇Codex 命令行](/zh/docs/install-codex)
```