Claude Code

Claude Code 是 Anthropic 推出的运行在终端中的智能体编程工具。它可以理解你的代码库、编辑文件、运行命令并处理复杂的开发任务。通过将其指向 Hugging Face 推理提供商 (Inference Providers)，你可以使用任何最新的可用开源模型作为底层 LLM。

概述

Claude Code 支持通过环境变量自定义 API 端点。通过将 ANTHROPIC_BASE_URL 设置为 Hugging Face 路由并提供你的 HF token，所有 Claude Code 请求都将通过推理提供商路由，从而让你能够访问广泛的开源模型。

先决条件

• 已安装 Claude Code CLI (安装指南)
• 拥有 API 令牌 (API token) 的 Hugging Face 账户（需要具有 “Make calls to Inference Providers” 权限）

配置

方案 1：使用 hf-claude 扩展（推荐）

hf CLI 的 hf-claude 扩展提供了一个交互式的模型和提供商选择器，可以预配置好正确环境变量并启动 Claude Code。

1. 确保你已设置 HF_TOKEN

export HF_TOKEN="hf_..."

2. 安装扩展

hf extensions install hanouticelina/hf-claude

3. 通过 hf 启动 Claude Code

hf claude

该扩展将显示一个交互式选择器，你可以在其中从可用的推理提供商模型中选择一个模型，并可选地选择一个特定的提供商。随后，它将设置所有必要的环境变量并启动 Claude Code。

你还可以将任何额外参数传递给 Claude Code

hf claude --help

方案 2：手动设置环境变量

在启动 Claude Code 之前设置以下环境变量

export ANTHROPIC_BASE_URL="https://router.huggingface.co"
export ANTHROPIC_AUTH_TOKEN="${HF_TOKEN}"
export ANTHROPIC_API_KEY="${HF_TOKEN}"
export ANTHROPIC_DEFAULT_OPUS_MODEL="zai-org/GLM-5.1"
export ANTHROPIC_DEFAULT_SONNET_MODEL="zai-org/GLM-5.1"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="zai-org/GLM-5.1"
export CLAUDE_CODE_SUBAGENT_MODEL="zai-org/GLM-5.1"

然后启动 Claude Code

claude

将 zai-org/GLM-5.1 替换为 推理提供商上提供的任何模型。你也可以添加提供商后缀来指定特定的提供商（例如 MiniMaxAI/MiniMax-M2.7:fireworks-ai）。设置明确的提供商可实现确定性路由，而省略它（例如 MiniMaxAI/MiniMax-M2.7）则使用默认的 :fastest 策略。在该策略下，路由器会选择吞吐量最高的提供商，并在该提供商不可用时自动进行故障转移。

可用策略包括 :cheapest、:fastest 或 :preferred；使用这些后缀之一来优先选择更便宜、更快或你偏好顺序的提供商（例如 MiniMaxAI/MiniMax-M2.7:cheapest）。

ANTHROPIC_DEFAULT_*_MODEL 变量映射到 Claude Code 的内部模型插槽（Opus, Sonnet, Haiku），按能力从最强到最快排列。你可以为每个插槽分配不同的模型以平衡能力和速度，例如：Opus 使用 zai-org/GLM-5.1，Sonnet 使用 google/gemma-4-31B-it:together，Haiku 使用 openai/gpt-oss-120b:cerebras。CLAUDE_CODE_SUBAGENT_MODEL 控制子智能体所使用的模型。

资源

• Claude Code 文档
• hf-claude 扩展
• 推理提供商上的可用模型