文心5.5 Flash接入Claude Code配置教程

浏览：3次阅读

发布日期：2026-11-13

文心 5.5 Flash 接入 Claude Code 只要三步：在百度千帆创建 API Key，把 Claude Code 的 Base URL 改成千帆的 Anthropic 兼容地址 https://qianfan.baidubce.com/anthropic，模型填 ernie-5.5-flash-preview。不想开通千帆，也可以走 OpenRouter 的 baidu/ernie-5.5-flash-preview:free。

文心5.5 Flash接入Claude Code配置教程插图 — 图片来源：百度 ERNIE 官方发布页

文心 5.5 Flash Preview 是百度 11 月 11 日发布的 MoE 模型（总参数 2800 亿、激活 140 亿、100 万 token 上下文），模型规格和价格可以先看本站的文心 5.5 Flash Preview 发布解读。下面只讲怎么把它配进 Claude Code，所有地址和参数都来自千帆、OpenRouter 和 Claude Code 的官方文档。

已安装 Claude Code（npm 安装命令：npm install -g @anthropic-ai/claude-code，需要 Node.js 18 及以上）；
一个百度智能云账号，用于登录千帆控制台；
知道 Claude Code 配置文件的位置：macOS/Linux 为 ~/.claude/settings.json，Windows 为 %USERPROFILE%\.claude\settings.json。

按千帆「快速开始」文档的说明：登录千帆控制台，进入「安全认证 → API Key」，点击「创建 API Key」。在「服务」里勾选要调用的能力范围（调用模型选 ModelBuilder 即可）。创建好的 Key 形如 bce-v3/ALTAK-xxxx/xxxx，整串复制保存，后面要用。

千帆模型列表中，文心 5.5 Flash Preview 的 model 参数是 ernie-5.5-flash-preview（全小写），上下文、最大输入、最大输出都标为 1M，同时出现在「文本生成」和「深度思考」两栏里。

千帆的 Anthropic Claude API 兼容文档写明：全量 Chat 对话接口都兼容 Anthropic 规范，可以直接给 Claude Code 用。配置前建议先发一个最小请求，确认 Key 和模型名都没问题：

curl https://qianfan.baidubce.com/anthropic/v1/messages \
  -H "x-api-key: 你的千帆 API Key" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{"model":"ernie-5.5-flash-preview","max_tokens":256,"messages":[{"role":"user","content":" 你好 "}]}'

返回里能看到 "type":"message" 和模型回复的文本，就说明接口通了。Windows 用户可以在 Git Bash 或 WSL 里执行这条命令。

打开 ~/.claude/settings.json（没有就新建），写入下面的内容，把第一行换成你自己的千帆 API Key：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "你的千帆 API Key",
    "ANTHROPIC_BASE_URL": "https://qianfan.baidubce.com/anthropic",
    "ANTHROPIC_MODEL": "ernie-5.5-flash-preview",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "ernie-5.5-flash-preview",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "ernie-5.5-flash-preview",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "ernie-5.5-flash-preview",
    "CLAUDE_CODE_MAX_OUTPUT_TOKENS": "16000",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "API_TIMEOUT_MS": "600000"
  }
}

图片来源：Claude Code 官方文档（Settings）

各字段的作用：

ANTHROPIC_AUTH_TOKEN：千帆 API Key，Claude Code 会以 Authorization: Bearer 的形式发送；
ANTHROPIC_BASE_URL：千帆 Anthropic 兼容地址，末尾不要加 /v1；
ANTHROPIC_MODEL 和三个 ANTHROPIC_DEFAULT_*_MODEL：让主模型以及 Opus/Sonnet/Haiku 别名都指向文心 5.5 Flash，避免后台任务去请求千帆上不存在的 Claude 模型名；
API_TIMEOUT_MS：单次请求等待响应头的超时（毫秒），官方默认就是 600000；
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC：关闭自动更新、遥测等非必要流量。

