Claude Code CLI 安装与配置 koalaapi (CC Switch)

本文档用于指导客户在 Windows 环境下安装 Claude Code CLI，并通过 CC Switch 使用 koalaapi 提供的 Claude 模型服务。配置完成后，用户可以在 PowerShell 或 CMD 中运行 claude，并通过 koalaapi 调用模型。

一、准备工作

开始配置前，请先确认已具备以下条件：

已拥有可正常登录的 koalaapi 账号。

已安装或准备安装 Claude Code CLI。

已安装或准备安装 CC Switch。

当前网络环境可以正常访问 https://koalaapi.com/。

已确认要使用的 koalaapi 令牌分组中包含 Claude Code 可用的模型。

注意：本文档适用于 Claude Code CLI。如果需要配置 Claude 桌面端，请参考 Claude 桌面端配置指南。

二、安装 Claude Code CLI

打开 PowerShell，执行下面的命令安装 Claude Code CLI：

irm https://claude.ai/install.ps1 | iex

如果你使用的是 CMD，请执行下面的命令：

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

安装完成后，关闭当前终端，再重新打开 PowerShell 或 CMD，执行下面的命令确认安装是否成功：

如果能正常显示版本号，说明 Claude Code CLI 已安装完成。

三、安装 CC Switch

请先按照 koalaapi 官方文档完成 CC Switch 安装：

【CC Switch 安装教程】https://koalaapi.apifox.cn/8659863m0

安装完成后，请确认 CC Switch 可以正常打开。后续需要将 4SAPI 令牌导入到 CC Switch，并启用 Claude Code 对应的配置。

打开 CC Switch 后，请确认当前位于 Claude Code 对应的页面。该页面中的默认配置通常显示为 Claude Official。

四、创建 Claude Code 专用令牌

打开 koalaapi 官网并登录账号：

https://koalaapi.com/

登录后，依次点击 控制台 → 令牌管理 → 添加令牌。

在创建令牌页面，按需填写以下信息：

名称：建议填写容易识别的名称，例如 Claude Code令牌。

令牌分组：选择用于 Claude Code 的分组。请确保该分组中包含需要使用的 Claude 模型。

额度设置：按实际需求设置额度。如果不需要限制额度，可保持默认配置。

访问限制：如无特殊网络限制要求，可保持默认配置。

确认信息无误后，点击提交。

五、打开 CC Switch 导入入口

令牌创建成功后，页面会返回令牌列表。

在令牌列表中找到刚创建的令牌，点击该令牌所在行右侧的聊天下拉菜单，然后选择 CC Switch。

六、选择 Claude Code 配置并打开 CC Switch

页面会弹出 接入 CC Switch 窗口。

在弹窗中按以下方式配置：

应用：选择 Claude。

名称：填写容易识别的名称，例如 My Claude。

主模型：选择要作为 Claude Code 主模型使用的模型。

Haiku 模型：按需选择模型。没有特殊要求时，可以和主模型保持一致。

Sonnet 模型：按需选择模型。没有特殊要求时，可以和主模型保持一致。

Opus 模型：按需选择模型。没有特殊要求时，可以和主模型保持一致。

模型可以根据自己的实际可用模型选择。示例中统一选择 claude-opus-4-8，你也可以根据分组权限选择其他 Claude 模型。

确认配置无误后，点击 打开 CC Switch。

点击 打开 CC Switch 后，浏览器可能会弹出外部应用打开确认窗口。请允许浏览器打开 CC Switch。

七、导入 Claude Code 配置

CC Switch 打开后，会显示即将导入的供应商配置。

请重点确认以下内容：

应用类型 是否为 Claude。

供应商名称 是否容易识别，例如 My Claude。

API 端点 是否为 koalaapi 地址。

API 密钥 是否已自动带入，并且已做脱敏显示。

Haiku / Sonnet / Opus / 多模态模型 是否符合你的实际选择。

确认无误后，点击导入。

八、启用配置并测试连通性

导入成功后，回到 CC Switch 的 Claude Code 配置列表。

在列表中找到刚导入的配置，例如 My Claude，点击启用。

启用后，点击该配置右侧的 连通性测试 按钮。

如果页面上方提示 连通正常，说明 CC Switch 配置已生效。

注意：启用配置后，建议 关闭所有已打开的 PowerShell 或 CMD 窗口，再重新打开终端。这样可以确保 Claude Code CLI 读取到 CC Switch 写入的最新配置。

九、验证 Claude Code CLI

重新打开 PowerShell 或 CMD，进入你的项目目录。

执行下面的命令启动 Claude Code CLI：

如果首次进入时提示是否信任当前工作区，请确认这是你自己的项目目录，然后按提示继续。

进入 Claude Code CLI 后，输入一个简单问题进行测试，例如：

请用一句话说明你已经连接成功。

如果模型可以正常回复，说明 Claude Code CLI 已通过 CC Switch 使用 koalaapi 配置完成。

十、常见问题

输入 `claude` 后提示命令不存在

通常是 Claude Code CLI 没有安装成功，或者安装目录没有加入环境变量。

请重新执行安装命令，安装完成后 关闭终端，再重新打开 PowerShell 或 CMD。

启用配置后 Claude Code CLI 仍然走默认服务

请优先检查以下内容：

CC Switch 当前启用的是刚导入的 My Claude 配置。

当前选中的是 Claude Code 页面，不是 Claude 桌面端 页面。

启用配置后，是否已经重新打开 PowerShell 或 CMD。

本机是否手动设置过旧的 ANTHROPIC_API_KEY 或 ANTHROPIC_BASE_URL 环境变量。

如果之前手动配置过 Claude Code，请先确认旧配置不会覆盖 CC Switch 当前启用的配置。

连通性测试失败

请优先检查以下内容：

koalaapi 令牌是否已启用。

令牌分组中是否包含所选 Claude 模型。

CC Switch 中是否已点击启用。

koalaapi API 端点是否填写或导入正确。

当前网络是否可以正常访问 https://koalaapi.com/。

运行 `claude` 后提示需要登录

如果已经通过 CC Switch 启用了 koalaapi 配置，但 Claude Code CLI 仍提示登录，请先关闭所有终端窗口，再重新打开终端运行 claude。

如果仍然提示登录，请回到 CC Switch，确认 My Claude 配置处于 使用中 状态，并重新执行 连通性测试。

应该选择 Claude 还是 Claude Desktop

配置 Claude Code CLI 时，请选择 Claude Code / Claude 对应的配置入口。

不要选择 Claude Desktop 入口。Claude Desktop 入口用于 Claude 桌面端，不用于终端中的 Claude Code CLI。

Claude Code CLI 安装与配置 koalaapi (CC Switch)

一、准备工作#

二、安装 Claude Code CLI#

三、安装 CC Switch#

四、创建 Claude Code 专用令牌#

五、打开 CC Switch 导入入口#

六、选择 Claude Code 配置并打开 CC Switch#

七、导入 Claude Code 配置#

八、启用配置并测试连通性#

九、验证 Claude Code CLI#

十、常见问题#

输入 claude 后提示命令不存在#

启用配置后 Claude Code CLI 仍然走默认服务#

连通性测试失败#

运行 claude 后提示需要登录#

应该选择 Claude 还是 Claude Desktop#