Claude Code

本页介绍 Claude Code CLI 的网关配置。请先按官方安装说明安装客户端。

接入前提

选择通过网关提供的 Claude 模型，并确认渠道支持 Anthropic Messages 协议、流式输出与工具调用。普通 Chat Completions 调用成功，不代表 Claude Code 一定可用。先在控制台确认对应分组和渠道的支持情况。

设置环境变量

在准备运行 claude 的同一终端中设置以下变量，再替换密钥和模型占位符。

Windows PowerShell

$env:ANTHROPIC_BASE_URL = "https://api.beanc.cn"
$env:ANTHROPIC_AUTH_TOKEN = "YOUR_API_KEY_HERE"
$env:ANTHROPIC_MODEL = "YOUR_MODEL_ID"
claude

macOS / Linux

export ANTHROPIC_BASE_URL="https://api.beanc.cn"
export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY_HERE"
export ANTHROPIC_MODEL="YOUR_MODEL_ID"
claude

ANTHROPIC_BASE_URL 填根地址，不包含 /v1；客户端追加 Messages 路径。ANTHROPIC_AUTH_TOKEN 填密钥本身，客户端会添加 Bearer 前缀。

这些命令只影响当前终端会话。已有其他服务商配置时，检查已有环境变量与客户端设置，避免多个认证来源混用；不要输出完整环境变量来排查。

验证方式

在一个测试项目中启动，先请求解释一小段代码，再尝试一次你授权的简单工具操作。确认控制台日志中的模型和分组符合预期。

客户端可能为后台任务选择其他模型。只有在对应分组确实提供这些模型时才配置模型别名映射；具体设置见官方的模型配置说明。

遇到不兼容

若报错涉及 /v1/messages、Token 计数、beta 参数或工具字段，保留脱敏后的错误正文与客户端版本，核对网关及上游对该功能的支持。不要仅通过改模型显示名称或关闭报错提示来判断接入成功。

官方参考：Connect Claude Code to an LLM gateway，“Set the base URL and credential / Verify the connection”；Gateway compatibility guide，协议要求；Environment variables，上述变量；Model configuration，模型选择与别名。