1. 为什么要在 Mac Studio M4 Max 上折腾本地 Qwen 3.6 桥接 Claude CodeMac Studio M4 Max 配 128GB 统一内存是目前少数能在本地流畅跑 30B 级别量化模型的桌面设备。Qwen 3.6 系列在代码补全、长上下文理解上表现稳定配合 Claude Code 这类终端智能体理论上可以做到代码不出本机、推理成本归零。但直接把 Claude Code 指向本地推理服务几乎一定会撞上两个报错HTTP 422 和 HTTP 500。422 的根源是协议时序冲突。Claude Code 在多轮工具调用时会把 system 角色的消息插到 messages 数组中间而本地推理引擎大多严格遵循 OpenAI 规范只允许 system 出现在首条于是直接拒绝请求。500 的根源是凭证强校验LiteLLM 在跨协议路由时会强制查找对应提供商的 API Key找不到就抛 Missing credentials。这篇要解决的就是这条链路Mac Studio M4 Max 本地跑 Qwen 3.6用 LiteLLM 包装成 OpenAI 兼容接口再通过 TaoToken 统一 Key 通道接入 Claude Code。适合手上有 Apple Silicon 大内存机器、想让编码 Agent 走本地模型或统一网关的开发者。下面从环境准备到连通性验证一步步给可复制的配置。2. TaoToken 前置准备统一 Key 与 API 通道TaoToken 在这里的角色是统一 Key 和 API 通道。本地 LiteLLM 网关负责协议转换TaoToken 负责把上游模型的访问凭证收敛成一个 Key避免在多个配置文件里散落不同厂商的密钥。你需要在 TaoToken 控制台创建一个 API Key后面 LiteLLM 的 config.yaml 里会引用它。具体操作路径打开 https://taotoken.net/api 对应的控制台入口进入 API Keys 页面新建一个 Key复制保存。这个 Key 同时可以用于模型对话验证和 Coding Plan 场景。如果你只是先验证链路通不通用模型对话页面发一条测试消息即可如果打算长期跑编码 Agent建议直接开通 Coding Plan配额和并发更匹配 Claude Code 的调用模式。需要提醒的是TaoToken 的 Key 是访问上游模型的凭证本地 LiteLLM 网关的虚拟 Key 是另一回事。两者不要混用LiteLLM 对外暴露的端口用虚拟 Key 保护TaoToken 的 Key 写在 LiteLLM 的 config.yaml 里作为上游凭证。这样 Claude Code 只接触本地网关上游 Key 不暴露在客户端环境变量中。3. 可复制配置LiteLLM config.yaml 与 Claude Code settings.json先确认本地推理后端已经在跑。假设你用 oMLX 或 LM Studio 在 8001 端口暴露了 OpenAI 兼容接口模型名是 Qwen3.6-35B-A3B-8bit。接下来写 LiteLLM 的 config.yaml。model_list: - model_name: qwen-local litellm_params: model: openai/Qwen3.6-35B-A3B-8bit api_base: http://localhost:8001/v1 api_key: not-needed - model_name: claude-opus-4-7 litellm_params: model: openai/Qwen3.6-35B-A3B-8bit api_base: http://localhost:8001/v1 api_key: not-needed general_settings: master_key: sk-local-gateway-2026 drop_params: true litellm_settings: drop_params: true set_verbose: false这里有两个关键点。第一model_name同时注册了qwen-local和claude-opus-4-7两个别名都指向同一个本地模型。Claude Code 默认会请求 Anthropic 的模型名用别名映射可以让它以为自己在调用顶级模型实际落到本地 Qwen。第二drop_params: true会剥离 Anthropic 专有字段避免本地引擎解析失败。启动 LiteLLMlitellm --config ./config.yaml --port 8000启动后 LiteLLM 在 8000 端口监听对外提供 OpenAI 兼容接口同时接受 Anthropic 格式请求并做转换。接着配置 Claude Code 的 settings.json。路径通常在~/.claude/settings.json没有就新建{ env: { ANTHROPIC_BASE_URL: http://localhost:8000, ANTHROPIC_API_KEY: sk-local-gateway-2026, ANTHROPIC_MODEL: claude-opus-4-7, ANTHROPIC_SMALL_FAST_MODEL: qwen-local } }ANTHROPIC_BASE_URL指向本地 LiteLLM 网关不要拼/v1或/messages后缀Claude Code 内部会自己处理路径。ANTHROPIC_API_KEY填 LiteLLM 的 master_key不是 TaoToken 的 Key。ANTHROPIC_MODEL用别名claude-opus-4-7ANTHROPIC_SMALL_FAST_MODEL用qwen-local这样轻量任务和主任务都落到本地。如果你希望上游走 TaoToken 而不是纯本地把 config.yaml 里的api_base换成 TaoToken 的 API 地址api_key换成你在控制台创建的 Key- model_name: claude-opus-4-7 litellm_params: model: openai/qwen3.6-35b api_base: https://taotoken.net/api api_key: sk-your-taotoken-key这样 LiteLLM 既做协议转换又做统一出口本地和远端模型可以按 model_name 分流。4. 验证请求与成功结果配置写完后不要直接开 Claude Code先用 curl 验证 LiteLLM 网关本身能通。发一条 OpenAI 格式请求curl -s http://localhost:8000/v1/chat/completions \ -H Authorization: Bearer sk-local-gateway-2026 \ -H Content-Type: application/json \ -d { model: qwen-local, messages: [{role: user, content: 用一句话说明快速排序的核心思想}], max_tokens: 128 }正常返回会包含choices[0].message.content内容是模型生成的回答。如果返回 401检查 master_key 是否和请求头一致如果返回 500 且提示 Missing credentials说明 config.yaml 里某个 model 的 api_key 没填。再验证 Anthropic 格式转换是否生效curl -s http://localhost:8000/v1/messages \ -H x-api-key: sk-local-gateway-2026 \ -H anthropic-version: 2023-06-01 \ -H Content-Type: application/json \ -d { model: claude-opus-4-7, max_tokens: 128, messages: [{role: user, content: 写一个 Python 快排函数}] }这一步能返回内容说明 LiteLLM 的 Anthropic 到 OpenAI 协议转换链路是通的。最后启动 Claude Codeclaude进入交互界面后输入一个简单任务比如「读取当前目录的 package.json 并总结依赖」。如果 Claude Code 能正常调用工具、返回结果整条链路就跑通了。实测下来M4 Max 128GB 跑 35B 8-bit 量化首 token 延迟在可接受范围多轮工具调用不会因为 422 中断。5. 本篇常见错排查HTTP 422 仍然出现检查 LiteLLM 版本是否支持drop_params旧版本可能不生效。升级到最新版并在 config.yaml 的litellm_settings和general_settings两处都加上drop_params: true。另外确认 Claude Code 的ANTHROPIC_BASE_URL没有多余后缀。HTTP 500 Missing credentialsLiteLLM 在路由时找不到对应提供商的 Key。在 config.yaml 里给每个 model 显式写api_key即使是本地模型也填not-needed。如果走 TaoToken确认 Key 没有多余空格且api_base是https://taotoken.net/api不带 UTM 参数。Claude Code 启动后报模型不存在ANTHROPIC_MODEL的值必须和 config.yaml 里的model_name完全一致。别名大小写敏感claude-opus-4-7和Claude-Opus-4-7会被当成两个模型。本地推理速度慢检查 oMLX 或 LM Studio 是否真的在用 GPU。可以用sudo powermetrics --samplers gpu_power观察 GPU 活跃度如果长期低于 10%说明模型没加载到 Metal 后端检查推理引擎的 GPU 层数设置。多轮对话后上下文丢失本地模型上下文窗口可能小于 Claude Code 默认请求长度。在 config.yaml 里给 model 加max_tokens和context_window参数或在 Claude Code 里限制单次任务范围。6. 长期编码场景的 Key 与通道选择如果你只是偶尔验证本地模型效果用模型对话页面发几条消息就够了。但 Claude Code 这类编码 Agent 的特点是调用频繁、上下文长、工具调用密集长期跑下来对 Key 的配额和通道稳定性要求更高。这种场景建议直接走 Coding Plan配合 TaoToken 的统一 Key 管理本地 LiteLLM 网关只做协议转换上游凭证和配额由 TaoToken 侧统一控制。接入文档在 https://taotoken.net/api 对应的文档页里面有各语言 SDK 的调用示例和错误码说明。API Keys 管理页面可以随时轮换 Key轮换后只需要改 LiteLLM config.yaml 里的一处Claude Code 侧不用动。这样本地模型和远端模型可以按任务类型分流日常补全走本地 Qwen复杂重构走 TaoToken 通道的上游模型两边共用一个网关配置。最后留一个实用技巧把 LiteLLM 的 config.yaml 和 Claude Code 的 settings.json 都纳入版本管理但 TaoToken 的 Key 用环境变量注入不要硬编码进文件。这样换机器或重装系统时配置可以一键恢复Key 单独管理。