Mafdet AI 帮助中心
English

Claude Code 配置

Claude Code（Anthropic 的 CLI 编程智能体）使用 Anthropic 协议。Mafdet AI 网关在 /v1/messages 上原生支持该协议，因此只需设置环境变量即可接入， 无需改任何配置文件。

配置

将以下内容加入 shell 配置文件（或在终端中执行），然后启动 claude：

export ANTHROPIC_BASE_URL="https://api.mafdet.ai"
export ANTHROPIC_AUTH_TOKEN="sk-mafdet-xxxxxxxxxxxxxxxx"
export ANTHROPIC_MODEL="deepseek-v4-pro"
export ANTHROPIC_SMALL_FAST_MODEL="deepseek-v4-flash"
claude
  • ANTHROPIC_BASE_URL 不要带 /v1 —— Claude Code 会自己拼接 /v1/messages
  • ANTHROPIC_AUTH_TOKEN 填你的 Mafdet AI Key（建议用环境变量，不要写进文件）
  • ANTHROPIC_MODEL 填 Mafdet AI 的模型 ID（见 模型总览）；DeepSeek V4、Kimi 等编程向模型效果最好
  • ANTHROPIC_SMALL_FAST_MODEL 承担 Claude Code 的轻量后台调用 —— 选便宜的快速模型可以控制成本

也可以在 控制台 → API Keys → 开发者工具 里按所选模型直接生成这段配置。 通过 /v1/messages 的用量与 OpenAI 兼容端点一样计费。

常见错误

现象含义处理
401Key 错误或格式不对检查 ANTHROPIC_AUTH_TOKEN
404Base URL 带了 /v1改为 https://api.mafdet.ai（不带 /v1）
429触发限流（RPM/TPM）编程智能体需要高 TPM 限额的 Key
insufficient_credit余额不足见 余额与用量

下一步