Lumoswitch
客户端接入
Claude Code（实验性）

Claude Code 接入（实验性）

Claude Code 的接入方式取决于当前版本和配置 API 的输出协议。优先复制 Lumoswitch 控制台“客户端接入”页面生成的配置，不要混用不同协议的环境变量。

此接入尚未覆盖所有 Claude Code 版本。请先在非关键项目中验证登录、普通对话和工具调用，再用于正式工作。

使用控制台生成的配置

当前 Lumoswitch 配置生成器会提供以下环境变量：

export OPENAI_API_KEY="your-lumoswitch-access-key"
export OPENAI_BASE_URL="https://your-gateway.example.com/v1"

将变量写入当前 shell 后，从同一个终端启动：

claude

协议要求

  • Base URL 必须指向 Lumoswitch，而不是模型厂商。
  • Access Key 必须来自与目标模型绑定的配置 API。
  • 如果 Claude Code 版本要求 Anthropic 原生协议，应先在配置 API 中选择匹配的下游输出，并以控制台最新生成的配置为准。
  • 不要假定 OpenAI-compatible 输出支持所有 Anthropic 专有参数。

验证环境变量

test -n "$OPENAI_API_KEY" && echo "key loaded"
echo "$OPENAI_BASE_URL"

常见问题

  • 启动后仍要求登录：当前 Claude Code 版本可能未读取自定义提供方变量，请核对控制台生成方式和客户端版本。
  • 401：确认没有把上游 Anthropic Key 填入下游客户端。
  • 模型不可用：先使用相同 Access Key 调用 Lumoswitch /models。
  • 修改变量后无效：完全退出 Claude Code，再从当前终端重新启动。
CodexContinue