OpenCode / Claude Code安装 CC Switch 配置智谱和deepseek大模型教程

目标：在本地安装 Claude Code 与 OpenCode 两款 AI 编程终端，并通过 CC Switch 一键切换后端大模型（智谱 GLM 与 DeepSeek），无需每次手敲环境变量。
适用系统：Windows 11（macOS / Linux 步骤基本一致，仅路径与命令差异）。
编写日期：2026-07-04

目录

  1. 整体思路与流程图
  2. 前置准备：安装 Node.js
  3. 安装 Claude Code
  4. 安装 OpenCode
  5. 安装 CC Switch（配置管理利器）
  6. 在 CC Switch 中配置智谱 GLM
  7. 在 CC Switch 中配置 DeepSeek
  8. 一键切换并验证
  9. OpenCode 单独配置（可选）
  10. 常见问题排查

1. 整体思路与流程图

Claude Code 和 OpenCode 都需要一个 Anthropic Messages API 格式的端点。智谱官方提供了 Anthropic 兼容端点，可直接对接；DeepSeek 官方仅提供 OpenAI 兼容端点，需要通过转换层（如 claude-code-router）或支持 Anthropic 协议的中转服务对接。

CC Switch 的作用是：把多个"提供商配置"（Base URL + Token + 模型名）保存下来，一键写入到 ~/.claude/settings.json 的环境变量里，省去手动改配置。

┌──────────────────────────────────────────────────────────┐
│                      你的终端                             │
│   claude (Claude Code)        opencode (OpenCode)         │
└────────────┬─────────────────────────┬────────────────────┘
             │ 读取环境变量             │ 读取 opencode.json
             │ ANTHROPIC_BASE_URL      │ / settings
             │ ANTHROPIC_AUTH_TOKEN    │
             ▼                         ▼
┌──────────────────────────────────────────────────────────┐
│                  CC Switch（GUI 管理）                    │
│   [智谱 GLM]  [DeepSeek]  [官方 Claude]  ...一键切换       │
└────────────┬─────────────────────────────────────────────┘
             │ 写入 ~/.claude/settings.json
             ▼
┌──────────────────────┐       ┌──────────────────────────┐
│  智谱 Anthropic 端点  │       │  DeepSeek（经 router 转换）│
│ open.bigmodel.cn     │       │  或 Anthropic 兼容中转     │
│  模型: glm-4.6        │       │  模型: deepseek-chat       │
└──────────────────────┘       └──────────────────────────┘

2. 前置准备：安装 Node.js

Claude Code 与 OpenCode 都依赖 Node.js（建议 v18+，推荐 v20 LTS）。

  1. 打开官网下载：https://nodejs.org/zh-cn
  2. 下载 LTS 版本安装包（.msi），双击安装，一路"下一步"即可，勾选 “Add to PATH”。
  3. 验证安装。打开 PowerShell 或 Git Bash，执行：
node -v
npm -v

能看到版本号（如 v20.x.x / 10.x.x）即成功。

配置 npm 国内镜像（可选，加速下载）：

npm config set registry https://registry.npmmirror.com

3. 安装 Claude Code

Claude Code 是 Anthropic 官方 CLI，通过 npm 全局安装：

npm install -g @anthropic-ai/claude-code

验证：

claude --version

进入任意项目目录，输入 claude 即可启动。首次启动会要求登录官方账号——如果你想用智谱/DeepSeek，跳过登录，直接按 Ctrl+C 退出即可，后面用 CC Switch 配置环境变量来接管。

4. 安装 OpenCode

OpenCode 是开源的 AI 编程终端（SST 出品），同样支持自定义后端。

方式一：npm 安装（推荐，跨平台）

npm install -g opencode-ai

方式二：一键脚本（macOS / Linux）

curl -fsSL https://opencode.ai/install | bash

验证：

opencode --version

进入项目目录运行 opencode 启动。

5. 安装 CC Switch（配置管理利器）

