国内直连 Claude Code：从零配置到稳定运行（2026 避坑版）

适用：中国大陆开发者，想用 Anthropic 官方 CLI（Claude Code）稳定接入 Claude，又不想折腾代理。目标：5 分钟跑通，提前避开高频坑。

一、5 分钟最小配置

1. 安装 Claude Code

npm install -g @anthropic-ai/claude-code

或用官方脚本：

curl -fsSL https://claude.ai/install.sh | bash

2. 配置环境变量（关键就三个）

export ANTHROPIC_BASE_URL=https://api.example.com

export ANTHROPIC_AUTH_TOKEN=sk-你的key

export ANTHROPIC_MODEL=claude-sonnet-4-6

说明：

ANTHROPIC_BASE_URL：国内可达的兼容端点。注意：通常不带 /v1（见坑1）

ANTHROPIC_AUTH_TOKEN：你的 API Key，在中转平台控制台生成

ANTHROPIC_MODEL：选择你账号可用、有额度的模型

3. 启动验证

claude

能正常对话即成功。若失败，直接看下文"快速排查"。

小提示：不想用命令行环境变量，也可以用图形化切换工具（如 CC Switch）一键切换多个配置，原理相同——改的都是上面三个值。

二、三个最容易踩的坑（重点）

坑1：base_url 带不带 /v1，别凭感觉

这是出现率最高的问题。Claude Code 走 Anthropic 原生协议时，base_url 通常是裸域名，不带 /v1。

你在中转平台后台看到的可能是 https://xxx.com/v1（OpenAI 兼容端点）

但 Claude Code 用的是 Anthropic 原生端点，路径是 /v1/messages 整段

如果你把 ANTHROPIC_BASE_URL 设成 https://xxx.com/v1，请求会变成 /v1/v1/messages，返回 404。判据：看平台文档给 Claude Code 的 base_url 是裸域还是带 /v1，严格照抄，不要自己拼。

坑2：协议被"悄悄降级"，高级功能失效

Claude 的高级能力（extended_thinking 思考模式、tool_use 工具调用、多模态输入）依赖 Anthropic 原生协议透传。

只做 OpenAI 兼容转译的端点，会把 thinking、tool_use 等字段截断或丢弃

表现：claude 能启动但思考模式失效、工具调用报错、能力缩水

选型判据：优先选原生协议透传的平台；用 Claude Code / Cline 这类工具时，别只看"OpenAI 兼容"这一个标签。

坑3：429 报错别急着改配置，先看响应体

中转直连遇到 429，多数不是限流，而是上游余额不足。响应体形如：

{"error": {"code": 429, "message": "Tier: 未充值"}}

先 curl 直接打一次端点拿响应体，确认是"余额不足"还是"限流"

余额不足：去平台充值或检查套餐

限流：降并发或换空闲模型

盲目改 base_url、改重试、换工具，都是浪费时间

三、进阶：MCP 与多模型

MCP：Claude Code 原生支持 MCP 服务，配置 claude mcp add 即可接入你的 Agent 工具链

多模型：同一把 key 可切换 Claude / GPT / Gemini / DeepSeek 等聚合模型，改 ANTHROPIC_MODEL 即可，无需换 key

响应式 API：部分平台额外提供 /v1/responses（OpenAI 新协议），供非 Claude Code 的工具链使用

四、快速排查

现象与处理对照：

404 / 路径找不到：base_url 多拼了 /v1 或拼错。处理：对照平台文档重抄 base_url（见坑1）

429 "未充值"：上游余额不足。处理：充值或查套餐，别改配置（见坑3）

思考模式失效 / 工具报错：协议被转译降级。处理：换原生协议透传的平台（见坑2）

请求超时中断：网络不稳或端点不支持流式。处理：换国内直连端点，关代理

本文为通用技术教程，文中示例配置仅用于演示接入方法，可套用于任何同类合规平台。