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

# CC Switch 接入

> 在 CC Switch 中配置 AGICTO API 自定义模型供应商

你可以通过 Claude / Anthropic 兼容接口，在 CC Switch 中接入 AGICTO API。配置完成后，你可以在 Claude Code 中使用 AGICTO API 提供的模型。

## 配置 AGICTO 供应商

在 CC Switch 中进入 `Claude Code` 供应商管理页，点击 **添加供应商**，选择自定义配置。

填写以下内容：

| 字段      | 值                       |
| ------- | ----------------------- |
| 供应商名称   | `AGICTO`                |
| 官网链接    | `https://agicto.com/`   |
| API Key | 填写你的 AGICTO API Key     |
| 请求地址    | `https://api.agicto.cn` |

<Warning>
  Claude Code 供应商的请求地址不要添加 `/v1`，末尾也不要添加 `/`。如果你配置的是 Chat 或 OpenAI 兼容格式，请使用 `https://api.agicto.cn/v1`。
</Warning>

## 高级选项

展开 **高级选项**，保持以下配置：

| 字段     | 值                          |
| ------ | -------------------------- |
| API 格式 | `Anthropic Messages（原生）`   |
| 认证字段   | `ANTHROPIC_AUTH_TOKEN（默认）` |

## 模型映射

将 Claude Code 的模型角色映射到 AGICTO API 模型：

| 模型角色   | 实际请求模型            |
| ------ | ----------------- |
| Sonnet | `claude-opus-4-7` |
| Opus   | `claude-opus-4-7` |
| Haiku  | `claude-opus-4-7` |
| 默认兜底模型 | `claude-opus-4-7` |

## 配置 JSON 示例

最终配置 JSON 应类似如下：

```json theme={null}
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "你的_AGICTO_API_KEY",
    "ANTHROPIC_BASE_URL": "https://api.agicto.cn",
    "ANTHROPIC_MODEL": "claude-opus-4-7",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-7",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-opus-4-7",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-opus-4-7"
  },
  "includeCoAuthoredBy": false
}
```

## 保存并切换

点击右下角 **添加** 保存供应商。

添加成功后，回到供应商列表，将当前 Claude Code 供应商切换为 `AGICTO`。

## 测试

在终端中运行：

```bash theme={null}
claude
```

如果 Claude Code 可以正常回复，说明 AGICTO API 配置成功。

## 常见问题

### 添加时报 `Cannot read properties of undefined (reading 'invoke')`

说明当前打开的是浏览器中的 `localhost:3000` 页面，而不是 CC Switch 的 Tauri 桌面窗口。

请在 CC Switch 桌面应用窗口中操作。

### 报 `invalid_api_key`

API Key 填写错误。请检查是否复制完整，特别注意 `l`、`I`、`1` 等相似字符。

### 报 `model not found`

模型名称填写错误。请确认模型映射中使用：

```text theme={null}
claude-opus-4-7
```

### 连接到 `127.0.0.1:8902` 失败

本机可能配置了代理环境变量，但代理服务没有启动。

可以关闭相关代理环境变量，或启动对应的本地代理服务。