1. IDE 与 AI 编程助手
考拉
  • 价格-充值-分组-模型价格介绍
  • 站点操作指南-快速上手调用大模型API
  • 接入教程
    • IDE 与 AI 编程助手
      • Cursor 配置指南
      • VS Code 配置指南
      • Gemini CLI 配置指南
      • Trae 配置指南 (插件配置)
      • OpenCode 桌面端 配置指南
      • OpenCode CLI 配置指南 (CC Switch)
      • MiMoCode CLI 安装与配置 koalaapi
      • ChatGPT（Codex） CLI 安装与配置 koalaapi
      • ChatGPT（Codex） 桌面端 安装与配置 koalaapi
      • Claude Code 桌面端 安装与配置 koalaapi
      • Claude Code CLI 安装与配置 koalaapi (CC Switch)
      • Claude Code CLI 安装与配置 koalaapi (Win/Mac)
    • 桌面客户端
      • WorkBuddy 接入koalaapi教程
      • koalaapi接入chatbox
      • koalaapi接入Cherry Studio
    • 工作流与自动化
      • CC Switch 安装与配置教程
      • CC Switch 导入 koalaapi 令牌(API-KEY)
      • Claude Code + CC Switch 配置 DeepSeek | GLM 模型
      • n8n 配置使用 koalaapi 教程
      • Dify 配置使用 koalaapi教程
      • Coze 配置使用 koalaapi教程
    • 开源项目与部署
      • 腾讯云OpenClaw接入koalaapi教程
      • OpenClaw 接入 koalaapi 教程
      • OpenClaw Web 界面配置 koalaapi
      • OpenClaw 在云服务器Linux环境下通过终端配置 koalaapi
      • Hermes Agent Linux安装接入 koalaapi 教程
      • Hermes Agent CLI 安装与配置 koalaapi（CC Switch）
      • Pi Coding Agent 配置 koalaapi 教程
  • 模型接口
    • OpenAI
      • 文本模型
        • 文本生成
        • 上下文阅读
        • 函数调用 tools
        • v1/Responses / 通用
        • PDF文件分析
        • 联网搜索 Web Search
        • Response_Format
      • Embedding 模型
        • 创建文本嵌入
        • 批量创建嵌入
      • 图像模型
        • 图片生成（统一接口 · 支持多模型）
        • 图像编辑（统一接口 · 表单上传 / JSON 双模式）
        • 图片理解（多模态视觉分析）
    • Anthropic Claude
      • 原生接口
        • 文本生成 (思考配置)
        • 图片理解
        • 文本生成
        • 文本生成 / 强制返回思考
        • 函数调用
        • Web search / 联网搜索
      • OpenAI兼容接口
        • 文本生成
        • 图片理解
        • 文本生成 / 强制返回思考
        • 函数调用
        • Web search / 联网搜索
    • Google Gemini
      • OpenAI兼容接口（推荐）
        • 文本生成
        • 文本生成 / 强制返回思考
        • 图片理解
        • 图片生成
        • 图片修改
        • 音频理解
        • 视频理解
        • 文本转语音 / TTS
        • 图片编辑（Nano-banana）
        • 图片编辑（Nano-banana） base64格式
      • Google Gemini接口
        • 文本生成
        • 文字转语音
        • 音频转文
        • 视频转文
        • 图片理解
        • 文生图片（nanobanana pro）
        • 图片编辑（nanobanana）
        • 图片编辑（nanobanana pro）
  • 平台接口
    • 获取个人token
    • 用户信息管理
      • 1. 获取个人信息
      • 2. 修改个人信息
      • 3. 注销账户
      • 4. 获取可用模型列表
      • 5. 获取用户分组
      • 6. 更新用户设置（额度预警等）
      • 7. 生成系统访问令牌
    • 令牌管理（API Key）
      • 1. 获取令牌列表
      • 2.搜索令牌
      • 3. 获取单个令牌
      • 4.创建令牌
      • 5.更新令牌
      • 6. 删除令牌
      • 7.批量删除令牌
      • 8.获取单个令牌（明文显示）
    • 日志与数据统计
      • 1. 查看个人使用日志
      • 2. 个人日志统计
      • 3. 令牌每日消耗
      • 4. 令牌模型消耗预览（Top 3）
      • 5. 令牌全量模型消耗
      • 6. 导出令牌每日消耗 XLSX
      • 7. 个人额度时序数据
  • 常见问题
    • 问题自查方法
    • 入门必看
      • 如何在 koalaapi 充值？
      • 可以使用哪些 大模型API ？
      • 如何获取 OpenAI Key ？ 如何获取 Claude Key ？ 如何获取 Gemini Key ？等等
      • 我注册并且充值了，key 在哪？
      • 怎么更换模型使用？
      • 配置模型的时候 URL 用哪个？
      • 接口在中国大陆能使用吗？
      • 按量计费还是按月支付？
      • 怎么检查一次调用消耗了多少 Token？
      • 请问我余额为负了怎么回事？
    • 常见误区
      • 明明余额还有很多，为什么显示令牌无法使用？
      • Key 为什么不能用？为什么我调用 API 没反应？
      • 新建令牌参数怎么填？
      • 为什么调用接口返回“无效的令牌”？
      • API 接口返回报错，报错代码 400 401 403 404 405 413 429 500 503 504 524 是什么意思？
  • 数据模型
    • 示例数据模型
      • 未命名数据模型
      • Pet
      • Category
      • Tag
  1. IDE 与 AI 编程助手

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

