新我们如何抓出挂错模型的卖家,并在发生时为你退款。

Claude Code

Claude Code 通过其与 Anthropic 兼容的地址 https://api.martllm.com 与 MartLLM 通信。设置好地址和您的 key 后,Claude Code 的命令和工具将照常工作,并且请求将从您的 MartLLM 余额中扣除。

手动设置

除了 Claude Code 之外,无需运行任何其他程序。在您的 keys page 上创建一个密钥,然后:

export ANTHROPIC_BASE_URL=https://api.martllm.com
export ANTHROPIC_AUTH_TOKEN=ull_your_key
claude

Windows PowerShell:

$env:ANTHROPIC_BASE_URL = "https://api.martllm.com"
$env:ANTHROPIC_AUTH_TOKEN = "ull_your_key"
claude

这仅对当前终端会话有效。要将其永久保存在您的 shell 配置文件中,请将密钥保存到一个只有您可以读取的文件中:

mkdir -p ~/.uberllm && chmod 700 ~/.uberllm
printf '%s\n' 'ull_your_key' > ~/.uberllm/key && chmod 600 ~/.uberllm/key

并将其放入 ~/.claude/settings.json (所有项目) 或 <project>/.claude/settings.local.json (单个项目) 中:

{
  "apiKeyHelper": "cat ~/.uberllm/key",
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.martllm.com"
  }
}

或者使用安装程序

如果您安装了 Node.js,一个命令即可在您的机器上设置 Claude Code 和其他编码工具(Codex CLI、OpenCode 等),并使用与下方安装程序相同的设置:

npx uberllm init

请参阅 uberllm init 了解它会更改什么以及如何撤消更改。

安装程序会为您完成同样的事情,并通过您的浏览器获取 API key。如果您愿意,可以先阅读它:它是一个纯文本文件,位于 martllm.com/install/claude-code.sh。

  • claude-code.sh 的 SHA-256: 34646d5a83e25a1c19057a6bca6aeaaf0118e0e43704d5dbb01e49ab15eb625f
  • claude-code.ps1 的 SHA-256: 5caaa5f15f3e846c535e6668687fe9e0bdcf1e4f9a8a370af09a5137005f44b4

在运行之前检查它:

curl -fsSL https://martllm.com/install/claude-code.sh -o claude-code.sh
shasum -a 256 claude-code.sh   # compare with the hash above
sh claude-code.sh

此计算机上的所有项目:

curl -fsSL https://martllm.com/install/claude-code.sh | sh

仅一个项目(在项目内部运行它;其他项目仍使用您的 Anthropic 计划):

curl -fsSL https://martllm.com/install/claude-code.sh | sh -s -- --project

在 --project 后面添加一个文件夹,以设置当前项目以外的项目。

Windows PowerShell(所有项目):

irm https://martllm.com/install/claude-code.ps1 | iex

您无需事先拥有 API key,粘贴命令时也无需登录。安装程序会在您的浏览器中打开一个链接 (https://martllm.com/cli/link?code=XXXX-XXXX),并在终端中打印相同的确认码。登录,检查代码是否匹配,然后点击 Approve(批准)。

批准后,您的账户会生成一个 API key,并将其交给正在等待的安装程序。您终端中的代码不是密钥:只有发起请求的安装程序才能收集该 key,该 key 只分发一次,并且请求会在 15 分钟后过期。

如果 Claude Code 从未在此计算机上设置过,请先使用所有项目的安装方式。Claude Code 只有在您信任该文件夹后才会读取项目的自身设置,因此全新的安装仍可能要求您登录。

要在不写入任何内容的情况下打印您计算机的设置块:

curl -fsSL https://martllm.com/install/claude-code.sh | sh -s -- --print

安装程序写入的内容

密钥会写入到一个只有您能读取的文件中(文件夹模式 700, 文件模式 600):

安装 密钥文件 设置文件
每个项目 ~/.uberllm/key ~/.claude/settings.json (或 $CLAUDE_CONFIG_DIR/settings.json)
单个项目 ~/.uberllm/key-<folder>-<number> <project>/.claude/settings.local.json

设置文件会获取地址和一个读取密钥文件的 apiKeyHelper。 密钥本身绝不会写入设置文件,因此它不会出现在备份、dotfiles 仓库或屏幕共享中。

{
  "apiKeyHelper": "cat \"/Users/you/.uberllm/key\"",
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.martllm.com",
    "CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY": "1"
  }
}

