1. 为什么要在 Claude Code 里接国产大模型Claude Code 是 Anthropic 出的命令行编程助手本身默认走官方通道。但很多开发者手里已经有 Kimi、DeepSeek、Minimax 的 Key或者想按任务类型切换模型写长文档用 Kimi 的长上下文跑代码补全用 DeepSeek 的性价比做多模态或长窗口任务用 Minimax。问题在于Claude Code 并不提供图形化的模型切换面板它只认~/.claude/settings.json里的环境变量。我试过直接改环境变量再重启终端结果发现 Claude Code 启动时会读取配置文件里的env字段覆盖掉 shell 里临时 export 的值。所以正确做法是把三家模型的配置写成独立的 JSON 骨架需要哪家就替换哪份保存后新开终端即可生效。这篇就围绕这个配置文件展开给出 Kimi、DeepSeek、Minimax 三套可复制的settings.json骨架再逐条验证连通性确认返回的模型标识是不是你配的那个。适合谁已经装好 Claude Code、Node.js 版本在 18 以上、想用统一 Key/API 通道并行调用国产模型的开发者。如果你还没装 Claude Code先执行npm install -g anthropic-ai/claude-code再往下看。2. 前置准备统一通道与 Key 获取Claude Code 的配置核心是三个字段ANTHROPIC_BASE_URL指向 API 入口ANTHROPIC_API_KEY或ANTHROPIC_AUTH_TOKEN放凭证ANTHROPIC_MODEL指定默认模型。三家国产模型都提供了兼容 Anthropic 协议的入口所以配置结构基本一致区别只在 base_url 和模型名。如果你希望用一个 Key 同时管理多家模型、避免在多个平台之间来回切换可以走统一通道入口。官网地址是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 入口是 https://taotoken.net/api 。在控制台里创建 Key 之后把 base_url 指向统一入口模型名按各家实际标识填写即可。需要提前准备的东西Node.js v18.0 或更高版本终端执行node -v确认。Claude Code 已全局安装claude --version能输出版本号。至少一个可用的 API KeyKimi、DeepSeek、Minimax 任意一家或者统一通道的 Key。配置文件目录~/.claude不存在就先mkdir -p ~/.claude。注意ANTHROPIC_API_KEY和ANTHROPIC_AUTH_TOKEN在不同模型配置里会混用Kimi 用前者DeepSeek 和 Minimax 用后者。填错字段名会导致 401后面排障章节会细说。3. settings.json 配置骨架三家模型逐套拆解配置文件路径在 macOS/Linux 是~/.claude/settings.jsonWindows 是C:\Users\用户名\.claude\settings.json。下面三套骨架可以直接复制把占位符替换成你的真实 Key。3.1 Kimi 配置k3-256k 与 kimi-for-coding 两档Kimi 的入口是https://api.kimi.com/coding/Key 以sk-kimi-开头。它有两个常用模型档位k3-256k上下文长但消耗快kimi-for-coding更适合日常任务。先看 k3-256k 的骨架{ env: { ANTHROPIC_BASE_URL: https://api.kimi.com/coding/, ANTHROPIC_API_KEY: sk-kimi-你的Key, ANTHROPIC_MODEL: k3-256k, ANTHROPIC_DEFAULT_OPUS_MODEL: k3-256k, ANTHROPIC_DEFAULT_SONNET_MODEL: k3-256k, ANTHROPIC_DEFAULT_HAIKU_MODEL: k3-256k, ANTHROPIC_DEFAULT_FABLE_MODEL: k3-256k, CLAUDE_CODE_SUBAGENT_MODEL: k3-256k, CLAUDE_CODE_EFFORT_LEVEL: high, CLAUDE_CODE_AUTO_COMPACT_WINDOW: 262144, CLAUDE_CODE_MAX_CONTEXT_TOKENS: 262144 } }如果觉得 k3 消耗太快把模型名统一换成kimi-for-coding其余字段不变{ env: { ANTHROPIC_BASE_URL: https://api.kimi.com/coding/, ANTHROPIC_API_KEY: sk-kimi-你的Key, ANTHROPIC_MODEL: kimi-for-coding, ANTHROPIC_DEFAULT_OPUS_MODEL: kimi-for-coding, ANTHROPIC_DEFAULT_SONNET_MODEL: kimi-for-coding, ANTHROPIC_DEFAULT_HAIKU_MODEL: kimi-for-coding, ANTHROPIC_DEFAULT_FABLE_MODEL: kimi-for-coding, CLAUDE_CODE_SUBAGENT_MODEL: kimi-for-coding, CLAUDE_CODE_AUTO_COMPACT_WINDOW: 262144, CLAUDE_CODE_MAX_CONTEXT_TOKENS: 262144 } }CLAUDE_CODE_AUTO_COMPACT_WINDOW和CLAUDE_CODE_MAX_CONTEXT_TOKENS都设成 262144对应 256K 上下文。CLAUDE_CODE_EFFORT_LEVEL设 high 会让模型在推理上多花点算力日常任务可以降到 medium。3.2 DeepSeek 配置pro 与 flash 双档DeepSeek 的 Anthropic 兼容入口是https://api.deepseek.com/anthropic凭证字段用ANTHROPIC_AUTH_TOKEN。它分 pro 和 flash 两档pro 负责主力推理flash 跑子代理和轻量任务{ env: { ANTHROPIC_BASE_URL: https://api.deepseek.com/anthropic, ANTHROPIC_AUTH_TOKEN: 你的 DeepSeek API Key, ANTHROPIC_MODEL: deepseek-v4-pro[1m], ANTHROPIC_DEFAULT_OPUS_MODEL: deepseek-v4-pro[1m], ANTHROPIC_DEFAULT_SONNET_MODEL: deepseek-v4-pro[1m], ANTHROPIC_DEFAULT_HAIKU_MODEL: deepseek-v4-flash, CLAUDE_CODE_SUBAGENT_MODEL: deepseek-v4-flash, CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC: 1, CLAUDE_CODE_EFFORT_LEVEL: max, CLAUDE_CODE_AUTO_COMPACT_WINDOW: 786432 }, permissions: { allow: [Read, Edit, Bash(npm run *), Bash(git status)], deny: [Bash(rm -rf /), Bash(sudo *)] } }如果只想用 flash 档把主模型也换成deepseek-flash[1m]{ env: { ANTHROPIC_BASE_URL: https://api.deepseek.com/anthropic, ANTHROPIC_AUTH_TOKEN: 你的 DeepSeek API Key, ANTHROPIC_DEFAULT_OPUS_MODEL: deepseek-flash[1m], ANTHROPIC_DEFAULT_SONNET_MODEL: deepseek-flash[1m], ANTHROPIC_DEFAULT_HAIKU_MODEL: deepseek-flash[1m], CLAUDE_CODE_SUBAGENT_MODEL: deepseek-flash[1m], CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC: 1, CLAUDE_CODE_EFFORT_LEVEL: max, CLAUDE_CODE_AUTO_COMPACT_WINDOW: 786432 }, permissions: { allow: [Read, Edit, Bash(npm run *), Bash(git status)], deny: [Bash(rm -rf /), Bash(sudo *)] } }permissions字段是 Claude Code 的工具权限白名单allow 里放允许自动执行的命令deny 里放禁止的。Bash(rm -rf /)和Bash(sudo *)建议始终放在 deny 里。3.3 Minimax 配置M3 长窗口Minimax 的入口是https://api.minimaxi.com/anthropic模型标识MiniMax-M3[1m]上下文窗口开到 1000000{ env: { ANTHROPIC_BASE_URL: https://api.minimaxi.com/anthropic, ANTHROPIC_AUTH_TOKEN: MINIMAX_API_KEY, CLAUDE_CODE_AUTO_COMPACT_WINDOW: 1000000, ANTHROPIC_MODEL: MiniMax-M3[1m], ANTHROPIC_DEFAULT_SONNET_MODEL: MiniMax-M3[1m], ANTHROPIC_DEFAULT_OPUS_MODEL: MiniMax-M3[1m], ANTHROPIC_DEFAULT_HAIKU_MODEL: MiniMax-M3[1m] } }三套配置的字段对照可以看这张表字段KimiDeepSeekMinimaxBASE_URLapi.kimi.com/coding/api.deepseek.com/anthropicapi.minimaxi.com/anthropic凭证字段ANTHROPIC_API_KEYANTHROPIC_AUTH_TOKENANTHROPIC_AUTH_TOKEN主模型k3-256k / kimi-for-codingdeepseek-v4-pro[1m]MiniMax-M3[1m]子代理模型同主模型deepseek-v4-flash同主模型上下文窗口26214478643210000003.4 Windows 下的路径与跳过登录Windows 配置方法一致只是路径不同。用 PowerShell 创建目录和文件mkdir -Force $HOME\.claude notepad $HOME\.claude\settings.json把上面任意一套 JSON 粘进去保存。另外 Windows 下还需要编辑或新建C:\Users\用户名\.claude.json把hasCompletedOnboarding设为 true跳过官方登录验证{ hasCompletedOnboarding: true }这一步不做的话Claude Code 启动时可能卡在登录引导页即使 settings.json 配好了也进不去会话。4. 连通性验证启动会话并确认模型标识配置保存后关掉当前终端重新开一个。这一步很关键因为环境变量在终端启动时加载旧终端不会自动刷新。第一步确认配置文件被读取。执行claude --version能输出版本号说明 Claude Code 本身正常。接着启动一个交互会话claude进入会话后直接发一句测试对话比如「用一句话说明你是什么模型」。重点不是看它回答的内容而是看返回的模型标识。Claude Code 在响应头部或调试信息里会带上实际调用的模型名。如果想更精确地验证可以用--debug参数启动观察请求发往哪个 base_urlclaude --debug在 debug 输出里搜索ANTHROPIC_BASE_URL或api.kimi.com、api.deepseek.com、api.minimaxi.com这样的域名确认请求确实打到了你配置的入口。如果看到的是api.anthropic.com说明配置文件没生效回到第 5 节排查。再进一步可以发一个需要模型自报家门的 prompt请输出你的模型标识和上下文窗口大小Kimi 的 k3-256k 会返回类似k3-256k的标识DeepSeek 返回deepseek-v4-proMinimax 返回MiniMax-M3。如果返回的标识和你配置的不一致说明ANTHROPIC_MODEL字段被其他配置覆盖了检查是否有 shell 里的 export 或者项目级的.claude/settings.json在抢优先级。验证通过后你可以把三套配置分别存成settings-kimi.json、settings-deepseek.json、settings-minimax.json需要切换时复制覆盖settings.json再新开终端。这样比每次手改字段稳妥。5. 本篇常见错排查配置过程中最容易踩的坑集中在凭证字段、模型名和权限三处。下面按报错现象逐条拆。401 Unauthorized九成是凭证字段用错了。Kimi 认ANTHROPIC_API_KEYDeepSeek 和 Minimax 认ANTHROPIC_AUTH_TOKEN。如果你把 DeepSeek 的 Key 填进ANTHROPIC_API_KEY请求会直接被拒。检查方法打开 settings.json看字段名和 Key 前缀是否匹配。Kimi 的 Key 以sk-kimi-开头DeepSeek 和 Minimax 的 Key 格式不同别混用。404 model not found模型名写错了。deepseek-v4-pro[1m]里的[1m]是上下文标记不能省略也不能改成[256k]。Minimax 的MiniMax-M3[1m]大小写敏感写成minimax-m3会找不到。Kimi 的kimi-for-coding是全小写加连字符别写成kimi_for_coding。配置不生效仍走官方通道三个原因。一是没新开终端旧终端的环境变量还是旧的二是项目目录下存在.claude/settings.json它的优先级高于用户级的~/.claude/settings.json三是 shell 的.zshrc或.bashrc里 export 了ANTHROPIC_BASE_URL覆盖了配置文件。排查顺序先echo $ANTHROPIC_BASE_URL看当前值再检查项目级配置最后确认终端是新的。Windows 下卡在登录页~/.claude.json里的hasCompletedOnboarding没设成 true。这个文件和settings.json是两个不同的文件前者在用户主目录后者在.claude子目录里。两个都要配。权限报错 Bash command not allowedpermissions.allow里没放行对应命令。比如你想让 Claude Code 自动跑npm test但 allow 里只有Bash(npm run *)就会拦下来。把需要的命令模式加进 allow 数组或者临时在会话里手动确认。上下文窗口对不上CLAUDE_CODE_AUTO_COMPACT_WINDOW和CLAUDE_CODE_MAX_CONTEXT_TOKENS要跟模型实际窗口一致。Kimi 是 262144DeepSeek 是 786432Minimax 是 1000000。设小了会提前压缩上下文设大了可能触发服务端拒绝。排障时如果拿不准是 Key 问题还是配置问题可以先用统一通道的 Key 做一次最小验证把 base_url 指向 https://taotoken.net/api 模型名填一个已知可用的发一句对话看是否通。通了说明 Claude Code 本身没问题再回头调各家的独立配置。6. 按场景选择入口与后续动作三套配置跑通之后日常使用可以按任务类型分流。写长文档、读大文件、需要长上下文记忆的用 Kimi 的 k3-256k 或 Minimax 的 M3跑代码补全、批量重构、子代理并行的用 DeepSeek 的 pro 加 flash 组合成本更可控如果只是临时试一个模型不想改配置文件可以直接在模型对话里验证效果入口在 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。需要长期在 Claude Code 里跑编码任务、又不想频繁手动切配置的可以看 Coding Plan把多家模型的调用额度统一管理入口是 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。如果你还没创建 Key先去控制台 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 建一个再到 API Keys 页面 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 复制出来填进配置。接入过程中遇到字段或路径问题接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 里面有各模型的完整参数说明。最后提醒一句配置文件改完一定要新开终端这是最容易忽略的一步。我见过不少人改完直接在当前终端敲claude结果还是走旧配置白白排查半天。