APIMaster.ai
APIMaster.ai 使用文档
快速开始APIMaster 官网模型广场

在 Claude Code 中使用 DeepSeek V4 Flash 和 Pro：设置与模型切换

使用 APIMaster 在 Claude Code 中设置 DeepSeek。在 Windows、macOS 和 Linux 上配置 settings.json，启动 claude，使用 /model 选择模型并开始对话。

在 settings.json 中配置 APIMaster，运行 claude，然后在对话中输入 /model MODEL_ID 即可使用 DeepSeek。 本文涵盖的可用 ID 为 deepseek-v4-flash、deepseek-v4-pro。Claude Code 是客户端；DeepSeek 是提供回答的模型。

开始之前

先完成环境检查和 Claude Code 设置。获取一个余额充足且可访问所选模型的 APIMaster API 密钥。

claude --version

网关基础 URL 为 https://apimaster.ai，不含 /v1。Claude Code 会自行追加 /v1/messages。

1. 打开配置目录

Windows

按 Win + R，输入以下路径并按回车：

%USERPROFILE%\.claude

如需请先创建该文件夹。打开或创建 settings.json。确保文件名不是 settings.json.txt。

macOS / Linux

在 macOS 上，在访达（Finder）中按 Command + Shift + G 并输入：

~/.claude

在 Linux 上，用文件管理器或编辑器打开同一目录。如需请先创建：

mkdir -p ~/.claude

在该目录中打开或创建 settings.json。如果你设置了自定义的 Claude Code 配置目录，请改用该目录。

2. 编辑 settings.json

Windows、macOS 和 Linux 使用相同的配置。将 YOUR_APIMASTER_API_KEY 替换为你的 APIMaster 密钥：

{
  "model": "deepseek-v4-flash",
  "env": {
    "ANTHROPIC_BASE_URL": "https://apimaster.ai",
    "ANTHROPIC_API_KEY": "YOUR_APIMASTER_API_KEY",
    "ANTHROPIC_AUTH_TOKEN": "",
    "CLAUDE_CODE_ATTRIBUTION_HEADER": "0",
    "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1"
  }
}

如果文件已存在，请先备份，然后将这些字段合并到现有的 JSON 对象和 env 对象中。保留你需要的其他设置。不要追加第二个 JSON 对象或重复 env 键。JSON 不允许注释或尾随逗号。

Claude Code 通用指南介绍的是令牌认证方式。本指南使用的是我们集成测试中实际验证过的 API 密钥认证方式。使用 ANTHROPIC_API_KEY 时请保持 ANTHROPIC_AUTH_TOKEN 为空，并从其他设置或终端中移除存在冲突的凭据。此网关请使用 APIMaster 密钥。

model 字段设置启动时的模型。启动后你可以切换到其他模型。请将此用户设置文件保密；不要将真实密钥提交到共享仓库。保存文件并重启 Claude Code 以加载新配置。

3. 启动 Claude Code

在项目目录中打开终端，运行：

claude

完成常规的首次运行提示并确认项目信任提示。起始模型应为 deepseek-v4-flash。这是一个普通的交互式会话，包含常用的工具和项目设置。

4. 选择模型并开始对话

在 Claude Code 对话 中，输入以下命令之一并按回车：

/model deepseek-v4-flash
/model deepseek-v4-pro

每次运行一行，选择你想要的模型。Claude Code 确认切换后，发送一条简短消息：

Reply with exactly OK.

收到正常的文本回复即表示基本连接正常。之后你可以继续对话，或让它处理你的项目。若要在同一对话中再次切换，输入另一条 /model MODEL_ID 命令。

单独输入 /model 会打开模型选择器。自定义网关 ID 可能不会出现在其默认列表中。 请改为输入如上所示的完整 ID。此斜杠命令属于 Claude Code 内部，不能在 PowerShell 或 Bash 中使用。这些模型名称指的是 DeepSeek 模型，而非 Claude Sonnet 或 Opus。

你也可以在从 终端 启动时选择模型。每次运行一条命令：

claude --model deepseek-v4-flash
claude --model deepseek-v4-pro

若要为以后的会话显式设置默认模型，请编辑 settings.json 中的 model。启动参数、ANTHROPIC_MODEL 环境变量或项目/托管设置都可能影响所选模型；如果起始模型与你保存的值不一致，请检查这些配置。

故障排查

症状 检查事项
401 / 出现意外的登录提示 检查 APIMaster 密钥、基础 URL 以及存在冲突的认证变量；编辑设置后重启 CLI。
404 使用 https://apimaster.ai，不要带 /v1 或 /v1/messages。
设置未生效 检查文件位置、JSON 是否有效，以及来自终端、项目或托管设置的覆盖项。
模型选择器中缺少模型 输入 /model MODEL_ID（使用准确的 ID），或以 claude --model MODEL_ID 启动。
模型不可用 / 403 检查拼写、密钥允许的模型、账户余额以及当前路由的可用性。
unrecognized_model 在我们的测试中使用自定义 ID 时出现过该错误。请检查实际回答和工具结果；未针对 DeepSeek 验证内置的 Claude 能力默认值。
文件或命令权限被拒绝 通过常规权限提示审查并批准预期操作。
429 / 5xx / 回复中断 保留错误信息、模型 ID、CLI 版本、UTC 时间和请求 ID（如有）以便支持人员排查。

验证与可选诊断

已记录的集成测试信息：2026-09-07 UTC、Claude Code 2.1.239、Linux。此处列出的所有模型均返回了预期文本，并通过工具读取了本地文件。复杂编码任务不在该测试范围内。Windows 和 macOS 不在这些已记录的运行之列。

早期的自动化检查使用了裸模式（bare mode）来隔离配置。日常正常使用请遵循上文的 settings.json 和交互式步骤。 裸模式和 --setting-sources "" 会跳过正常集成或已保存的设置，因此不应将其添加到本指南的日常启动命令中。

若要使用已保存的配置进行快速的非交互式检查：

claude --model deepseek-v4-flash -p "Reply with exactly OK."

若要进行工具检查，创建一个包含 FILE_PROBE_739182 的 probe.txt 文件，在该目录中启动 Claude Code，并要求它使用工具读取该文件并返回其确切内容。确认工具确实执行了。

这些是有边界的集成检查，并不保证 Claude Code 的每一项功能、长时间会话行为或最大上下文。Anthropic 的网关文档并未正式支持将 Claude Code 路由到非 Claude 模型；本指南描述的是 APIMaster 的集成方案。

常见问题

我的 Claude 订阅可以为这些请求付费吗？

不可以。使用此 APIMaster 配置时，请求使用的是你的 APIMaster 密钥和余额。

切换模型后还能继续对话吗？

可以，在打开的对话中使用模型切换命令，并在发送下一条消息前等待确认。若要在模型之间进行干净的对比，请使用 claude --model MODEL_ID 启动一个单独的会话。

相关指南与来源