Claude Code

准备 API

在配置之前，请确保已获取以下信息

API Key

以 sk- 开头的字符串。

Base URL (接口地址)

地址：https://api.magikcloud.cn

重要：Claude Code 会自动拼接 /v1/messages，因此 Base URL 不要包含末尾的 /v1。

模型名称

请在模型广场复制完整模型名称，如：DeepSeek-V4-Pro

---

安装 Claude Code

通过 Claude Code 官网 下载并安装。

macOS / Linux / WSL：

curl -fsSL https://claude.ai/install.sh | bash

Windows PowerShell：

irm https://claude.ai/install.ps1 | iex

安装完成后，运行 claude --version 验证是否安装成功。

---

接入 Claude Code

Claude Code 通过 ANTHROPIC_BASE_URL 将请求路由到自定义网关。MagikCloud 提供 Anthropic Messages API 兼容接口，可直接接入。

方式一：配置文件（推荐）

编辑 ~/.claude/settings.json，在 env 块中写入以下配置：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.magikcloud.cn",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的API密钥",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "GLM-5.1",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "GLM-5.1",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "GLM-5.1"
  }
}

方式二：环境变量

在终端中设置环境变量后启动 Claude Code：

export ANTHROPIC_BASE_URL="https://api.magikcloud.cn"
export ANTHROPIC_AUTH_TOKEN="sk-你的API密钥"
export ANTHROPIC_DEFAULT_SONNET_MODEL="GLM-5.1"
export ANTHROPIC_DEFAULT_OPUS_MODEL="GLM-5.1"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="GLM-5.1"

claude

关键字段说明

字段	说明
ANTHROPIC_BASE_URL	接口地址，填写 https://api.magikcloud.cn，不要带 /v1
ANTHROPIC_AUTH_TOKEN	API 密钥，以 sk- 开头，通过 Authorization: Bearer 头发送
ANTHROPIC_DEFAULT_SONNET_MODEL	Sonnet 档位使用的模型名称
ANTHROPIC_DEFAULT_OPUS_MODEL	Opus 档位使用的模型名称
ANTHROPIC_DEFAULT_HAIKU_MODEL	Haiku 档位使用的模型名称

注意： 三个 ANTHROPIC_DEFAULT_*_MODEL 变量建议都设置为 MagikCloud 上实际可用的模型名称（如 GLM-5.1 / DeepSeek-V4-Pro / MiniMax-M2.7），否则 Claude Code 可能请求不存在的模型。

验证配置

启动 Claude Code 后，运行 /status 查看当前使用的 Base URL 和鉴权来源是否正确。

使用模型

在 Claude Code 中输入 /model 切换模型档位（Sonnet / Opus / Haiku），各档位将使用你在配置中指定的模型名称。