1. 工作流与自动化
考拉
  • 价格-充值-分组-模型价格介绍
  • 站点操作指南-快速上手调用大模型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. 工作流与自动化

Claude Code + CC Switch 配置 DeepSeek | GLM 模型

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

一、准备工作#

开始配置前，请确认已具备以下条件：
已注册并登录后，创建一个提供 DeepSeek 或 GLM 模型的分组的 API-KEY，也就是令牌。
确认账户余额、额度或调用权限正常。
已准备 API 端点和模型 ID。
已安装或准备安装 Claude Code CLI。
已安装或准备安装 CC Switch。
当前网络可以访问 API 服务商和相关软件下载页面。

二、安装 Claude Code CLI#

打开 PowerShell，执行：
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#

请从 CC Switch 官方发布页面或可信渠道下载安装包。安装完成后打开 CC Switch。
（截图待补）

四、准备 API 服务商信息#

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

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

页面会弹出 填入 CC Switch 窗口。
在弹窗中按以下方式配置：
应用：选择 Claude。
名称：填写容易识别的名称，例如 My Claude。
主模型：选择要作为 Claude Code 主模型使用的模型。
Haiku 模型：按需选择模型。没有特殊要求时，可以和主模型保持一致。
Sonnet 模型：按需选择模型。没有特殊要求时，可以和主模型保持一致。
Opus 模型：按需选择模型。没有特殊要求时，可以和主模型保持一致。
模型可以根据自己的实际可用模型选择。你也可以根据分组权限选择其他 Claude 模型。
确认配置无误后，点击 打开 CC Switch。
（截图待补）
CC Switch 打开后，会显示即将导入的供应商配置。
请重点确认以下内容：
应用类型 是否为 Claude。
供应商名称 是否容易识别，例如 My Claude。
API 端点 是否为 KoalaAPI 地址。
API 密钥 是否已自动带入，并且已做脱敏显示。
Haiku / Sonnet / Opus / 多模态模型 是否符合你的实际选择。
确认无误后，点击 导入。
（截图待补）

六、启用 CC Switch 路由功能#

国产模型接入 Claude Code 时，需要由 CC Switch 的路由功能负责转发请求。仅添加供应商或导入配置，但没有启动路由，Claude Code 可能仍然连接默认服务，或无法正常调用国产模型。
第一步，找到我们刚刚导入的配置，点击编辑按钮（如图）
（截图待补）
第二步，找到 高级选项 - 上游格式，选择 OpenAI Chat Completions(需开启路由) 选项，然后点击右下角 保存
（截图待补）
第三步，点击切换
（截图待补）
第四步，点击 开始路由并使用它
（截图待补）

七、启动 Claude Code 验证#

启用配置后，关闭所有已经打开的 PowerShell 或 CMD 窗口，再重新打开终端。这样可以避免旧环境变量或旧配置继续生效。
进入项目目录并执行：
首次进入时，如果提示是否信任当前工作区，请确认当前目录属于你自己的项目，再按提示继续。
（截图待补）
进入 Claude Code 后，会发现显示 Opus 模型，这是因为我们开启了路由，在输入框输入 /model 后回车，会发现我们刚刚配置的模型，模型名称右边对应在终端显示的 claude 模型。这里默认为第一个，我们选择 deepseek-v4-flash 后回车。
（截图待补）
进入 Claude Code 后，输入简单问题进行验证：
请用一句话说明当前连接已经成功。
（截图待补）
如果模型能够正常回复，说明 Claude Code 已通过 CC Switch 接入国产模型。

八、常见问题#

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

请重新安装 Claude Code CLI。安装完成后关闭终端，再打开新的 PowerShell 或 CMD，并执行 claude --version 检查环境变量是否已生效。

连通性测试失败#

依次检查路由状态、API 端点、API 密钥、模型 ID 和账户额度。尤其注意：有些服务商需要填写带 /v1 的端点，有些服务商则要求使用专用的 Claude 兼容端点，不能仅凭域名猜测。
确认 CC Switch 的路由服务处于 运行中，路由规则已经指向正确的 DeepSeek 或 GLM 配置，并检查本地监听端口没有被防火墙或其他程序拦截。

提示模型不存在或无权访问#

这通常表示模型 ID 写错、模型未开通，或当前密钥没有权限。请从服务商的模型列表复制准确的模型 ID，不要使用其他平台的模型名称。

能测试通过，但 Claude Code 无法正常工作#

确认 CC Switch 中启用的是 Claude Code 配置，并且已经重启终端。还要检查本机是否存在旧的 ANTHROPIC_API_KEY、ANTHROPIC_BASE_URL 或其他 Claude 相关环境变量，它们可能覆盖 CC Switch 的配置。

国产模型回复异常或功能受限#

Claude Code 依赖模型具备较好的工具调用、长上下文和结构化输出能力。部分普通聊天模型可能无法稳定执行代码编辑、命令调用或多轮工具任务。可以更换服务商提供的 Coding、Reasoning 或高能力模型，并重新测试。

是否需要把 DeepSeek 填到 Haiku、Sonnet、Opus 三个字段#

不一定。没有多模型需求时，三个字段可以填写同一个可用模型；如果服务商提供不同速度和能力的模型，再按任务需求分别映射即可。
更新于 2026-11　官方文档：https://code.claude.com/docs/en/setup
修改于 2026-11-06 05:02:26
上一页
CC Switch 导入 koalaapi 令牌(API-KEY)
下一页
n8n 配置使用 koalaapi 教程
Built with