小贺AI产品与教程中心
配置教程进入小贺API
首页小贺AI小贺APIAI知识库画图提示词MCPSkills配置教程AI动态
配置教程进入小贺API
配置教程

Codex / Claude Code 手动配置 API 教程

不用 CC Switch，直接填写 Base URL、API Key 与模型

小贺AI编辑部实测更新 2026-09-16阅读约 12 分钟

开始前请先准备 Base URL、API Key、模型 ID，以及你要使用的客户端协议。
我用 Codex 我用 Claude Code 我想用 CC Switch

一个工具，连接更多可能

Codex
CodexClaude Code
Codex 配置示例
model_provider = "api"
model = "gpt-5.6-sol"
base_url = "https://api.xiao-he.top"
Claude Code 配置示例
$env:ANTHROPIC_BASE_URL="https://api.xiao-he.top"
$env:ANTHROPIC_API_KEY="sk-..."
$env:ANTHROPIC_MODEL="gpt-5.6-sol"
1

开始前先准备 4 项信息

在配置 Codex 或 Claude Code 之前，请先准备好以下信息。

Base URL

API 服务的基础地址
直连客户端：https://api.xiao-he.top

API Key

用于身份验证的密钥
以 sk- 开头的一串字符

模型 ID

本教程使用的模型名称
gpt-5.6-sol

协议

Codex 使用 Responses
Claude Code 使用网关兼容协议

2

Codex 的手动配置方式

Codex 支持通过 config.toml 设置模型与自定义 Provider，API Key 通过登录流程保存。

config.tomlTOML
model_provider = "api"
model = "gpt-5.6-sol"
model_reasoning_effort = "xhigh"

[model_providers.api]
name = "Xiaohe API"
base_url = "https://api.xiao-he.top"
wire_api = "responses"
requires_openai_auth = true

配置说明

  • 写入 %USERPROFILE%\.codex\config.toml
  • base_url 使用根地址，不加 /v1
  • model 固定为 gpt-5.6-sol
  • wire_api 使用 responses
  • 保存后完全重启 Codex
3

Claude Code 的手动配置方式

Claude Code 通常通过环境变量连接网关；首次验证建议只在当前 PowerShell 会话设置。

PowerShell环境变量
$env:ANTHROPIC_BASE_URL = "https://api.xiao-he.top"
$env:ANTHROPIC_API_KEY = "sk-替换为你自己的API Key"
$env:ANTHROPIC_MODEL = "gpt-5.6-sol"
claude

配置说明

  • ANTHROPIC_BASE_URL 使用根地址
  • ANTHROPIC_API_KEY 填写自己的 Key
  • ANTHROPIC_MODEL 使用 gpt-5.6-sol
  • 从同一个 PowerShell 启动 claude
  • 启动后运行 /status 核对来源
4

Base URL 与 /v1 怎么判断

不同客户端可能使用不同形式的 URL。下面是小贺API当前这组配置的填写方式。

直连客户端：不加 /v1

Codex 与 Claude Code 会按各自协议追加请求路径。

https://api.xiao-he.top
  • Codex 使用 Responses 路径
  • Claude Code 使用网关兼容路径
  • 避免最终 URL 重复出现版本段

OpenAI SDK：使用 /v1

Python OpenAI SDK、通用 OpenAI 客户端或明确要求兼容地址时使用。

https://api.xiao-he.top/v1
  • 适用于 /v1/models 等兼容端点
  • 不要把 SDK 地址照搬进 Codex Provider
  • 以当前客户端教程为最终依据
5

如何验证配置成功

配置完成后，用一个最小请求确认地址、API Key 和模型是否都能正常工作。

Python 最小验证OpenAI SDK
import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.xiao-he.top/v1",
    api_key=os.environ["OPENAI_API_KEY"],
)
response = client.responses.create(
    model="gpt-5.6-sol",
    input="只回复：连接成功",
)
print(response.output_text)

出现以下结果，说明配置成功

  • 能够正常返回“连接成功”
  • 没有出现 401、404、429 等错误
  • Codex 与 Claude Code 能使用 gpt-5.6-sol
  • 控制台中能看到对应请求记录
  • 请求结束后未暴露完整 API Key
6

常见错误

如果配置后仍然无法使用，可按下面的错误码快速定位。