OpenAI / New API Key 配置教程
1. 登录你的 New API / 中转站后台，在 API Keys 页面创建一个新的 API Key。
2. 创建 API Key 时选择当前教程对应的分组。只有选择了正确分组的 Key 才支持 OpenAI 兼容格式调用。
3. 准备两个核心参数：API Key 和 Base URL。
4. Base URL 一般填写站点地址并追加 /v1，例如：https://api.5946948.xyz/v1。
!
注意：直接使用 New API Key 时，核心就是把 OPENAI_API_KEY 和 OPENAI_BASE_URL 配好。不同工具名词不同，但本质都是这两个参数。
环境变量设置
macOS
Linux
Windows
临时设置（当前终端会话有效）
export OPENAI_API_KEY=your-api-key export OPENAI_BASE_URL=https://api.5946948.xyz/v1
永久设置（需要重启终端生效）
# 添加到 ~/.zshrc 或 ~/.bash_profile echo 'export OPENAI_API_KEY=your-api-key' >> ~/.zshrc echo 'export OPENAI_BASE_URL=https://api.5946948.xyz/v1' >> ~/.zshrc source ~/.zshrc
临时设置（当前终端会话有效）
export OPENAI_API_KEY=your-api-key export OPENAI_BASE_URL=https://api.5946948.xyz/v1
永久设置（需要重启终端生效）
# 添加到 ~/.bashrc echo 'export OPENAI_API_KEY=your-api-key' >> ~/.bashrc echo 'export OPENAI_BASE_URL=https://api.5946948.xyz/v1' >> ~/.bashrc source ~/.bashrc
临时设置（当前终端会话有效）
set OPENAI_API_KEY=your-api-key set OPENAI_BASE_URL=https://api.5946948.xyz/v1
永久设置（需要重启终端生效）
setx OPENAI_API_KEY "your-api-key" setx OPENAI_BASE_URL "https://api.5946948.xyz/v1"
常见使用方式
1）curl 调用测试
curl https://api.5946948.xyz/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer your-api-key" \
-d '{
"model": "gpt-4o-mini",
"messages": [
{"role": "user", "content": "你好，帮我测试一下接口是否可用"}
]
}'
2）Python 示例
from openai import OpenAI
client = OpenAI(
api_key="your-api-key",
base_url="https://api.5946948.xyz/v1"
)
resp = client.chat.completions.create(
model="gpt-4o-mini",
messages=[{"role": "user", "content": "你好"}]
)
print(resp.choices[0].message.content)
3）Node.js 示例
import OpenAI from "openai";
const client = new OpenAI({
apiKey: "your-api-key",
baseURL: "https://api.5946948.xyz/v1"
});
const resp = await client.chat.completions.create({
model: "gpt-4o-mini",
messages: [{ role: "user", content: "你好" }]
});
console.log(resp.choices[0].message.content);
注意事项
- 请把示例中的 your-api-key 替换成你的真实 API Key。
- Base URL 通常需要以 /v1 结尾，否则某些客户端可能无法正常请求。
- 如果工具支持“自定义 OpenAI 接口”或“OpenAI Compatible API”，通常都可以直接接入。
- 如果调用失败，优先检查：Key 分组、Base URL、模型名称、账单或额度、网络代理设置。
使用前准备
1. 创建 API Key 时请选择当前教程对应的 Claude Code 分组，避免与其他工具的 Key 混用。
2. 推荐使用 cc-switch 工具快速切换环境
查看 cc-switch 教程
cc-switch 是一个图形化工具，可以方便地管理多个 Claude Code 配置。
终端配置指南
macOS
Linux
Windows
临时设置（当前终端会话有效）
export ANTHROPIC_BASE_URL=https://api.5946948.xyz export ANTHROPIC_AUTH_TOKEN=your-api-key
永久设置（需要重启终端生效）
# 添加到 ~/.zshrc 或 ~/.bash_profile echo 'export ANTHROPIC_BASE_URL=https://api.5946948.xyz' >> ~/.zshrc echo 'export ANTHROPIC_AUTH_TOKEN=your-api-key' >> ~/.zshrc source ~/.zshrc
临时设置（当前终端会话有效）
export ANTHROPIC_BASE_URL=https://api.5946948.xyz export ANTHROPIC_AUTH_TOKEN=your-api-key
永久设置（需要重启终端生效）
# 添加到 ~/.bashrc echo 'export ANTHROPIC_BASE_URL=https://api.5946948.xyz' >> ~/.bashrc echo 'export ANTHROPIC_AUTH_TOKEN=your-api-key' >> ~/.bashrc source ~/.bashrc
临时设置（当前终端会话有效）
set ANTHROPIC_BASE_URL=https://api.5946948.xyz set ANTHROPIC_AUTH_TOKEN=your-api-key
永久设置（需要重启终端生效）
setx ANTHROPIC_BASE_URL "https://api.5946948.xyz" setx ANTHROPIC_AUTH_TOKEN "your-api-key"
使用说明
- 配置完成后，重新打开终端，再运行 Claude Code CLI。
- 如果你维护多个环境或多个站点，推荐配合 cc-switch 做一键切换。
- Claude Code 场景一般不需要手动追加 /v1，请按站点文档要求填写 Base URL。
- 当 Claude Code 无法识别认证信息时，优先检查 ANTHROPIC_AUTH_TOKEN 是否生效。
i
OpenAI Codex CLI 是本地编程代理工具。这里提供的是通过 New API Key / OpenAI 兼容接口接入的完整示例，推荐搭配 cc-switch 管理多个环境。
安装 Codex CLI
使用 npm 安装
npm install -g @openai/codex
使用 Homebrew 安装（macOS）
brew install --cask codex
或从 GitHub 下载二进制文件
GitHub Releases
配置代理 / 自定义提供方
1. 创建 API Key 时请选择当前教程对应的 Codex CLI 分组，避免与其他工具的 Key 混用。
2. 创建或编辑配置文件 ~/.codex/config.toml
config.toml 配置示例
# ~/.codex/config.toml model_provider = "newapi" model = "gpt-5.2" model_reasoning_effort = "high" disable_response_storage = true preferred_auth_method = "apikey" [model_providers.newapi] name = "newapi" base_url = "https://api.5946948.xyz/v1" wire_api = "responses" requires_openai_auth = true env_key = "WONG_API_KEY"
设置环境变量
macOS
Linux
Windows
临时设置（当前终端会话有效）
export WONG_API_KEY=your-api-key
永久设置（需要重启终端生效）
# 添加到 ~/.zshrc 或 ~/.bash_profile echo 'export WONG_API_KEY=your-api-key' >> ~/.zshrc source ~/.zshrc
临时设置（当前终端会话有效）
export WONG_API_KEY=your-api-key
永久设置（需要重启终端生效）
# 添加到 ~/.bashrc echo 'export WONG_API_KEY=your-api-key' >> ~/.bashrc source ~/.bashrc
临时设置（当前终端会话有效）
set WONG_API_KEY=your-api-key
永久设置（需要重启终端生效）
setx WONG_API_KEY "your-api-key"
启动使用
配置完成后，在终端运行 codex 即可启动。
首次运行如果提示登录，选择 Sign in with API key，然后使用 API Key 登录。
启动 Codex CLI
codex
注意事项
- 请将 your-api-key 替换为在当前教程对应分组创建的真实 API Key。
- Codex CLI 支持多种模型，可在 config.toml 中修改 model 参数。
- 如果你的站点要求别的环境变量名，只需要同时修改 env_key 和系统环境变量即可。
- 若要管理多个提供方或多个站点，最省事的方法是直接配合 cc-switch 切换。
cc-switch 是什么
cc-switch 是一个用于管理 Claude Code / Codex CLI 等配置环境的切换工具。
它适合有多个 API Key、多个站点、多个配置文件的人使用，可以避免反复手动改环境变量。
最典型的场景：开发环境 / 生产环境切换，不同代理站切换，不同团队 Key 切换。
推荐使用流程
1. 先准备好每个环境需要的参数，例如：Base URL、API Key、Provider 名称。
2. 在 cc-switch 中分别建立多个配置，比如“OpenAI 兼容环境”、“Claude Code 环境”、“Codex 测试环境”。
3. 给每个配置绑定对应的环境变量，例如 OPENAI_API_KEY、ANTHROPIC_AUTH_TOKEN、WONG_API_KEY。
4. 切换配置后，重新打开终端或刷新 Shell，再启动对应 CLI 工具。
建议配置示例
OpenAI / New API 场景
配置名称：openai-compatible OPENAI_API_KEY=your-api-key OPENAI_BASE_URL=https://api.5946948.xyz/v1
Claude Code 场景
配置名称：claude-code-main ANTHROPIC_BASE_URL=https://api.5946948.xyz ANTHROPIC_AUTH_TOKEN=your-api-key
Codex CLI 场景
配置名称：codex-main WONG_API_KEY=your-api-key CODEX_CONFIG=~/.codex/config.toml
使用建议
- 把不同用途的 Key 分开管理，不要让 Claude Code、OpenAI 兼容调用、Codex CLI 共用一个环境。
- 切换配置后，建议先用一个简单命令做连通性测试，再开始正式使用。
- 如果团队多人共用教程页，可以把常用环境预设名称统一，降低沟通成本。
- cc-switch 适合做“切换”，不适合把真实密钥直接公开展示在网页中。