模型聚合服务平台

外观

Claude Code ​

应用介绍 ​

Claude Code 是运行在终端中的编程智能体，可以阅读代码库、解释代码、修改文件、执行命令并协助完成开发任务。它适合希望直接在命令行中进行项目级编码和调试的用户。Claude Code 支持通过 Anthropic 兼容接口接入模型聚合服务平台，本教程使用用户级 settings.json 保存连接配置。

准备信息 ​

text
Anthropic Base URL：https://ai.example.edu.cn
API Key：你的 API Key
模型名称：以模型聚合服务平台“模型广场”中显示的模型标识为准

Base URL 不要添加 /v1

这里填写 https://ai.example.edu.cn。Claude Code 会自行拼接 /v1/messages，因此不要填写成 https://ai.example.edu.cn/v1。

1. 找到配置文件 ​

Claude Code 的用户级配置文件位置如下：

操作系统配置文件
macOS / Linux~/.claude/settings.json
Windows%USERPROFILE%\.claude\settings.json

macOS 或 Linux 可以在终端中执行：

bash
mkdir -p ~/.claude
${EDITOR:-nano} ~/.claude/settings.json

如果文件已经存在，请修改原有 JSON，不要在文件末尾直接追加第二个 JSON 对象。

2. 写入连接配置 ​

下面是一份可以直接修改的完整示例：

json
{
  "effortLevel": "xhigh",
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "你的 API Key",
    "ANTHROPIC_BASE_URL": "https://ai.example.edu.cn",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "qwen3.6-27b",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-5.2",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-v4-flash",
    "CLAUDE_CODE_AUTO_COMPACT_WINDOW": "256000",
    "CLAUDE_CODE_MAX_OUTPUT_TOKENS": "8192",
    "CLAUDE_CODE_SUBAGENT_MODEL": "qwen3.6-27b"
  },
  "includeCoAuthoredBy": false,
  "model": "haiku"
}

至少需要配置以下三项：

字段作用
ANTHROPIC_AUTH_TOKEN模型聚合服务平台的 API Key
ANTHROPIC_BASE_URLAnthropic 兼容接口的基础地址
modelClaude Code 默认使用的模型别名，如 haiku、sonnet 或 opus

示例把 Claude Code 的模型别名映射为平台模型：

Claude Code 别名实际调用的模型
haikuqwen3.6-27b
sonnetdeepseek-v4-flash
opusglm-5.2

因为示例中的 model 是 haiku，所以主会话默认调用 qwen3.6-27b。在 Claude Code 中切换到 /model sonnet 或 /model opus 时，会改用表中对应的模型。

可选参数

CLAUDE_CODE_AUTO_COMPACT_WINDOW、CLAUDE_CODE_MAX_OUTPUT_TOKENS 和 CLAUDE_CODE_SUBAGENT_MODEL 都是可选项。不确定平台模型能力时可以先省略，完成基础连接后再添加。

不要照抄无效字段

ANTHROPIC_DEFAULT_FABLE_MODEL 和 ANTHROPIC_DEFAULT_FABLE_MODEL_NAME 不在当前 Claude Code 官方支持的模型映射变量中，不建议写入配置。

3. 检查 JSON 格式 ​

macOS 或 Linux 可以使用 Node.js 检查配置文件是否为合法 JSON：

bash
node -e 'JSON.parse(require("fs").readFileSync(process.env.HOME + "/.claude/settings.json", "utf8")); console.log("settings.json 格式正确")'

常见错误包括：

  • 把网址写成 Markdown 链接，例如 [https://ai.example.edu.cn](https://ai.example.edu.cn)。JSON 中只能填写纯网址。
  • 将变量名写成 ANTHROPIC\_AUTH\_TOKEN。实际 JSON 中必须使用普通下划线 _，不能带反斜杠。
  • 最后一个字段后多写逗号。
  • 配置文件中出现两个并列的 { ... } 对象。

4. 启动并验证 ​

保存配置后，在需要处理的项目目录中启动：

bash
claude

进入 Claude Code 后：

  1. 执行 /status，检查当前模型和配置来源。
  2. 执行 /model，确认 haiku、sonnet 或 opus 可以选择。
  3. 发送一条不含敏感数据的测试消息。

修改 settings.json 后，建议退出并重新启动 Claude Code，使环境变量完整生效。

密钥安全

settings.json 中的 env 字段会以明文保存 API Key。请只使用用户级 ~/.claude/settings.json，不要把个人密钥写入项目的 .claude/settings.json 或提交到 Git。共享电脑建议改用安全的环境变量或密钥管理工具。

Claude Code 会读取代码、执行命令并可能修改文件。仅在可信仓库中使用，认真审阅工具权限和文件变更，不要让其读取 .env、证书、个人隐私或生产数据。

配置过程中遇到账号、API Key、接口地址、模型权限、额度、限流或通用错误时，请查看常见问题（FAQ）。