MuxLLM
开始使用

Client Guide · Anthropic

Claude Code

使用 Claude 原生 Messages 协议连接 MuxLLM。模型必须在模型广场显示 anthropic 标签，不能用模型名称猜测协议兼容性。

开始配置 核对模型标签

Scope & Evidence

先确认协议，不按名称猜模型

Claude Code 面向 Anthropic Messages 请求。MuxLLM 上只有明确显示 anthropic 标签的模型才进入本教程适用范围；显示其他标签但名称中含有 Claude 的模型，不视为已兼容。

等级本页状态含义
E1运行态公开信息已核对模型必须带 anthropic 标签；Base URL 使用站点根地址。
E2官方配置规则已核对安装、环境变量与设置位置依据 Claude Code 官方文档整理。
E3本批未执行未使用 MuxLLM Key 启动 Claude Code 或发送真实请求，不能声称已完成接入实测。

最后核验日期：2026-07-18。模型、分组与客户端字段可能动态变化，执行配置前应重新查看模型广场和客户端官方文档。

Install

安装与前置条件

  1. 准备受支持的终端环境，并确认网络可以访问 https://api.muxllm.com。
  2. 从 Claude Code 官方安装页选择当前系统对应的安装方式。不要从不明镜像下载二进制文件。
  3. 安装完成后运行 claude --version，只检查本地版本；该命令不会消耗模型额度。
  4. 升级已有安装前先查看官方变更说明，记录当前版本，便于出现兼容问题时恢复。
官方 npm 安装方式
npm install -g @anthropic-ai/claude-code
claude --version
不要混装同一台机器如果同时存在 npm、Homebrew 或原生安装版本，Shell 可能调用到旧路径。先用 command -v claude 确认实际执行文件，再处理升级或卸载。

Credential & Model

为 Claude Code 创建独立 Key

  1. 登录 MuxLLM API 站点，在令牌页面新建仅供 Claude Code 使用的 Key。
  2. 按使用场景设置合理额度与过期时间，不与生产服务、其他客户端或他人共用。
  3. 打开模型广场，筛选或检查端点标签，复制一个带 anthropic 标签的精确模型 ID。
  4. 用 YOUR_API_KEY 和 MODEL_NAME 作为占位符准备配置；不要把真实 Key 粘贴到工单、聊天或截图中。
模型边界MODEL_NAME 必须逐字匹配模型广场。价格、上下文和可用分组以执行当时的模型广场为准，本页不固定动态模型清单。

Session Setup

先在单个终端会话中试配

临时环境变量只作用于当前 Shell，关闭终端即可自然失效，适合首次验证。Base URL 不追加 /v1，由 Claude Code 拼接 Anthropic 路径。

macOS / Linux Shell
export ANTHROPIC_BASE_URL="https://api.muxllm.com"
export ANTHROPIC_API_KEY="YOUR_API_KEY"
export ANTHROPIC_MODEL="MODEL_NAME"

claude
Windows PowerShell
$env:ANTHROPIC_BASE_URL="https://api.muxllm.com"
$env:ANTHROPIC_API_KEY="YOUR_API_KEY"
$env:ANTHROPIC_MODEL="MODEL_NAME"

claude
变量差异某些企业网关教程使用 ANTHROPIC_AUTH_TOKEN。不要同时设置多套凭证变量；本教程采用 ANTHROPIC_API_KEY。若当前 Claude Code 版本明确要求其他认证变量，应以该版本官方文档为准并重新验证请求头。

Persistent Setup

临时验证后再持久化

  1. 先备份现有 Shell 配置文件，例如 ~/.zshrc、~/.bashrc 或 PowerShell Profile。
  2. 只把 Base URL 和模型名写入可长期维护的配置；Key 优先交给系统密钥管理器或可信的本地秘密注入方式。
  3. 如果确需通过 Shell Profile 注入 Key，确保文件仅当前用户可读，并确认它不在 Git 仓库中。
  4. 加载配置后重新打开终端，避免旧 Claude Code 进程继续读取先前环境。
非敏感 Shell 配置示例
export ANTHROPIC_BASE_URL="https://api.muxllm.com"
export ANTHROPIC_MODEL="MODEL_NAME"

# ANTHROPIC_API_KEY 由本地秘密管理方式注入，不在此文件写入真实值。

不要把用户级凭证写进项目的 CLAUDE.md、仓库脚本或共享设置。项目指令与认证信息应分开管理。

Acceptance

按层验证，避免直接跑复杂任务

  1. 01检查本地命令

    claude --version 能返回版本，且执行路径符合预期。

  2. 02检查变量存在

    只确认变量是否已设置，不在屏幕、日志或录屏中打印完整 Key。

  3. 03最短文本请求

    启动新会话，仅要求返回一个短词，不启用 MCP、工具或长上下文。

  4. 04核对用量

    在 MuxLLM 控制台确认请求落到独立 Key 和预期模型，再逐步开启功能。

本页未代执行上述第 3、4 步会产生真实请求和可能的费用。本批文档工作没有执行，因此页面证据仍停留在 E1 + E2。

Rollback

恢复到配置前状态

  1. 退出所有 Claude Code 会话，避免仍在运行的进程继续使用旧环境。
  2. 删除本次新增的 Shell Profile 行，或恢复执行前备份。
  3. 在当前 Shell 中清除三个变量；PowerShell 使用 Remove-Item Env: 对应变量。
  4. 如果独立 Key 不再使用，在 MuxLLM 控制台将其禁用或删除，并确认没有其他程序依赖它。
macOS / Linux 清理当前会话
unset ANTHROPIC_BASE_URL
unset ANTHROPIC_API_KEY
unset ANTHROPIC_MODEL

Troubleshooting

401、404、429 与模型错误

现象优先检查处理顺序
401 / 认证失败Key 是否有效、当前进程是否读取正确变量、是否被旧变量覆盖新开终端 → 重新注入独立 Key → 检查 Key 状态；不要在命令历史中回显真实值。
404 / 路径不存在Base URL 是否误写为 .../v1 或手工附加 Messages 路径恢复为 https://api.muxllm.com，由客户端拼接请求路径。
429 / 请求受限余额、Key 额度、渠道并发与上游限速停止连续重试 → 查看控制台状态 → 按错误信息等待；不要用无限重试放大费用。
model not found模型名拼写、分组权限、anthropic 标签从模型广场重新复制 MODEL_NAME，不要增加厂商前缀或别名。
启动后仍走旧站点已有进程、多个安装路径、Shell Profile 中重复变量退出进程 → command -v claude → 清理重复变量 → 新开终端。

Security

凭证、工具权限和日志边界

  • 每台设备、每个客户端使用独立 Key；设置最小额度、有效期和可撤销边界。
  • 不要把真实 Key 写入 CLAUDE.md、Git 配置、代码示例、终端截图或问题反馈。
  • 首次连接只做文本请求；确认模型和计费后再启用文件写入、Shell、MCP 或其他高权限工具。
  • 排查日志时只保留时间、状态码、请求路径和脱敏请求 ID，删除 Authorization、正文与个人数据。
  • 怀疑泄露时立即停用 Key，再创建新 Key；仅修改本地变量不能使已泄露凭证失效。

Next Guide

继续查看其他客户端

不同 CLI 使用不同协议；切换客户端时必须重新核对 Base URL 和端点标签。

下一篇：Codex返回客户端目录