千帆文档的示例里用的是 ANTHROPIC_SMALL_FAST_MODEL，但 Claude Code 官方环境变量文档已把它标为 DEPRECATED，新版本用 ANTHROPIC_DEFAULT_HAIKU_MODEL 代替，上面的配置按新写法给出。settings.json 其他字段的含义，可以参考 Claude Code settings.json 配置文件详解。

如果第一次启动时 Claude Code 强制要求登录 Anthropic 账号，千帆文档给的办法是在 ~/.claude.json 里加上：

{"hasCompletedOnboarding": true}

进入项目目录执行 claude，输入 /status 查看当前使用的模型和 API 地址。看到 ernie-5.5-flash-preview 和 qianfan.baidubce.com 后，随便让它读一个文件或写一个函数，确认能正常调用工具。

费用方面，按千帆「模型服务计费」文档，ERNIE-5.5-Flash-Preview 高峰时段（8:00–22:00）活动价为每百万 token 输入 1 元、输出 4 元，空闲时段减半；活动结束后按原价（翻倍）计算。Claude Code 每轮会带上较长的系统提示和文件内容，输入 token 消耗会比聊天多不少。

图片来源：OpenRouter 模型页

OpenRouter 上的模型 ID 是 baidu/ernie-5.5-flash-preview:free，由百度千帆提供服务，页面标价为 0，但免费模型有速率限制。OpenRouter 官方的 Claude Code 接入指南要求：Base URL 填 https://openrouter.ai/api，Key 放在 ANTHROPIC_AUTH_TOKEN，并把 ANTHROPIC_API_KEY 显式设为空。可以写在项目根目录的 .claude/settings.local.json 里：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://openrouter.ai/api",
    "ANTHROPIC_AUTH_TOKEN": "你的 OpenRouter API Key",
    "ANTHROPIC_API_KEY": "","ANTHROPIC_MODEL":"baidu/ernie-5.5-flash-preview:free","ANTHROPIC_DEFAULT_HAIKU_MODEL":"baidu/ernie-5.5-flash-preview:free"
  }
}

如果之前用 Anthropic 账号登录过 Claude Code，需要先在 Claude Code 里执行一次 /logout 清掉缓存的登录状态，否则会出现认证冲突。另外，官方提醒原生安装版 Claude Code 不读取项目里的 .env 文件，变量不要写在那里。

笔者用一个无效 Key 实测请求千帆 Anthropic 兼容接口，返回 HTTP 401，错误内容为：

{"error":{"code":"invalid_iam_token","message":"invalid_iam_token","type":"invalid_request_error"}, ...}

说明 Key 不对或没生效。检查是否完整复制了 bce-v3/ALTAK-…/… 整串、前后有没有多余空格，以及 Key 是否勾选了模型调用的服务权限。更多认证类问题见 Claude Code 报错 401/403 排查。

千帆的 model 参数必须是 ernie-5.5-flash-preview，不能写成控制台显示的 ERNIE-5.5-Flash-Preview；OpenRouter 则必须带 baidu/ 前缀，免费版还要带 :free 后缀。两边的写法不能混用。

系统环境变量里如果还留着旧的 ANTHROPIC_BASE_URL 或 ANTHROPIC_API_KEY，可能和 settings.json 冲突。先在终端用 echo $ANTHROPIC_BASE_URL（Windows PowerShell 用 echo $env:ANTHROPIC_BASE_URL）检查，再重开终端启动 Claude Code。

长任务可适当调大 API_TIMEOUT_MS。429 表示触发了限流：千帆按模型列表里的 RPM/TPM 默认流控限制，OpenRouter 免费版本身就有速率限制，高频使用建议改用千帆按量付费。

不能。百度官方发布页写明它是纯文本模型，往 Claude Code 里粘贴截图不会被模型识别。

千帆同时提供 OpenAI 兼容接口，Base URL 为 https://qianfan.baidubce.com/v2，Key 同样用 Authorization: Bearer 方式传递，支持自定义 OpenAI 兼容服务商的客户端都可以按这个地址和模型名配置。

官方明确说 Preview 是后训练中的中间版本，部分能力可能还不到位，正式版会在后续推出。建议先拿自己的项目小范围试用。