产品硅基流动官方博客·原文 2026年9月17日本站收录 2026年9月24日

硅基流动发布在Claude Code中接入DeepSeek V4 Pro的配置指南

硅基流动官方博客给出把Claude Code的Anthropic格式请求指向SiliconFlow、加载API Key、选用deepseek-ai/DeepSeek-V4-Pro-0813的完整步骤,并提醒先在Messages端点测试模型可用性。

AI解读:这条新闻实质上是一份配置说明:硅基流动官方博客给出了把Claude Code接到自家平台上的DeepSeek V4 Pro的具体做法。需要说明的是,来源只有摘要,以下内容基于该摘要整理。

受影响最直接的是已经装了Claude Code、手里有硅基流动API Key的开发者。按博文写法,把ANTHROPIC_BASE_URL指向硅基流动、用Bearer token认证、模型ID写成deepseek-ai/DeepSeek-V4-Pro-0813,就能让CLI的请求走DeepSeek V4 Pro。

关键的坑在于兼容层不是Anthropic官方支持的用法:博文自己也承认Claude Code是为Anthropic模型维护的,硅基流动只是提供Anthropic兼容API,Claude Code一旦引入新请求字段或agent功能,兼容性可能随时变化。

另一个限制是网页版不可用。Claude Code网页会话跑在Anthropic托管的基础设施上,不会继承本地的ANTHROPIC_BASE_URL和认证变量,所以这套配置只对本地安装的CLI有效。

对不想订阅Claude、又想用Claude Code这套agent工作流的人来说,这是一条省订阅费的替代路径,但代价是承担兼容性风险,并且要自己处理 400、404、429、503、504 这些错误码,博文给的是排查表而不是保证。

硅基流动官方博客发布了一篇指南,说明如何把Claude Code的请求接到硅基流动平台,从而在Claude Code里使用DeepSeek V4 Pro。核心做法是:把Claude Code的Anthropic格式请求指向SiliconFlow,加载硅基流动API Key,并选择模型deepseek-ai/DeepSeek-V4-Pro-0813。

博文特别提醒,在保存配置之前,先通过硅基流动的Messages端点测试模型是否可用,因为Anthropic兼容与OpenAI兼容两个API面上的模型可用性可能不同。

根据这篇博文,前置条件包括:一个硅基流动账号和API Key、本地已安装Claude Code、macOS/Linux/Windows Subsystem for Linux上的Bash终端,以及对deepseek-ai/DeepSeek-V4-Pro-0813的访问权限。博文称当前该模型的部署支持无服务器推理和工具调用,而Claude Code在读取文件、执行命令或编辑项目时需要工具调用。

配置方式:改基础URL、换认证变量、锁定模型ID

博文给出的第一步是设置硅基流动主机地址,且不带 /v1,因为Claude Code发送请求时会自行追加 /v1/messages;如果ANTHROPIC_BASE_URL里已带 /v1,可能出现 /v1/v1/messages这类错误路径。

认证方面,硅基流动的Messages API使用bearer-token认证。博文用Bash命令把Key只存进当前会话,并指出凭证变量决定Claude Code发送哪个HTTP头:ANTHROPIC_AUTH_TOKEN对应Authorization: Bearer,ANTHROPIC_API_KEY对应x-api-key。博文称,其通用Claude Code配置指南用的是ANTHROPIC_API_KEY,而当前Messages端点文档描述的是bearer认证,因此这套配置用ANTHROPIC_AUTH_TOKEN。

模型设置上,博文要求使用当前官方模型ID,并称更早的模型字符串指向预览版,新配置应使用 -0813 这个ID。ANTHROPIC_MODEL控制Claude Code主会话;当用户选用opus、sonnet、haiku或fable时,Claude Code也可能通过模型别名发起后台操作请求。如果这些请求报出不支持claude-* 模型的错误,博文建议把别名映射到DeepSeek V4 Pro,并称这些映射对初始连接是可选的,映射后包括轻量后台请求在内的所有映射操作都会走DeepSeek V4 Pro。

博文还提醒,模型ID要严格按硅基流动的写法,不要追加Claude Code的 [1m] 后缀:上下文上限由硅基流动的部署决定,追加无法识别的后缀会改变API模型字符串,可能导致模型选择错误。

  • 设置硅基流动主机地址时不带 /v1,避免出现 /v1/v1/messages路径。
  • 凭证变量决定请求头:ANTHROPIC_AUTH_TOKEN走Authorization: Bearer,ANTHROPIC_API_KEY走x-api-key。
  • 新配置应使用模型ID deepseek-ai/DeepSeek-V4-Pro-0813,旧字符串对应预览版。
  • 不要给模型ID追加 [1m] 后缀,上下文上限由硅基流动部署决定。

验证顺序:先测端点,再测读仓库和工具调用

博文建议在启动Claude Code之前先测试认证和模型可用性:请求返回HTTP 200且响应里含assistant内容字段时再继续,这能确认Key有效、且DeepSeek V4 Pro已对该账号在Messages API上开放。如果返回模型未找到或不支持该模型,说明Key和端点可能有效,但该模型尚未在该API面上暴露;由于Claude Code需要Messages端点,仅通过 /v1/chat/completions可访问并不够用。