CC Switch（claude-code-switch）是一个桌面 GUI 工具，用于管理多套 Claude Code 提供商配置并一键切换。

方式一：下载桌面版（推荐，Windows 用户）

  1. 前往发布页：https://github.com/farion1231/claude-code-switch/releases
  2. 下载最新版的 CC-Switch_x.x.x_x64-setup.exe（或免安装版 .exe）
  3. 双击安装，启动后会出现图形界面

方式二：源码运行（开发者）

git clone https://github.com/farion1231/claude-code-switch.git
cd claude-code-switch
npm install
npm run dev

启动后的界面大致如下（示意图）：

┌─────────────────────────────────────────────┐
│  CC Switch                          [设置]  │
├─────────────────────────────────────────────┤
│  提供商列表                                  │
│  ┌───────────────────────────────────────┐  │
│  │ ● 智谱 GLM         [当前激活] [编辑]  │  │
│  │ ○ DeepSeek                        [编辑] │  │
│  │ ○ 官方 Claude                     [编辑] │  │
│  └───────────────────────────────────────┘  │
│  [ + 新增提供商 ]      [一键切换并应用 ]    │
└─────────────────────────────────────────────┘

CC Switch 实际上是在读写 C:\Users\<你的用户名>\.claude\settings.json，把选中提供商的 ANTHROPIC_BASE_URL、ANTHROPIC_AUTH_TOKEN、ANTHROPIC_MODEL 等写进去。

6. 在 CC Switch 中配置智谱 GLM

智谱官方提供了 Anthropic 兼容端点，可以直接对接 Claude Code，无需转换层。

6.1 获取 API Key

  1. 登录智谱开放平台：https://open.bigmodel.cn/
  2. 进入「API Keys」页面 → 「创建 API Key」→ 复制保存（形如 xxxxxxxx.xxxxxxxx）

6.2 在 CC Switch 新增提供商

点击「+ 新增提供商」，按下表填写：

字段 值
名称 智谱 GLM
Base URL https://open.bigmodel.cn/api/anthropic
API Key 你刚复制的智谱 Key
模型 (Model) glm-4.6（也可填 glm-4.5）
API 类型 Anthropic

保存即可。

如果不使用 CC Switch，手动写入 C:\Users\<用户名>\.claude\settings.json：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://open.bigmodel.cn/api/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "你的智谱Key",
    "ANTHROPIC_MODEL": "glm-4.6",
    "ANTHROPIC_SMALL_FAST_MODEL": "glm-4.6"
  }
}

7. 在 CC Switch 中配置 DeepSeek

DeepSeek 官方 API（https://api.deepseek.com）是 OpenAI 兼容格式，而 Claude Code 需要 Anthropic 格式。因此有两种方案：

方案 A：使用 claude-code-router 转换（推荐，官方 Key 直连）

claude-code-router 是一个本地代理，把 Anthropic 协议转成 OpenAI 协议，从而让 DeepSeek 接入 Claude Code。

  1. 安装路由：
npm install -g @musistudio/claude-code-router
  1. 编辑配置文件 C:\Users\<用户名>\.claude-code-router\config.json：
{
  "Providers": [
    {
      "name": "deepseek",
      "api_base_url": "https://api.deepseek.com/v1/chat/completions",
      "api_key": "你的DeepSeek Key",
      "models": ["deepseek-chat", "deepseek-reasoner"]
    }
  ],
  "Router": {
    "default": "deepseek,deepseek-chat"
  }
}
  1. 启动路由（保持终端开启，或用 ccr code 直接接管）：
ccr start
  1. 在 CC Switch 中新增提供商：
字段 值
名称 DeepSeek (本地路由)
Base URL http://127.0.0.1:3456
API Key deepseek（占位即可，真实 Key 在 router 里）
模型 deepseek-chat
API 类型 Anthropic

方案 B：使用支持 Anthropic 协议的中转服务

