Claude Code 接入 FluxLane API
本文档介绍在 macOS 与 Windows 中安装 Claude Code CLI,并通过 CC Switch 添加 FluxLane 自定义供应商,使 Claude Code 经 FluxLane API 调用 Claude 及 GPT、GLM、DeepSeek 等模型。
准备工作
系统要求
| 项目 | macOS | Windows |
|---|---|---|
| 操作系统 | macOS 13 或更新版本 | Windows 10 1809 或更新版本(建议 Windows 11) |
| 内存 | 4GB 以上 | 4GB 以上 |
| 终端 | Terminal(系统自带) | PowerShell(系统自带) |
| Git | 推荐安装 | 推荐安装 Git for Windows |
macOS 建议安装 Homebrew 与 Git
- 安装 Homebrew(如已安装可跳过):
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
- 安装 Git:
brew install git
- 验证:
正常显示版本号即表示安装成功。git --version
Windows 建议安装 Git for Windows
下载并运行 Git for Windows 安装程序,使用默认选项完成安装。安装后在 PowerShell 中验证:git --version。
Node.js 与 npm 不是必需依赖。Claude Code 已提供原生安装方式,无需预先安装 Node.js。
安装 Claude Code CLI
macOS
- 打开终端,执行:
curl -fsSL https://claude.ai/install.sh | bash
- 安装完成后关闭当前终端,重新打开一个终端窗口。
- 验证安装:
claude --versionclaude doctor
Windows
- 打开 PowerShell(非 CMD),执行:
irm https://claude.ai/install.ps1 | iex
- 安装完成后关闭当前 PowerShell,重新打开一个新的窗口。
- 验证安装:
若提示找不到claude --versionclaude doctor
claude命令,关闭并重新打开 PowerShell;仍无法识别时,检查 Claude Code 安装目录是否已加入 PATH。
安装 CC Switch
CC Switch 是一款开源 AI 编程工具配置管理软件,用于管理 Claude Code、Codex、OpenCode 等工具的模型供应商,无需手动编辑配置文件。
- 访问 CC Switch 官方网站,按操作系统下载对应版本(macOS 区分 Apple Silicon / Intel,Windows ARM 架构电脑需选择 ARM 版本)。
- 运行安装包,按提示完成安装。
- 启动 CC Switch。在 AI 列表中选择 Claude Code,而非 Claude Desktop(两者的配置入口和配置文件不同)。
创建 FluxLane API Key
- 登录 Fluxlane 控制台,进入「API 密钥」页面,创建新的 API Key。
- (可选)在创建时的「高级配置」中选择目标模型,如 Claude Opus 5.5、OpenAI GPT 或 GLM 5.3 等。
- 复制并保存 API Key。
- 在模型广场(
fluxlane.ai/pricing)确认目标模型的实际模型 ID、可用状态及计费信息。CC Switch 中填写的模型名称须与模型广场一致。
在 CC Switch 中添加 FluxLane 供应商
第 1 步:新建供应商
在 CC Switch 中选择 Claude Code,点击界面右上角的「添加供应商」(通常为 + 按钮),在预设列表中选择「自定义配置」。不同版本 CC Switch 的文字可能略有差异,按自定义配置入口进入即可。
第 2 步:填写 FluxLane API 配置
在配置编辑区域填写以下参数:
| 字段 | 值 |
|---|---|
| API Key | 从 FluxLane 控制台复制的 Key |
| Base URL | https://run.fluxlane.ai |
| 模型名称 / 模型 ID | FluxLane 模型广场中的实际模型 ID(如 claude-opus-5.5、glm-5.3) |
注意:Base URL 填写 FluxLane 的 API 根地址,CC Switch 会自动将其写入 Claude Code 的配置,无需手动拼接 /v1/messages 等路径。
第 3 步:保存并启用
- 保存配置。返回 Claude Code 的供应商列表,可见刚创建的 FluxLane 条目。
- 点击该供应商卡片,将其切换为当前使用的供应商。
- 确认 CC Switch 界面上的路由开关处于开启状态。
CC Switch 会将 FluxLane 的接口地址和密钥写入 Claude Code 配置文件,无需手动编辑 settings.json。
启动 Claude Code 并测试
- 确认 FluxLane 供应商处于「使用中」状态,路由开关已开启。
- 打开终端 / PowerShell,执行:
claude
- 首次启动如出现项目安全确认,确认项目目录后按提示完成信任设置。
- 发送一条测试指令(如要求分析当前目录结构)。正常返回分析结果即表示调用成功。
- 登录 FluxLane 控制台,在「使用日志」中确认请求记录与用量。
参考文档