一、先区分两种接入方式

Codex

Codex 接第三方 API 时，通常看这几项：

model_provider base_url env_key model

如果使用 OpenAI 兼容接口，Base URL 通常是：

https://你的51relay域名/v1

Claude Code

Claude Code 接第三方 API 时，通常看这几项环境变量：

ANTHROPIC_BASE_URL ANTHROPIC_AUTH_TOKEN ANTHROPIC_MODEL

Base URL 通常是：

https://你的51relay域名

不要把 Codex 和 Claude Code 的配置混用。

二、配置前先测试 API

先测试 OpenAI 兼容接口：

export RELAY_BASE_URL="https://你的51relay域名/v1" export RELAY_API_KEY="sk-xxxxxxxxxxxxxxxx"

查询模型：

curl -sS "$RELAY_BASE_URL/models" \ -H "Authorization: Bearer $RELAY_API_KEY"

最小请求：

curl -sS "$RELAY_BASE_URL/chat/completions" \ -H "Authorization: Bearer $RELAY_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "你的模型名", "messages": [ { "role": "user", "content": "你好，请回复一句：接口已接通" } ] }'

如果这一步不通，不建议继续配置 Codex 或 Claude Code。

三、Codex 配置 51relay

1. 保存 API Key

export FIFTYONERELAY_API_KEY="sk-xxxxxxxxxxxxxxxx"

长期保存：

echo 'export FIFTYONERELAY_API_KEY="sk-xxxxxxxxxxxxxxxx"' >> ~/.zshrc source ~/.zshrc

检查是否生效：

echo "$FIFTYONERELAY_API_KEY"

2. 编辑 Codex 配置

mkdir -p ~/.codex nano ~/.codex/config.toml

写入：

[model_providers.51relay] name = "51relay" base_url = "https://你的51relay域名/v1" env_key = "FIFTYONERELAY_API_KEY" wire_api = "chat" [profiles.51relay-gpt54] model_provider = "51relay" model = "gpt-5.4" [profiles.51relay-gpt55] model_provider = "51relay" model = "gpt-5.5"

3. 启动 Codex

codex --profile 51relay-gpt54

或：

codex --profile 51relay-gpt55

四、Codex 常见错误

1. 找不到 provider

检查：

1. config.toml 路径是否是 ~/.codex/config.toml
2. [model_providers.51relay] 名称是否写错
3. [profiles.xxx] 里的 model_provider 是否对应 51relay

2. 401

检查环境变量：

echo "$FIFTYONERELAY_API_KEY"

如果为空，说明 Key 没有生效。

3. 404

检查 base_url：

base_url = "https://你的51relay域名/v1"

OpenAI 兼容接口一般需要 /v1。

4. model not found

先查模型列表：

curl -sS "$RELAY_BASE_URL/models" \ -H "Authorization: Bearer $RELAY_API_KEY"

然后把返回里的模型名复制到：

model = "你的模型名"

五、Claude Code 配置 51relay

Claude Code 适合使用 Claude 兼容接口。

1. 设置环境变量

export ANTHROPIC_BASE_URL="https://你的51relay域名" export ANTHROPIC_AUTH_TOKEN="sk-xxxxxxxxxxxxxxxx" export ANTHROPIC_MODEL="claude-sonnet-4-5"

2. 启动

claude

3. 长期保存

cat >> ~/.zshrc <<'EOF' export ANTHROPIC_BASE_URL="https://你的51relay域名" export ANTHROPIC_AUTH_TOKEN="sk-xxxxxxxxxxxxxxxx" export ANTHROPIC_MODEL="claude-sonnet-4-5" EOF source ~/.zshrc

4. 检查环境变量

echo "$ANTHROPIC_BASE_URL" echo "$ANTHROPIC_AUTH_TOKEN" echo "$ANTHROPIC_MODEL"

六、Claude Code 常见错误

1. 401

通常是 ANTHROPIC_AUTH_TOKEN 错。

检查：

echo "$ANTHROPIC_AUTH_TOKEN"

2. 404

通常是 ANTHROPIC_BASE_URL 填错。

推荐：

https://你的51relay域名

不推荐：

https://你的51relay域名/v1/messages

因为 Claude Code 会自己拼接请求路径。

3. 模型不可用

检查：

echo "$ANTHROPIC_MODEL"

模型名要以 51relay 控制台或服务端支持列表为准。

七、Codex 和 Claude Code 配置对照表

工具	协议倾向	地址示例	Key 配置	模型配置
Codex	OpenAI 兼容	https://你的51relay域名/v1	FIFTYONERELAY_API_KEY	config.toml 中的 model
Claude Code	Claude 兼容	https://你的51relay域名	ANTHROPIC_AUTH_TOKEN	ANTHROPIC_MODEL

八、推荐排查顺序

curl 测试 API -> 查询模型列表 -> 配置环境变量 -> 检查环境变量是否生效 -> 配置 Codex / Claude Code -> 启动工具 -> 根据 401 / 404 / model not found 定位

不要一开始就反复改工具配置，先确保 API 自己是通的。

九、总结

Codex 和 Claude Code 接第三方 API 地址时，最关键的是：

1. Codex 用 OpenAI 兼容接口时，base_url 通常带 /v1
2. Claude Code 用 Claude 兼容接口时，ANTHROPIC_BASE_URL 通常填基础域名
3. Key 要放到对应环境变量
4. 模型名要以服务端实际支持为准

本文用 51relay 作为示例。51relay 只做 GPT / Claude API 中转，支持 OpenAI 兼容和 Claude 兼容接入，适合 Codex、Claude Code、AI 工具配置和自动化工作流。