如果你用的是某些聚合中转站（已提供 Anthropic 兼容端点），则直接像智谱那样填：

字段 值
名称 DeepSeek (中转)
Base URL https://你的中转站域名/anthropic
API Key 中转站提供的 Key
模型 deepseek-chat
API 类型 Anthropic

7.1 获取 DeepSeek 官方 Key

  1. 登录 https://platform.deepseek.com/
  2. 「API Keys」→「创建 API Key」→ 复制（形如 sk-xxxxxxxx）

8. 一键切换并验证

  1. 在 CC Switch 中点击你想用的提供商（如「智谱 GLM」），点击 「应用 / 切换」。
  2. 关闭已打开的 claude / opencode 终端（环境变量在启动时读取，需重启生效）。
  3. 在项目目录下启动：
claude

输入一句测试：

请用一句话介绍你自己，并说明当前使用的模型

如果能正常返回，说明配置成功 ✅

切换流程图

打开 CC Switch
   │
   ├── 选择「智谱 GLM」→ 应用 → 重启 claude → 使用 GLM-4.6
   │
   └── 选择「DeepSeek」→ 应用 → 重启 claude → 使用 deepseek-chat

9. OpenCode 单独配置（可选）

OpenCode 不读 ~/.claude/settings.json，需单独配置。在项目根目录创建 opencode.json：

使用智谱：

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "zhipu": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "智谱 GLM",
      "options": {
        "baseURL": "https://open.bigmodel.cn/api/paas/v4"
      },
      "models": {
        "glm-4.6": { "name": "GLM-4.6" }
      }
    }
  },
  "model": "zhipu/glm-4.6"
}

并设置环境变量（PowerShell）：

$env:ZHIPU_API_KEY="你的智谱Key"
opencode

使用 DeepSeek：

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "deepseek": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "DeepSeek",
      "options": {
        "baseURL": "https://api.deepseek.com/v1"
      },
      "models": {
        "deepseek-chat": { "name": "DeepSeek V3" },
        "deepseek-reasoner": { "name": "DeepSeek R1" }
      }
    }
  },
  "model": "deepseek/deepseek-chat"
}

$env:DEEPSEEK_API_KEY="你的DeepSeek Key"
opencode

提示：OpenCode 的提供商名（如 zhipu、deepseek）会作为环境变量名前缀，所以对应的环境变量是 ZHIPU_API_KEY、DEEPSEEK_API_KEY。

10. 常见问题排查

现象 原因 / 解决
claude 启动后仍要求登录官方账号 settings.json 未生效，检查路径是否为 C:\Users\<用户名>\.claude\settings.json，且 JSON 格式无误
报错 401 Unauthorized API Key 错误或过期；智谱注意 Key 是否还有额度
报错 404 或 model not found 模型名拼写错误，智谱用 glm-4.6，DeepSeek 用 deepseek-chat
DeepSeek 报协议错误 没走 router，DeepSeek 官方端点不兼容 Anthropic，需用方案 A 或 B
切换后模型没变 没重启 claude 进程；环境变量在启动时读取，必须退出重进
CC Switch 写入后丢失 被其他工具（如官方登录）覆盖；切换时先关闭 claude

参考链接

小结：Claude Code + CC Switch 适合需要频繁切模型、用官方 Anthropic 协议的用户；OpenCode 适合喜欢开源、想用 OpenAI 兼容协议直连各家模型的用户。两者可并存，按场景选用。

# 人工智能
Logo
https://edu.csdn.net/learn/39067/627173?utm_source=2019755004

汇聚全球AI编程工具，助力开发者即刻编程。

更多推荐

cover

Claude Code 实战：AI 结对编程如何真正提效，用业务场景检验技术取舍

avatar AI编程社区
cover

【vibe coding 第五部分】完整项目案例实操（微型商城）

avatar AI编程社区
cover

Codex 实战：AI 编程助手接入真实项目，把核心能力写进作品集

avatar AI编程社区