在 Claude Code 中接入 APICAT。

安装 Claude Code

可参考 Claude Code 文档进行安装。

配置 APICAT API

WARNING

重要提示：

在配置前，请确保清除以下 Anthropic 相关的环境变量，以免影响 APICAT API 的正常使用：

ANTHROPIC_AUTH_TOKEN
ANTHROPIC_BASE_URL

API 配置

CC-Switch 是一个便捷的桌面工具，可以快速切换 Claude Code 的 API 配置。

1. 安装 CC-Switch

brew tap farion1231/ccswitch
brew install --cask cc-switch
brew upgrade --cask cc-switch

2. 添加 APICAT 配置

启动 CC-Switch，点击右上角 「+」，选择预设的 APICAT 供应商，并填写您的 API Key。

3. 配置模型名称

将模型名称全部改为您要使用的模型名称，完成后点击右下角的 「添加」。

4. 启用配置

回到首页，点击 「启用」。

5. 编辑配置文件

编辑或新增 .claude.json 文件：

macOS & Linux: ~/.claude.json
Windows: 用户目录/.claude.json

{
  "hasCompletedOnboarding": true
}

按以下方式手动编辑 Claude Code 配置文件：

// Step 1: 编辑或创建 Claude Code 的配置文件
// macOS & Linux 为 `~/.claude/settings.json`
// Windows 为 `用户目录/.claude/settings.json`
// `APICAT_API_KEY` 需替换为您的 APICAT API Key
// 环境变量 `ANTHROPIC_AUTH_TOKEN` 和 `ANTHROPIC_BASE_URL` 优先级高于配置文件
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://www.zeoapi.com/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "APICAT_API_KEY",
    "API_TIMEOUT_MS": "3000000",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1,
    "ANTHROPIC_MODEL": "example-coding-model",
    "ANTHROPIC_SMALL_FAST_MODEL": "example-coding-model",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "example-coding-model",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "example-coding-model",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "example-coding-model"
  }
}

// Step 2: 编辑或新增 `.claude.json` 文件
// macOS & Linux 为 `~/.claude.json`
// Windows 为 `用户目录/.claude.json`
// 新增 `hasCompletedOnboarding` 参数
{
  "hasCompletedOnboarding": true
}

启动 Claude Code

配置完成后，进入工作目录，在终端中运行 claude 命令以启动 Claude Code。

信任文件夹

启动后，选择 信任此文件夹 (Trust This Folder)，以允许 Claude Code 访问该文件夹中的文件，随后开始在 Claude Code 中使用配置好的模型。

WARNING

重要提示：

在配置完成后，如果您还想要使用图片理解 & 网络搜索能力，则需要根据此教程来配置图片理解 & 网络搜索 MCP。

在 Claude Code for VS Code 插件中使用

安装插件

安装 Claude Code for VS Code 插件。

打开设置

完成安装后，点击 Settings。

配置模型

配置模型为你要使用的模型名称。

Settings → Claude Code: Selected Model 输入你要使用的模型名称

或者

点击 Edit in settings.json，进入配置文件，修改 claude-code.selectedModel 为你要使用的模型名称

{
    "claudeCode.selectedModel": "example-coding-model",
  "claudeCode.environmentVariables": []
}

配置环境变量

若已安装 Claude Code，请参考上方配置进行环境变量配置
若尚未安装 Claude Code，点击 Edit in settings.json

将 claudeCode.environmentVariables 变量更改为以下设置：

"claudeCode.environmentVariables": [
  {
    "name": "ANTHROPIC_BASE_URL",
    "value": "https://www.zeoapi.com/anthropic"
  },
  {
    "name": "ANTHROPIC_AUTH_TOKEN",
    "value": "your-api-key"
  },
  {
    "name": "API_TIMEOUT_MS",
    "value": "3000000"
  },
  {
    "name": "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC",
    "value": "1"
  },
  {
    "name": "ANTHROPIC_MODEL",
    "value": "example-coding-model"
  },
  {
    "name": "ANTHROPIC_SMALL_FAST_MODEL",
    "value": "example-coding-model"
  },
  {
    "name": "ANTHROPIC_DEFAULT_SONNET_MODEL",
    "value": "example-coding-model"
  },
  {
    "name": "ANTHROPIC_DEFAULT_OPUS_MODEL",
    "value": "example-coding-model"
  },
  {
    "name": "ANTHROPIC_DEFAULT_HAIKU_MODEL",
    "value": "example-coding-model"
  }
],