Shana KBCodex / Claude Code 中转站指南

知识库

Claude Code 接入 OpenAI 兼容中转：从 Key 到第一次对话

TL;DR

  • 接入只需要三件套：API Key + Base URL + 模型名。本文全部步骤在真实环境跑通。
  • 快速验证用环境变量直连（两条命令，不碰任何配置文件）；长期使用用 CC Switch 管理。
  • 可用模型列表由 Key 的分组决定——连不上模型先看分组，不是配置错。

阶段 0：准备好三件套

开始前确认三样东西都在手边（都来自服务方控制台，本文以 OpenAI 兼容中转为例）：

三件套是什么在哪拿
API Keysk- 开头的访问凭据控制台「API 密钥」页创建
Base URL服务接入地址（本文示例 https://shana.baby/v1）服务方使用文档
模型名你要调用的模型标识服务方模型列表，或 GET /v1/models

创建 Key 时注意分组：分组决定这把 Key 能用什么模型、按什么倍率计费。下图是控制台的密钥列表，可见不同 Key 挂在不同分组（如 claude max、chat gpt 渠道）：

控制台 API 密钥列表页：三把 Key 分属不同分组

点「创建密钥」后按需填写：名称随便起、分组按你要用的模型选，下面的额度限制 / IP 限制 / 速率限制 / 有效期都是 Key 级可选控件，按需开启：

创建密钥对话框：名称、分组与 Key 级限制选项

阶段 1：环境变量直连（最快验证）

不推荐一上来就改配置文件。先用环境变量把链路跑通——它只对当前终端会话生效，退出即消失，零风险：

macOS / Linux：

export ANTHROPIC_BASE_URL="https://shana.baby/v1"
export ANTHROPIC_AUTH_TOKEN="sk-你的Key"

# 直接发起一次真实对话验证
claude -p "用一句话介绍你自己" --model claude-sonnet-4-6

Windows PowerShell：

$env:ANTHROPIC_BASE_URL = "https://shana.baby/v1"
$env:ANTHROPIC_AUTH_TOKEN = "sk-你的Key"
claude -p "用一句话介绍你自己" --model claude-sonnet-4-6

真实返回（2026-09-13 实测，模型 claude-sonnet-4-6）：

我是 Claude，一个由 Anthropic 模型驱动的交互式软件工程助手，可以帮你写代码、修 bug、重构和解答技术问题。

看到这样的回复，说明链路已通。验证用的模型名可以先用 GET /v1/models 查——本文实测某 claude 分组返回 9 个可用模型（haiku-4-5 / sonnet-4-6 / opus-4-6 / 4-7 / 4-8 / fable-5 / fable-5-1 / opus-5 / sonnet-5），你的列表以你的 Key 分组为准。

阶段 2：CC Switch 长期管理

验证通过后，如果你在多个服务商之间切换，用 CC Switch 管理比每次敲环境变量省力——它把不同服务商的配置存成预设，一键切换：

CC Switch 的供应商列表界面

操作路径：点右上角「+」新增供应商 → 填名称、Base URL（https://shana.baby/v1）和 API Key → 保存后在列表选中即生效。部分中转平台的控制台提供了「导入到 CCS」按钮，可以免手工填写直接把 Key 配置带进 CC Switch。

切换后如果发现「切了没反应」，别急着重装——那是另一类问题，见CC Switch 切了没反应：一份生效排查清单。

阶段 3：写进日常配置

确定长期使用某一家后，把环境变量写进 shell 配置文件持久化：

# ~/.zshrc 或 ~/.bashrc 追加（Windows 用「系统属性 → 环境变量」）
export ANTHROPIC_BASE_URL="https://shana.baby/v1"
export ANTHROPIC_AUTH_TOKEN="sk-你的Key"

两个注意点：①source 一下或重开终端才会生效；②之后若改用 CC Switch 管理，把这两行删掉——环境变量残留是「切换不生效」的头号原因（见上文排查清单）。

连不上了？

按症状对号入座：Invalid API key / 401 / 404 model not found 等报错串见Claude Code 连不上 API：6 个报错串对照排查；429 / 502 / 530 等状态码见状态码速查表；额度类报错见insufficient_quota 决策树。Codex CLI 的接入配置（config.toml 与 Provider 写法）在主站：Codex API 配置自检。

维护说明

本文全部命令与返回结果于 2026-09-13 在真实环境（Claude Code 2.1.177 / CC Switch 当前版 / OpenAI 兼容中转）实测跑通；变量名与配置文件路径以 Claude Code 官方文档为准，工具大版本更新后复测并更新日期。

更多相关指南