Claude Code 运行 apiKeyHelper 来获取密钥,并将其作为 Authorization: Bearer 和 x-api-key 发送,因此它能与 MartLLM 等网关配合使用。它会将答案保留五分钟(CLAUDE_CODE_API_KEY_HELPER_TTL_MS 可以更改此设置)。

安装程序会合并到您现有文件中,而不是替换它,因此钩子、权限和 MCP 服务器都会保留,并且它会先将旧文件复制到 <file>.bak-<timestamp>。它会删除旧版安装程序留下的纯文本 ANTHROPIC_AUTH_TOKEN。然后,它会通过网关发出一个真实请求,因此成功消息意味着请求已通过。

Windows 安装程序仍会将密钥写入 settings.json 作为 ANTHROPIC_AUTH_TOKEN。

哪个设置会生效

Claude Code 按以下顺序读取设置,第一个生效的设置优先:

    1. 托管设置(如果您的公司有设置)
    1. claude --settings <file>
    1. <project>/.claude/settings.local.json
    1. <project>/.claude/settings.json
    1. ~/.claude/settings.json

在大多数会话中,设置文件 env 块中的变量优先于您 shell 中的同名变量。这里有两个重要的例外:

  • 密钥。 Claude Code 首先使用 ANTHROPIC_AUTH_TOKEN,然后是 ANTHROPIC_API_KEY,接着是 apiKeyHelper。在您的 shell 中导出的 token 会替换已保存的密钥。
  • 模型。 会话中的 /model 优先,然后是 claude --model,接着是 ANTHROPIC_MODEL,最后是 model 设置。shell 中的 ANTHROPIC_MODEL 优于 model 设置。

因此,请从您的 shell 和 shell 配置文件(~/.zshrc, ~/.bashrc)中移除所有 ANTHROPIC_* 变量,并将它们保存在设置文件中。安装程序在发现此类变量时会发出警告。

使用其他模型

默认情况下,没有模型被固定:Claude Code 会请求它自己的模型名称(opus、sonnet、haiku、claude-opus-5-5…),并且 MartLLM 提供相同的 Claude 模型。要使用 DeepSeek、GLM、Qwen、GPT 或任何其他模型来驱动 Claude Code,请将 Claude Code 的每个模型槽位映射到 env 块中的一个 MartLLM 模型 ID:

变量 它设置什么
ANTHROPIC_MODEL 会话开始时使用的模型。
ANTHROPIC_DEFAULT_OPUS_MODEL opus 的含义。
ANTHROPIC_DEFAULT_SONNET_MODEL sonnet 的含义。
ANTHROPIC_DEFAULT_HAIKU_MODEL haiku 的含义。Claude Code 也将其用于后台工作,例如生成标题和摘要。
CLAUDE_CODE_SUBAGENT_MODEL 子代理运行所使用的模型。
{
  "apiKeyHelper": "cat \"/Users/you/.uberllm/key\"",
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.martllm.com",
    "ANTHROPIC_MODEL": "deepseek/deepseek-v4-pro",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek/deepseek-v4-pro",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek/deepseek-v4-pro",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek/deepseek-v4-flash",
    "CLAUDE_CODE_SUBAGENT_MODEL": "deepseek/deepseek-v4-pro"
  }
}

映射每个槽位。未设置的槽位会继续请求 Claude 模型,并且您需要为此支付 Claude 的价格。

安装程序会通过配置文件为您完成此操作:

curl -fsSL 'https://martllm.com/install/claude-code.sh?profile=glm' | sh

配置文件包括 claude-native(默认,不固定任何模型)、glm、deepseek 和 gpt。如果您手动设置变量,模型表 中的任何模型 ID 都可以使用;GET https://api.martllm.com/v1/models 列出了它们。

