跳到主要内容

Claude Code 接入 FluxLane API

本文档介绍在 macOS 与 Windows 中安装 Claude Code CLI,并通过 CC Switch 添加 FluxLane 自定义供应商,使 Claude Code 经 FluxLane API 调用 Claude 及 GPT、GLM、DeepSeek 等模型。

准备工作​

系统要求​

项目macOSWindows
操作系统macOS 13 或更新版本Windows 10 1809 或更新版本(建议 Windows 11)
内存4GB 以上4GB 以上
终端Terminal(系统自带)PowerShell(系统自带)
Git推荐安装推荐安装 Git for Windows

macOS 建议安装 Homebrew 与 Git​

  1. 安装 Homebrew(如已安装可跳过):
    bash
    /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
  2. 安装 Git:
    bash
    brew install git
  3. 验证:
    bash
    git --version
    正常显示版本号即表示安装成功。

Windows 建议安装 Git for Windows​

下载并运行 Git for Windows 安装程序,使用默认选项完成安装。安装后在 PowerShell 中验证:git --version。

Node.js 与 npm 不是必需依赖。Claude Code 已提供原生安装方式,无需预先安装 Node.js。

安装 Claude Code CLI​

macOS​

  1. 打开终端,执行:
    bash
    curl -fsSL https://claude.ai/install.sh | bash
  2. 安装完成后关闭当前终端,重新打开一个终端窗口。
  3. 验证安装:
    bash
    claude --version
    claude doctor

Windows​

  1. 打开 PowerShell(非 CMD),执行:
    powershell
    irm https://claude.ai/install.ps1 | iex
  2. 安装完成后关闭当前 PowerShell,重新打开一个新的窗口。
  3. 验证安装:
    powershell
    claude --version
    claude doctor
    若提示找不到 claude 命令,关闭并重新打开 PowerShell;仍无法识别时,检查 Claude Code 安装目录是否已加入 PATH。

安装 CC Switch​

CC Switch 是一款开源 AI 编程工具配置管理软件,用于管理 Claude Code、Codex、OpenCode 等工具的模型供应商,无需手动编辑配置文件。

  1. 访问 CC Switch 官方网站,按操作系统下载对应版本(macOS 区分 Apple Silicon / Intel,Windows ARM 架构电脑需选择 ARM 版本)。
  2. 运行安装包,按提示完成安装。
  3. 启动 CC Switch。在 AI 列表中选择 Claude Code,而非 Claude Desktop(两者的配置入口和配置文件不同)。

创建 FluxLane API Key​

  1. 登录 Fluxlane 控制台,进入「API 密钥」页面,创建新的 API Key。
  2. (可选)在创建时的「高级配置」中选择目标模型,如 Claude Opus 5.5、OpenAI GPT 或 GLM 5.3 等。
  3. 复制并保存 API Key。
  4. 在模型广场(fluxlane.ai/pricing)确认目标模型的实际模型 ID、可用状态及计费信息。CC Switch 中填写的模型名称须与模型广场一致。

在 CC Switch 中添加 FluxLane 供应商​

第 1 步:新建供应商​

在 CC Switch 中选择 Claude Code,点击界面右上角的「添加供应商」(通常为 + 按钮),在预设列表中选择「自定义配置」。不同版本 CC Switch 的文字可能略有差异,按自定义配置入口进入即可。

第 2 步:填写 FluxLane API 配置​

在配置编辑区域填写以下参数:

字段值
API Key从 FluxLane 控制台复制的 Key
Base URLhttps://run.fluxlane.ai
模型名称 / 模型 IDFluxLane 模型广场中的实际模型 ID(如 claude-opus-5.5、glm-5.3)

注意:Base URL 填写 FluxLane 的 API 根地址,CC Switch 会自动将其写入 Claude Code 的配置,无需手动拼接 /v1/messages 等路径。

第 3 步:保存并启用​

  1. 保存配置。返回 Claude Code 的供应商列表,可见刚创建的 FluxLane 条目。
  2. 点击该供应商卡片,将其切换为当前使用的供应商。
  3. 确认 CC Switch 界面上的路由开关处于开启状态。

CC Switch 会将 FluxLane 的接口地址和密钥写入 Claude Code 配置文件,无需手动编辑 settings.json。

启动 Claude Code 并测试​

  1. 确认 FluxLane 供应商处于「使用中」状态,路由开关已开启。
  2. 打开终端 / PowerShell,执行:
    bash
    claude
  3. 首次启动如出现项目安全确认,确认项目目录后按提示完成信任设置。
  4. 发送一条测试指令(如要求分析当前目录结构)。正常返回分析结果即表示调用成功。
  5. 登录 FluxLane 控制台,在「使用日志」中确认请求记录与用量。

参考文档