Claude Code CLI 安装与配置 KoalaAPI（Windows + CC Switch）#

访问地址：https://koalaapi.com（OpenAI 兼容接口在末尾加 /v1）。
配置速查
配置项填写内容
Base URLhttps://koalaapi.com；OpenAI 兼容接口填 https://koalaapi.com/v1
API Key控制台 → 令牌管理 创建的令牌，形如 sk-...
模型名称与控制台【模型广场】完全一致；不同令牌分组可用的模型不同

一、准备工作#

开始配置前，请先确认已具备以下条件：
已拥有可正常登录的 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 已安装完成。
image.png

三、安装 CC Switch#

请先按照 KoalaAPI 官方文档完成 CC Switch 安装：
【CC Switch 使用教程】https://koalaapi.apifox.cn
安装完成后，请确认 CC Switch 可以正常打开。后续需要将 KoalaAPI 令牌导入到 CC Switch，并启用 Claude Code 对应的配置。
打开 CC Switch 后，请确认当前位于 Claude Code 对应的页面。该页面中的默认配置通常显示为 Claude Official。
image.png

四、创建 Claude Code 专用令牌#

打开 KoalaAPI 官网并登录账号，依次点击 控制台 → 令牌管理 → 添加令牌。
image.png
在创建令牌页面，按需填写以下信息：
名称：建议填写容易识别的名称，例如 Claude Code令牌。
令牌分组：选择用于 Claude Code 的分组。请确保该分组中包含需要使用的 Claude 模型。
额度设置：按实际需求设置额度。如果不需要限制额度，可保持默认配置。
访问限制：如无特殊网络限制要求，可保持默认配置。
确认信息无误后，点击 提交。
image.png

五、打开 CC Switch 导入入口#

令牌创建成功后，会弹出保存 key 的弹窗。保存 key 之后，点击 在 CC Switch 中打开
image.png

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

页面会弹出 接入 CC Switch 窗口。
在弹窗中按以下方式配置：
应用：选择 Claude。
名称：填写容易识别的名称，例如 My Claude。
主模型：选择要作为 Claude Code 主模型使用的模型。
Haiku 模型：按需选择模型。没有特殊要求时，可以和主模型保持一致。
Sonnet 模型：按需选择模型。没有特殊要求时，可以和主模型保持一致。
Opus 模型：按需选择模型。没有特殊要求时，可以和主模型保持一致。
模型可以根据自己的实际可用模型选择。你也可以根据分组权限选择其他 Claude 模型。
确认配置无误后，点击 打开 CC Switch。
image.png
点击 打开 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#

Claude Code CLI 是 Claude 官方客户端，缓存由它自己管，最不容易失效。
实测同一时段内，走 Claude 原生接口的请求只有 2.1% 没吃到缓存，走 OpenAI 兼容接口的是 17.8%。
如果用桌面聊天客户端（比如 Chatbox）跑长任务，历史会被反复整理，缓存容易整段失效，账单会明显偏高。怎么选见《客户端怎么选：会直接影响你的账单》。
更新于 2026-11　官方文档：https://code.claude.com/docs/en/setup
修改于 2026-11-05 09:21:05
上一页
Claude Code 桌面端 安装与配置 koalaapi
下一页
Claude Code CLI 安装与配置 koalaapi (Win/Mac)
Built with