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 桌面端 安装与配置 koalaapi

Claude Code 桌面端安装与配置 KoalaAPI#

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

一、准备工作#

开始配置前，请先确认已具备以下条件：
已拥有可正常登录的 KoalaAPI 账号。
已安装或准备安装 Claude 桌面端。
已安装或准备安装 CC Switch。
当前网络环境可以正常访问 https://koalaapi.com/。

二、安装 Claude 桌面端#

在浏览器中打开 Claude 官方下载页面，根据当前系统选择对应版本下载，并按照系统提示完成安装：
https://claude.com/download
安装完成后，打开 Claude 桌面端，确认应用可以正常启动。
如果此时页面提示无法连接，属于正常情况。原因是模型服务尚未完成配置，当前只需要确认软件可以正常打开。
（截图待补）

三、安装 CC Switch#

请先按照 KoalaAPI 官方文档完成 CC Switch 安装：
【CC Switch 安装教程】https://koalaapi.apifox.cn/8463188m0
安装完成后，请确认 CC Switch 可以正常打开。后续需要在 CC Switch 中手动添加 Claude 供应商配置。
（截图待补）

四、添加 Claude 桌面端配置#

打开 CC Switch，点击顶部的 Claude 桌面端图标，然后点击右上角的 加号。
（截图待补）
在添加供应商页面中，点击 自定义配置。
（截图待补）
进入自定义配置页面后，按以下要求填写：
供应商名称：填写容易识别的名称，例如 My Claude。
备注：可选，可填写用途说明。
官网链接：可填写 https://koalaapi.com/。
API Key：粘贴刚刚从 KoalaAPI 令牌列表复制的密钥。
请求地址：填写 KoalaAPI 的 Claude 兼容请求地址，请以页面或截图中展示的地址为准。
填写完成后，展开 手动指定 Claude Desktop 模型列表（高级，可选）。
如果可以自动获取模型列表，请点击 获取模型列表。如果无法获取，点击 添加模型，手动添加需要使用的模型。
模型添加完成后，选择要使用的模型，例如截图中的 claude-opus-4-8，然后点击页面右下角的 添加。
（截图待补）

五、添加并启用配置#

添加成功后，CC Switch 会返回供应商列表。
在列表中找到刚添加的配置，例如 My Claude，点击 切换。
（截图待补）

六、验证 Claude 桌面端#

打开 Claude 桌面端，你应该可以正常进入会话窗口。新建或打开一个对话，发送一条测试消息。
如果模型可以正常响应，说明 Claude 桌面端已完成配置。
（截图待补）

七、常见问题#

复制密钥后无法添加配置#

请确认复制的是令牌列表中的 复制密钥，不是 复制连接信息。
如果添加时提示 API Key 不正确，请重新复制密钥，并确认没有多复制空格或其他字符。

连通性测试失败#

请优先检查以下内容：
KoalaAPI 令牌是否已启用。
令牌分组中是否包含所选 Claude 模型。
CC Switch 中是否已点击 启用。
请求地址 是否填写正确。
网络是否可以正常访问 https://koalaapi.com。

Claude 桌面端仍然提示连接失败#

请确认 CC Switch 中当前启用的是刚添加的 Claude 配置，并重新进行 连通性测试。
测试通过后，请重新打开 Claude 桌面端，或重新发送测试消息。

Claude 桌面端仍然使用默认服务#

请确认 CC Switch 中 Claude 对应的供应商配置已经处于 使用中 状态。
如果存在多个供应商配置，请优先启用刚添加的 KoalaAPI Claude 配置。

八、关于缓存与费用#

桌面端和 CLI 一样走 Claude 原生接口（/v1/messages），缓存由客户端自己管，是缓存最友好的接入方式之一。
如果长任务里觉得费用偏高，先确认没有同时用桌面聊天客户端（比如 Chatbox）跑同样的内容——那类客户端会反复整理历史，导致缓存失效。怎么选见《客户端怎么选：会直接影响你的账单》。
更新于 2026-11　官方文档：https://code.claude.com/docs/en/setup
修改于 2026-11-06 05:02:56
上一页
ChatGPT（Codex） 桌面端 安装与配置 koalaapi
下一页
Claude Code CLI 安装与配置 koalaapi (CC Switch)
Built with