上下文和压缩

Claude Code 只知道 Claude 模型的上下文大小。对于任何其他模型,它会假设 200,000 个 token 并在达到此限制前压缩对话。

  • 如果模型具有 1 百万 token 的上下文(其在 martllm.com 上的页面会显示上下文),请在其 ID 末尾添加 [1m],例如 "ANTHROPIC_MODEL": "deepseek/deepseek-v4-pro[1m]" 或 claude --model 'deepseek/deepseek-v4-pro[1m]'。Claude Code 随后会为此规划 1M。
  • 对于任何其他大小,请将 CLAUDE_CODE_MAX_CONTEXT_TOKENS 设置为模型的上下文,例如 "CLAUDE_CODE_MAX_CONTEXT_TOKENS": "400000"。
  • 要选择何时压缩:autoCompactWindow 设置(或 CLAUDE_CODE_AUTO_COMPACT_WINDOW 变量)接受 100,000 到 1,000,000 之间的 token 数量。CLAUDE_AUTOCOMPACT_PCT_OVERRIDE (1–100) 会更早压缩,在该窗口的相应份额处进行。autoCompactEnabled: false 会将其关闭。

将上下文设置得比模型实际拥有的大,会导致对话超出模型限制时请求失败。

有哪些变化

  • 不使用你的 claude.ai 登录账号。 需要该账号的功能(如 claude.ai connectors、/schedule 和 Remote Control)在基于 MartLLM 运行的会话中均无法使用。
  • Claude Code 显示的费用并非你的实际账单。 Claude Code 是根据 Anthropic 的官方标价在你的本地电脑上估算费用的,对于其他模型无法显示有参考价值的数据。你的实际花费请在 控制台 → API Keys → API 使用量 查看。你也可以将余额添加到状态栏(见下文),以便在工作时随时留意。
  • 你的代码会发送给第三方模型提供商。 会话读取的所有内容都会发送给模型,而这些模型是由 MartLLM 市场上的第三方模型提供商运行的。请勿在存有密钥、凭据或客户数据的代码仓库中使用。

状态栏中的余额

curl -fsSL https://martllm.com/install/statusline.sh | sh -s -- --install

这会将一个小脚本保存到 ~/.uberllm/statusline.sh 并将其作为 Claude Code 的 statusLine 添加到 ~/.claude/settings.json 中(在 --install 之后添加 --project,可以将其放入此项目的 .claude/settings.local.json 中)。然后,您会在提示符下方看到:

MartLLM $12.40 · $0.35 held · Opus

这是您的可用余额、正在运行的请求所持有的金额以及模型。它使用 Claude Code 所用的相同 key 读取 GET /v1/balance,最多每分钟一次。它只需要 sh、 curl 和 sed。请先在此处阅读:martllm.com/install/statusline.sh。

验证

启动 Claude Code 并运行 /status:API 地址为 https://api.martllm.com。然后随便向它提问即可;请求会在一分钟内显示在 Dashboard → API Keys → API Usage 中。

同一个 key 也可以通过 Messages API 响应:

curl https://api.martllm.com/v1/messages \
  -H "Authorization: Bearer $(cat ~/.uberllm/key)" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-haiku-4-5","max_tokens":16,"messages":[{"role":"user","content":"ping"}]}'

如果请求失败并报错 Your apiKeyHelper script is failing,则说明 key 文件丢失或无法读取:请重新运行安装程序。


卸载和撤销

curl -fsSL https://martllm.com/install/claude-code.sh | sh -s -- --uninstall

对于单项目安装,请在项目内部运行 sh -s -- --project --uninstall。它会首先备份设置文件,只移除 它添加的内容,并删除保存的密钥文件。Claude Code 在下次启动时会恢复到您的 Anthropic 登录状态。

卸载不会撤销密钥;它只是停止使用密钥。请在您的 密钥页面 上删除密钥,以确保它永远无法 再次使用。对任何您不再信任的计算机执行此操作,或者如果您批准了一个 并非由您发起的请求。