[控场AI]
· 6 分钟阅读· 3,325 字

Claude Code 接入国内 AI 模型:DeepSeek、通义千问、GLM 配置全攻略

Claude Code 接入国内 AI 模型:DeepSeek、通义千问、GLM 配置全攻略

三个环境变量即可将 Claude Code 接入 DeepSeek、通义千问、智谱 GLM 等国内主流模型。

本文介绍如何通过配置三个环境变量(ANTHROPIC_BASE_URL、ANTHROPIC_AUTH_TOKEN、ANTHROPIC_MODEL),将 Claude Code 的 API 请求转发至国内兼容 Anthropic 接口的平台,从而绕开官方接口在国内的访问障碍。文章分别给出 DeepSeek(推荐 PowerShell 环境变量)、阿里通义千问和智谱 GLM(推荐 settings.json 配置文件)三家平台的具体接入参数,并指出 DeepSeek 模型名需附加 [1M] 上下文标注、开启 Max 思考强度等易踩坑细节。对于需要频繁切换平台的开发者,文章还推荐了第三方工具 CC Switch,支持 Windows/macOS/Linux 全平台一键管理多套 API 配置,避免反复手动修改的麻烦。

Claude Code 官方 API 在国内调用并不顺畅,这是不少开发者绕不开的痛点。好在它的底层协议是开放的,只要把请求转发到兼容 Anthropic 接口的国内平台,就能用上 DeepSeek、阿里通义千问、智谱 GLM 这些主流模型。本文梳理三家平台的接入方法,并介绍一键管理工具 CC Switch,帮你省去反复改配置的麻烦。

核心逻辑:三个环境变量搞定一切

无论接入哪家平台,Claude Code 的配置套路都是统一的,核心是三个环境变量:

  • ANTHROPIC_BASE_URL:指定 API 网关地址,把原本发往 Anthropic 的请求转发到你选择的平台。
  • ANTHROPIC_AUTH_TOKEN:填入你的 API Key,用于鉴权。
  • ANTHROPIC_MODEL:设置默认使用的主模型。

除这三件套外,还可以做精细映射,分别为 Opus、Sonnet、Haiku 三个档位指定不同模型。给轻量 Agent 任务用小模型,同时把思考强度 CLAUDE_CODE_EFFORT_LEVEL 设为 Max,让模型跑在满血状态。

准备工作并不复杂:进入对应平台控制台,注册登录并完成实名认证,创建一个 API Key,就可以开始调用。配置方式主要有两种——直接写环境变量,或写进用户主目录下 .claude 目录里的 settings.json 文件。

Anthropic 兼容接口是指第三方平台按照 Anthropic 官方 API 的请求/响应格式实现的代理层。Claude Code 在发起请求时,只要 ANTHROPIC_BASE_URL 指向支持该格式的端点,工具本身无需任何改动即可透明地调用完全不同的底层模型。这一机制类似于 OpenAI 兼容接口在业内的广泛普及——只要响应结构相同,客户端就感知不到后端的差异。国内三家平台之所以能接入,正是因为它们分别实现了这套兼容层,将 DeepSeek广告-V4、Qwen3、GLM 等模型"包装"成 Claude 客户端可识别的格式对外提供服务。

CLAUDE_CODE_EFFORT_LEVEL 是 Claude Code 特有的推理强度控制参数,设为 Max 时模型会启用更深层的链式思考(Chain-of-Thought),适合复杂代码生成与调试任务,代价是响应时间和 Token 消耗相应增加。在接入推理能力较强的国内模型时,这个参数往往能显著提升输出质量。

DeepSeek:推荐用 PowerShell 环境变量

三家平台里,DeepSeek 推荐直接用环境变量配置。在 PowerShell 里把 ANTHROPIC_BASE_URL 设为 https://api.deepseek.com/anthropic,ANTHROPIC_AUTH_TOKEN 换成你的 DeepSeek API Key,ANTHROPIC_MODEL 设为 DeepSeek-V4-Pro。

在 PowerShell 里设置 DeepSeek 环境变量

这里有两个容易踩坑的细节:模型名要加方括号 [1M] 标注上下文长度,并且思考强度记得开 Max,才能发挥完整能力。

设置完成后进入项目目录执行 claude 启动。也可以在启动时直接指定模型,用 claude --model deepseek-v4-pro,或者在交互模式里输入 /model 切换。输入 /model 还能查看当前支持的模型列表。

环境变量写入用户及环境变量,效果一样

通义千问与智谱 GLM:用 settings.json 更省心

阿里百炼广告的通义千问推荐用配置文件方式。打开用户主目录下的 .claude 文件夹,编辑 settings.json,在 env 字段里写入 ANTHROPIC_AUTH_TOKEN(你的 API Key)、ANTHROPIC_BASE_URL(https://dashscope.aliyuncs.com/apps/anthropic)以及 ANTHROPIC_MODEL(qwen3-coder-plus),保存后重新打开终端即可生效。

Windows 用户也可以在 CMD 里用 set,或在 PowerShell 里写入用户级环境变量,效果一样。切换时在对话中输入 /model qwen3-coder-plus 即可。

智谱 GLM 同样在 settings.json 的 env 字段里配置:ANTHROPIC_AUTH_TOKEN 填 API Key,ANTHROPIC_BASE_URL 设为 https://open.bigmodel.cn/api/anthropic。此外可以把 API 超时时间调长(如 3000000 毫秒),并设置关闭非必要流量的环境变量为 1,减少不必要的数据传输。配置好运行 claude,输入 /status 确认当前模型状态,不对就用 /config 切换。

CC Switch:多平台一键切换

平台一多,来回改配置就很折腾。这里推荐第三方工具 CC Switch,它支持 Windows、macOS、Linux 全平台,是 Claude Code、Codex、Gemini CLI 的辅助管理工具,相当于给你的开发工具箱请了个智能整理助手。

CC Switch 全平台配置管理工具

安装方式很简单:去 GitHub 搜索 firon1231/ccswitch(具体仓库名以实际为准),在 Releases 页面下载对应平台的安装包。装好后点一下就能在不同平台的 API 配置间切换,不用再手动改环境变量。更详细的操作可参考菜鸟教程里的 CC Switch 专项文章。

从技术原理上看,CC Switch 本质上是一个配置文件管理器:它将多套环境变量组合(BASE_URL + AUTH_TOKEN + MODEL)存储为命名的「配置档案」,切换时以原子操作替换当前生效的那组变量,并同步写入 shell 配置或系统环境变量,使下次启动 Claude Code 时自动加载目标平台的设置。对于需要在不同项目中分别使用不同模型的团队来说,这种管理方式能避免因手动编辑配置文件引入的拼写错误或遗漏字段等低级问题。

速查表与配置套路

三家平台的关键信息汇总如下:

平台网关地址默认模型推荐配置方式
DeepSeekapi.deepseek.com/anthropicDeepSeek-V4-Pro [1M]环境变量
阿里百炼dashscope.aliyuncs.com/.../anthropicqwen3-coder-plussettings.json
智谱open.bigmodel.cn/api/anthropicGLM 系列settings.json

三家平台推荐的配置方式

整个流程记住一句话:先去控制台拿 API Key,再配置 URL、Token、Model 三件套,最后启动 Claude,用 /status 或 /model 验证。平台多就上 CC Switch 一键管理。

下一期将专门深入 DeepSeek 的接入配置,探讨更多高级玩法。

#Claude Code#DeepSeek 接入#通义千问#智谱 GLM#API 配置#AI 编程助手#CC Switch#环境变量配置
分享:

相关推荐