进入Claude Code后,博文建议先确认状态屏显示api.siliconflow.com为Anthropic基础URL、ANTHROPIC_AUTH_TOKEN为凭证来源、deepseek-ai/DeepSeek-V4-Pro-0813为已选模型。测试按由浅入深的顺序:先做一个不访问文件的小型编码请求,正常响应说明Claude Code能通过硅基流动发送提示并拿回代码;再做一次只读的仓库操作;成功后再做受控的工具任务。博文称这个顺序把基础API连通性与仓库读取、工具使用区分开来,并建议在一次性分支上测试编辑,接受生成的改动前先审查。

  • 直接cURL测试返回HTTP 200且含assistant内容字段,才能确认Key与模型在Messages API上可用。
  • 状态屏应显示api.siliconflow.com、ANTHROPIC_AUTH_TOKEN和 -0813 模型ID。
  • 验证顺序为:无文件访问的编码请求 → 只读仓库操作 → 受控工具任务。
  • 编辑测试应在一次性分支上进行,接受改动前先审查。

故障排查与兼容性边界

博文列出了症状、可能原因和修复方式的对照表:401/Unauthorized/Invalid token通常是Key无效或请求头用错,应改用ANTHROPIC_AUTH_TOKEN、必要时重新生成Key并重跑cURL测试;Claude Code打开登录屏,通常是启动时token不可用,应在启动前导出token并检查 /status;/status显示Anthropic默认API,是自定义基础URL没加载,应重新导出ANTHROPIC_BASE_URL并从同一shell重启Claude Code;HTTP 404是基础URL路径不对,应使用不带 /v1的https://api.siliconflow.com;模型未找到,是模型ID错误或该模型无法通过 /v1/messages访问,应使用确切的 -0813 ID并检查直接的Messages请求;报错中出现claude-* 模型,是内部模型别名没有映射,应补上可选的Opus、Sonnet、Haiku、Fable映射;HTTP 400提到不认识的请求字段,是Claude Code发送了兼容端点不接受的字段,应更新Claude Code并用CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1 重试。

其余条目包括:模型描述了工具动作却没调用工具,通常是工具请求不清晰或工具行为失败,应精确写出文件名或动作,并在新会话中一次测试一个工具;文件编辑或命令被拒绝,是本地Claude Code权限拦截,应审查请求动作,仅在安全时批准;HTTP 429是触及token或速率限制,应减少并行会话或上下文大小后重试;HTTP 503是模型服务过载,应退避重试,而不是连续发多个立即请求;HTTP 504是任务超出请求时间,应限制仓库范围或把任务拆成更小阶段。

博文强调,如果直接cURL请求能成功但Claude Code失败,认证和模型可用性很可能是正常的,应检查 /status、模型映射、Claude Code版本、本地权限以及与兼容性相关的HTTP 400消息;不要仅凭一次文件编辑失败就判断是API问题,因为Claude Code可能已经成功连上模型,而本地权限规则阻止了Bash、写文件或其他工具运行。

兼容性方面,博文明确写道:Claude Code是为Anthropic模型维护的,硅基流动为接入其他受支持模型提供Anthropic兼容API,但当Claude Code引入新请求字段或agent功能时,兼容性可能发生变化;Anthropic的网关文档不为把Claude Code路由到非Claude模型提供官方支持。

  • 401 用错请求头、404 路径带 /v1、模型未找到、claude-* 别名未映射、400 不认识的字段,各有对应修法。
  • 429 需减少并行会话或上下文,503 需退避重试,504 需限制范围或拆分任务。
  • cURL成功但Claude Code失败时,优先查 /status、模型映射、版本、本地权限和 400 兼容性消息,而不是断定API故障。
  • 博文称Anthropic官方不为把Claude Code路由到非Claude模型提供支持,兼容性可能随Claude Code更新而变化。

临时会话、恢复原配置与常见问题

博文给出的命令使用临时Bash会话:退出该会话后,之前的shell变量保持不变。若要切回原配置,按临时Bash方法操作的话,退出Claude Code再退出临时shell即可;如果曾把硅基流动变量写进 ~/.bashrc、~/.zshrc或 ~/.claude/settings.json,则只删掉自己添加的条目,不要unset或删除并非为这次硅基流动配置创建的既有ANTHROPIC_API_KEY。之后开新终端,用 /status确认硅基流动的base URL和bearer token不再生效。博文称,如果此前使用Claude账号或Anthropic API Key,Claude Code会回到那套已保存的认证方式。

常见问题里,博文回答:使用Claude Code里的DeepSeek V4 Pro不需要Claude订阅,网关凭证可以替代已保存的Claude订阅供本地会话使用,模型请求随后关联到硅基流动API Key,而不是订阅包含的用量。配置可以永久保存,把非机密变量写进shell配置或Claude Code用户设置即可,但不要把凭证提交进 .claude/settings.json,在共享系统上应使用受保护的用户级设置或密钥管理工具。DeepSeek V4 Pro可能不出现在 /model选择器里,自定义提供商的模型ID未必进入Claude Code内置模型列表,应通过ANTHROPIC_MODEL或 --model选项设置完整ID,再用 /status验证当前模型。这套配置在Claude Code网页版不可用,因为网页会话跑在Anthropic托管的基础设施上,不会继承本地的ANTHROPIC_BASE_URL或ANTHROPIC_AUTH_TOKEN,要使用该配置应使用本地安装的Claude Code CLI。

  • 临时Bash会话退出后原shell变量不变;写进配置文件的只删自己添加的条目,不动既有ANTHROPIC_API_KEY。
  • 博文称不需要Claude订阅,网关凭证可替代已保存订阅,请求计入硅基流动API Key。
  • 模型ID可能不出现在 /model选择器,需用ANTHROPIC_MODEL或 --model指定并到 /status验证。
  • Claude Code网页版不继承本地ANTHROPIC_BASE_URL和ANTHROPIC_AUTH_TOKEN,该配置只适用于本地CLI。

信息来源

更多

新闻专题
外观