接入指南
不需要先理解接口术语。ChatGPT 风格的图形聊天客户端、Visual Studio Code(简称 VS Code,不是 Visual Studio)和 PyCharm 都有独立步骤;找到你正在使用的软件,只看对应的一节,照着“打开或点击 → 输入 → 验证 → 切换模型 → 切回原配置”完成即可。
你想在哪个软件里使用?
选择最接近的一项。每个场景都是独立教程,不必从头读完整页。
所有场景都先准备这 3 样东西
与软件匹配的模型 ID
在价格页复制完整模型 ID。聊天客户端和 Python GPT 示例选择 Chat;Codex 选择 Responses;Claude Code 选择 Messages。
gpt-5.6-terragpt-5.6-solgpt-5.6-lunagpt-5.5gpt-5.4gpt-5.4-minigpt-5.3-codex-sparkgpt-5.6-terragpt-5.6-solgpt-5.6-lunagpt-5.5gpt-5.4gpt-5.4-minigpt-5.3-codex-sparkclaude-fable-5claude-opus-5claude-opus-4-8claude-opus-4-7claude-opus-4-6claude-sonnet-5claude-sonnet-4-6claude-haiku-4-5图形客户端:先选产品,再选系统
这里只分三条路线。先按用途选产品,再点击下方醒目的系统按钮;之后页面只保留你当前系统需要看的步骤。
在 ChatGPT 桌面应用中配置 Codex
这不是普通 Chat 对话。请使用页面顶部的系统选择;此处只显示你当前系统需要执行的 Codex 图形配置步骤。
gpt-5.6-terragpt-5.6-solgpt-5.6-lunagpt-5.5gpt-5.4gpt-5.4-minigpt-5.3-codex-spark每个人创建自己的 Key
管理员只需要发这一份通用教程,不需要发送或代填 API Key。用户登录自己的账号,在API 密钥页创建 Key 并暂时保存。安装程序稍后会在用户自己的 Mac 上弹出隐藏输入框。
只运行一次通用安装程序
本安装器只适用于 macOS 上的当前版 ChatGPT 桌面应用。第一次使用新电脑时,请先从原图标打开 ChatGPT,按页面提示完成一次账号登录;进入应用后再继续。请只保留“应用程序”文件夹里的一份 ChatGPT.app;如果桌面还有一份,请手动移走后再配置。首次配置时,macOS 还可能询问终端访问桌面、钥匙串或控制 ChatGPT 的权限,请选择允许。
- 按
Cmd+Q完全退出 ChatGPT。 - 打开 Terminal / 终端,复制下面整段命令并回车。
- 出现“FengyuToken 配置”弹窗后,粘贴该用户自己的 Key,点击“保存”。输入不会显示,Key 不会写入 TOML。
set -e
INSTALLER="$HOME/Downloads/install-fengyutoken-codex-macos.sh"
curl -fsSL 'https://fengyutoken.com/downloads/fengyutoken-codex-macos.sh' -o "$INSTALLER"
chmod 700 "$INSTALLER"
"$INSTALLER"安装程序会自动找到电脑上真正的 ChatGPT.app,验证 OpenAI 签名与 macOS 公证,为独立模式准备 Computer Use 组件,创建 ~/.codex-fengyu,并只在桌面生成一个 启动 FengyuToken Codex 应用。该入口会复用电脑里的 ChatGPT 图标,不会修改官方 ~/.codex 或删除 ChatGPT 登录,也不会处理其他目录的组件。
旧版 macOS:启用一键更新(只需一次)
set -e
INSTALLER="$HOME/Downloads/update-fengyutoken-codex-macos.sh"
curl -fsSL 'https://fengyutoken.com/downloads/fengyutoken-codex-macos.sh' -o "$INSTALLER"
chmod 700 "$INSTALLER"
FENGYU_UPDATE_ONLY=1 "$INSTALLER"双击桌面的「启动 FengyuToken Codex」
以后不要用原 ChatGPT 图标启动本站模式,直接双击桌面上新生成的 启动 FengyuToken Codex。它是一个带 ChatGPT 图标的 macOS 应用入口,启动时不会打开终端窗口。FengyuToken Codex 已经在运行时,再次双击只会唤醒现有窗口;没有 ChatGPT 进程时会直接启动。只有官方模式或其他配置正在运行时,才会正常退出旧进程后切换。
FengyuToken;右下角显示 5.6 Terra(通用旗舰) 或另一个已上架的 Responses 模型。之后发送“只回复 CONNECTED”,并到调用用量确认有新记录。Cmd+W 关闭窗口,不要按 Cmd+Q 完全退出。这样再次双击桌面入口时会直接恢复现有窗口。若电脑直连 ChatGPT 服务较慢,冷启动可能需要等待桌面外壳完成账号与功能初始化;这不代表本站 API 连接慢。使用规则代理时,可让 ChatGPT / OpenAI 相关地址走代理,同时让本站地址保持直连。应用外壳仍可能保留原 ChatGPT 登录,这不代表配置失败。请以左下角服务名、右下角模型和本站用量记录为准。
切换模型或推理强度;官方账号仍用原图标
切换模型:用右下角的模型按钮切换另一个 Responses 模型;在同一处的 Reasoning / 推理强度 选择 Low、Medium 或 High。Low 更快,High 推理更深入且通常更慢。此前已配置但看不到该选项:先按 Cmd+Q 退出,再执行上方“旧版 macOS:启用一键更新”命令一次,然后从桌面入口重新打开;不会再次要求输入 Key。打开官方 Codex:先按 Cmd+Q 完全退出 FengyuToken Codex,再双击原来的 ChatGPT / Codex 图标。原图标不会携带独立 CODEX_HOME,因此会使用原官方配置。
Windows:生成「启动 FengyuToken Codex」图形客户端入口
安装并退出 ChatGPT 图形应用;再打开 PowerShell
- 先从 Microsoft Store 安装最新版 ChatGPT。未安装时,可在 PowerShell 运行
winget install --id 9PLM9XGG6VKS -s msstore。 - 安装后打开 ChatGPT 一次,再完全退出应用。
- 在开始菜单搜索并打开 Windows PowerShell;不要用 CMD。
- 用户在API 密钥页创建并保存完整 Key。
复制这一行,一键安装
只复制下面这一整行到 Windows PowerShell,按一次回车。它会下载最新版安装器、验证 Key、Responses 模型和一次真实请求,并创建新的桌面入口;不会覆盖或启动原官方客户端。
[Net.ServicePointManager]::SecurityProtocol=[Net.ServicePointManager]::SecurityProtocol -bor [Net.SecurityProtocolType]::Tls12; $i=Join-Path $env:TEMP "fengyutoken-codex-win.ps1"; Invoke-WebRequest -UseBasicParsing "https://fengyutoken.com/downloads/fengyutoken-codex-windows.ps1?v=20260814-shortcut-guard2" -OutFile $i; powershell.exe -NoProfile -ExecutionPolicy Bypass -File $i在弹窗中粘贴这位用户自己的 Key
请先在密钥页点“领取并复制”,确认显示“已复制完整 Key”,然后立即粘贴到弹窗。Key 不显示、不写入 TOML,Windows 会用当前账号的 DPAPI 加密保存。本站配置只写入 %USERPROFILE%\.codex-fengyu;不会覆盖官方 %USERPROFILE%\.codex。
先验证原官方图标,再启动本站模式
安装完成后不会自动启动 ChatGPT。先点击安装前就存在的官方 ChatGPT/Codex 图标,确认原官方账号仍能正常打开;然后从应用菜单完全退出,任务管理器中确认没有 ChatGPT.exe,再双击桌面「启动 FengyuToken Codex」。点左上角产品名称进入 Codex 并创建任务;普通 Chat / Work 不会使用本站 Key。默认模型由安装器从当前可用列表自动选择;右下角既可切换 Responses 模型,也可在 Reasoning / 推理强度 选择 Low、Medium 或 High。Low 更快,High 推理更深入且通常更慢。此前已配置但看不到该选项:从应用菜单完全退出后,先执行下方一次“启用一键更新”命令;以后打开桌面入口会自动检查更新,无需重新输入 Key。输入“只回复 CONNECTED”,并在调用用量看到新记录,才算配置完成。
旧版 Windows:启用一键更新(只需一次)
[Net.ServicePointManager]::SecurityProtocol=[Net.ServicePointManager]::SecurityProtocol -bor [Net.SecurityProtocolType]::Tls12; $i=Join-Path $env:TEMP "fengyutoken-codex-update.ps1"; Invoke-WebRequest -UseBasicParsing "https://fengyutoken.com/downloads/fengyutoken-codex-windows.ps1" -OutFile $i; powershell.exe -NoProfile -ExecutionPolicy Bypass -File $i -UpdateOnly更新只替换本站管理的模型目录、启动脚本和图标;DPAPI 保存的 Key、官方 .codex 与官方快捷方式均不会改动。
三个入口的用途与单实例限制
- 使用本站:双击桌面新生成的「启动 FengyuToken Codex」,它只给本次启动设置独立的
CODEX_HOME=%USERPROFILE%\.codex-fengyu。 - 使用官方账号:先完全退出 ChatGPT,再点击原来的官方 ChatGPT/Codex 图标;它仍使用原官方账号和配置。
- 保险入口:安装器还会额外生成「切回 OpenAI 官方 Codex」,在完全退出后可用它明确按官方
%USERPROFILE%\.codex启动;它不会替换原官方图标。 - 换模型或 Key:模型只选已上架的 Responses 模型;更换 Key 时重新执行第 2 步。
在 Claude Desktop 中配置 Code
在官方 Claude Desktop 的 Code 图形界面中使用 FengyuToken。页面顶部已选定系统后,这里只显示相应教程;Windows 不需要另外安装 Claude Code CLI。
使用独立配置和钥匙串,不覆盖原有 Claude 登录,也不会修改 ~/.claude。
准备 Claude、余额和 Key
- 从 Claude 官方下载页安装最新版 Claude,将
Claude.app放进「应用程序」,并至少打开一次。 - 到本站API 密钥创建并保存自己的完整 Key;到充值页确认可用余额至少为 $2。
- 打开 Terminal / 终端,运行:
curl -fsSL https://claude.ai/install.sh | bash
claude --version运行一次一键安装
复制整段命令到终端并回车;弹窗出现后,粘贴这个用户自己的 Key。Key 会保存到当前 macOS 用户的钥匙串。
set -e
INSTALLER="$HOME/Downloads/install-fengyutoken-claude-code-macos.sh"
curl -fsSL 'https://fengyutoken.com/downloads/fengyutoken-claude-code-macos.sh' -o "$INSTALLER"
chmod 700 "$INSTALLER"
"$INSTALLER"安装器会发出一次极小的真实连接测试,成功后才保存 Key 并生成桌面入口;失败不会覆盖旧入口。
旧版 Claude macOS:启用一键更新(只需一次)
set -e
INSTALLER="$HOME/Downloads/update-fengyutoken-claude-code-macos.sh"
curl -fsSL 'https://fengyutoken.com/downloads/fengyutoken-claude-code-macos.sh' -o "$INSTALLER"
chmod 700 "$INSTALLER"
FENGYU_UPDATE_ONLY=1 "$INSTALLER"启用后,桌面的 Claude Code 入口会在下次打开时自动检查本站管理的本机更新;不会读取或改写 Gateway 中已保存的 Key。
在 Claude 中填写连接
即使 Claude 当前显示登录页,也不用先登录,直接使用屏幕最上方菜单栏:
- Help → Troubleshooting → Enable Developer Mode。
- Developer → Configure Third-Party Inference…。
- Connection type:
Gateway。 - Credential kind:
Static API key。 - Gateway API key:再次粘贴同一枚 Key。
- Gateway auth scheme:
Bearer。 - Gateway base URL:
https://fengyutoken.com,不要加/v1。
只添加 Opus,然后保存
- 在 Models 中把 Model discovery 开关关闭。
- 删除自动出现的模型。首次验证建议只保留
claude-opus-5;Model ID 和 Display name 都填同一 ID,Tier alias 选opus。 - 点击 Apply Changes / Apply locally;出现 Save & Restart 时继续点击。
Model discovery 始终保持关闭。设置页的 Test connection 若单独显示 503 service_temporarily_unavailable,不要反复点击;真实 Code 请求仍然可用时,配置就是成功的。
在空白文件夹发一次真实 Code 请求
- 双击桌面的「启动 FengyuToken Claude Code」,选择 Local → Select folder。
- 按
Shift+Cmd+N新建空白文件夹FengyuToken-test,确认模型为claude-opus-5。 - 发送:“只回复 CONNECTED,不读取、创建或修改任何文件。”
- Claude 返回
CONNECTED,且本站调用用量出现同模型记录,才算完成。不要仅凭设置页的绿色提示宣称成功。
Opus 首次验证实测会先安全预留 $1.01 左右,完成后按实际 usage 扣费,多余预留自动退回。
不安装第三方客户端,不把 Key 写入 PowerShell,也不使用黑色终端版 Claude Code。
安装官方 Claude Desktop 和 Git
- 从 Claude 官方下载页安装最新版 Claude Desktop(Windows 10 build 19041+ / Windows 11,x64 或 Arm64),并打开一次。
- 从 Git for Windows 官方页安装 Git;安装后完全退出 Claude,再重新打开。
- 到本站API 密钥创建并复制自己的完整 Key;到充值页确认可用余额至少 $2。Key 只填入后面的 Gateway API key,不要填到 Claude 登录页、PowerShell 或聊天中。
打开 Third-Party Inference
- 打开 Claude Desktop;即使显示登录页,也不需要登录或创建 Anthropic 账号。
- 点击左上角菜单:Help → Troubleshooting → Enable Developer Mode。
- Claude 重启后打开:Developer → Configure Third-Party Inference…。
填写 Gateway 连接
按下列内容填写,其他选项保持默认:
- Inference provider
Gateway- Credential kind
Static API key- Gateway base URL
https://fengyutoken.com不要加/v1或/v1/messages- Gateway API key
- 粘贴自己的完整 FengyuToken Key
- Gateway auth scheme
Bearer- Custom inference headers
- 留空
先用一个模型验证
- 在 Model list / Models 中关闭 Model discovery,删除自动出现的模型。
- 首次只添加
claude-opus-5:Model ID / Name 填完整 ID;Display label / Display name 可填同一 ID;Tier mapping / Tier alias 选opus,并把它放在列表第一项(第一项即默认)。 - 点击 Apply locally / Apply Changes / Save & Restart(按钮名随版本可能不同);重启后选择 Continue with Gateway 或含义相同的第三方模式入口。
Test connection 单独出现 503 service_temporarily_unavailable 不足以判定配置失败:不要反复点击,也不要通过充值处理 503;保存并完全重启后,以下一步真实 Code 请求为准。
发送真实 Code 请求
- 进入 Claude Desktop → Code → Local → Select folder,选择一个空白文件夹
FengyuToken-test。 - 确认当前模型为
claude-opus-5,发送:“只回复 CONNECTED,不读取、创建或修改任何文件。” - Claude 返回
CONNECTED,且本站调用用量出现同模型的新记录,才算成功。真实请求若也返回 503,请稍后重试或换用当前已上架模型。
claude-fable-5claude-opus-5claude-opus-4-8claude-opus-4-7claude-opus-4-6claude-sonnet-5claude-sonnet-4-6claude-haiku-4-5已在第 4 步添加的模型不要重复添加。含 fable 的模型选 fable,含 opus 的选 opus,含 sonnet 的选 sonnet,含 haiku 的选 haiku。只添加此实时列表中的 Claude Messages 模型,不要添加 GPT / Codex 模型。全部添加完后再次点击 Apply locally / Apply Changes / Save & Restart,重启后继续使用 Gateway 模式。
可选:创建官方高清图标的桌面入口
打开 Windows PowerShell,复制下面整段并回车。它会从当前官方 Claude MSIX 中取出高清彩色图标,生成桌面「启动 FengyuToken Claude Code」,并通过官方 claude://code/new 深链打开 Code。脚本不保存或读取 Key。
展开高清图标快捷方式命令⌄
Add-Type -AssemblyName System.Drawing
$package = @(Get-AppxPackage -Name 'Claude' -ErrorAction SilentlyContinue) |
Where-Object { $_.Status -eq 'Ok' } |
Sort-Object -Property Version -Descending |
Select-Object -First 1
if (-not $package) { throw '未检测到官方 Claude Desktop,请先安装并打开一次。' }
$manifest = Get-AppxPackageManifest -Package $package.PackageFullName
$appNodes = @($manifest.SelectNodes("//*[local-name()='Applications']/*[local-name()='Application']"))
$appNode = $appNodes | Where-Object { $_.GetAttribute('Id') -eq 'Claude' } | Select-Object -First 1
if (-not $appNode) {
$appNode = $appNodes | Where-Object {
[IO.Path]::GetFileName(($_.GetAttribute('Executable')).Replace('/', '\')) -ieq 'Claude.exe'
} | Select-Object -First 1
}
if (-not $appNode) { throw '无法从 Claude AppxManifest.xml 定位主应用。' }
$visual = $appNode.SelectSingleNode("./*[local-name()='VisualElements']")
if (-not $visual) { throw 'Claude AppxManifest.xml 中没有 VisualElements。' }
$logicalAssets = @($visual.GetAttribute('Square44x44Logo'), $visual.GetAttribute('Square150x150Logo')) |
Where-Object { -not [string]::IsNullOrWhiteSpace($_) } | Select-Object -Unique
if (-not $logicalAssets) { throw '未找到 Claude 官方图标声明。' }
$candidatePaths = @{}
foreach ($logicalAsset in $logicalAssets) {
$relative = ([string]$logicalAsset).Replace('/', '\').TrimStart('\')
$relativeDir = [IO.Path]::GetDirectoryName($relative)
$stem = [IO.Path]::GetFileNameWithoutExtension([IO.Path]::GetFileName($relative))
$extension = [IO.Path]::GetExtension($relative)
$stem = $stem -replace '\.(scale|targetsize|contrast|altform)-.*$', ''
$assetDir = $package.InstallLocation
if (-not [string]::IsNullOrWhiteSpace($relativeDir)) { $assetDir = Join-Path $assetDir $relativeDir }
if (-not (Test-Path -LiteralPath $assetDir -PathType Container)) { continue }
$pattern = '^{0}(?:\..*)?{1}$' -f [regex]::Escape($stem), [regex]::Escape($extension)
Get-ChildItem -LiteralPath $assetDir -File -Recurse -ErrorAction SilentlyContinue |
Where-Object { $_.Name -imatch $pattern } |
ForEach-Object { $candidatePaths[$_.FullName] = $_.FullName }
}
if ($candidatePaths.Count -eq 0) { throw '未找到 Claude 官方 PNG 图标资产。' }
$assetInfo = @(foreach ($path in $candidatePaths.Values) {
$image = $null
try {
$image = [System.Drawing.Image]::FromFile($path)
[pscustomobject]@{
Path = $path; Name = [IO.Path]::GetFileName($path)
Width = $image.Width; Height = $image.Height
Pixels = [int64]$image.Width * [int64]$image.Height
Unplated = ([IO.Path]::GetFileName($path) -imatch 'altform-unplated')
Target256 = ([IO.Path]::GetFileName($path) -imatch 'targetsize-256')
}
} catch { } finally { if ($null -ne $image) { $image.Dispose() } }
})
if ($assetInfo.Count -eq 0) { throw 'Claude 官方 PNG 图标无法读取。' }
$source = $assetInfo | Where-Object { $_.Target256 -and $_.Unplated } |
Sort-Object Pixels -Descending | Select-Object -First 1
if (-not $source) { $source = $assetInfo | Where-Object { $_.Target256 } | Sort-Object Pixels -Descending | Select-Object -First 1 }
if (-not $source) { $source = $assetInfo | Where-Object { $_.Unplated -and $_.Width -ge 256 -and $_.Height -ge 256 } | Sort-Object Pixels -Descending | Select-Object -First 1 }
if (-not $source) { $source = $assetInfo | Sort-Object Pixels -Descending | Select-Object -First 1 }
$sourceImage = $null
$frames = @()
try {
$sourceImage = [System.Drawing.Image]::FromFile($source.Path)
foreach ($size in @(256, 128, 96, 64, 48, 32, 24, 16)) {
$bitmap = $null; $graphics = $null; $memory = $null
try {
$bitmap = [System.Drawing.Bitmap]::new($size, $size, [System.Drawing.Imaging.PixelFormat]::Format32bppArgb)
$graphics = [System.Drawing.Graphics]::FromImage($bitmap)
$graphics.Clear([System.Drawing.Color]::Transparent)
$graphics.CompositingMode = [System.Drawing.Drawing2D.CompositingMode]::SourceCopy
$graphics.CompositingQuality = [System.Drawing.Drawing2D.CompositingQuality]::HighQuality
$graphics.InterpolationMode = [System.Drawing.Drawing2D.InterpolationMode]::HighQualityBicubic
$graphics.SmoothingMode = [System.Drawing.Drawing2D.SmoothingMode]::HighQuality
$graphics.PixelOffsetMode = [System.Drawing.Drawing2D.PixelOffsetMode]::HighQuality
$ratio = [Math]::Min($size / [double]$sourceImage.Width, $size / [double]$sourceImage.Height)
$drawWidth = [Math]::Max(1, [int][Math]::Round($sourceImage.Width * $ratio))
$drawHeight = [Math]::Max(1, [int][Math]::Round($sourceImage.Height * $ratio))
$destination = [System.Drawing.Rectangle]::new([int](($size - $drawWidth) / 2), [int](($size - $drawHeight) / 2), $drawWidth, $drawHeight)
$graphics.DrawImage($sourceImage, $destination, 0, 0, $sourceImage.Width, $sourceImage.Height, [System.Drawing.GraphicsUnit]::Pixel)
$memory = [System.IO.MemoryStream]::new()
$bitmap.Save($memory, [System.Drawing.Imaging.ImageFormat]::Png)
$frames += [pscustomobject]@{ Size = $size; Bytes = $memory.ToArray() }
} finally {
if ($null -ne $memory) { $memory.Dispose() }
if ($null -ne $graphics) { $graphics.Dispose() }
if ($null -ne $bitmap) { $bitmap.Dispose() }
}
}
} finally { if ($null -ne $sourceImage) { $sourceImage.Dispose() } }
$iconDir = Join-Path $env:LOCALAPPDATA 'FengyuToken\ShortcutAssets'
$iconPath = Join-Path $iconDir 'Claude-Official-Color.ico'
New-Item -ItemType Directory -Path $iconDir -Force | Out-Null
$file = $null; $writer = $null
try {
$file = [System.IO.File]::Open($iconPath, [System.IO.FileMode]::Create, [System.IO.FileAccess]::Write, [System.IO.FileShare]::Read)
$writer = [System.IO.BinaryWriter]::new($file)
$writer.Write([uint16]0); $writer.Write([uint16]1); $writer.Write([uint16]$frames.Count)
$offset = [uint32](6 + (16 * $frames.Count))
foreach ($frame in $frames) {
$dimension = if ($frame.Size -eq 256) { [byte]0 } else { [byte]$frame.Size }
$writer.Write($dimension); $writer.Write($dimension); $writer.Write([byte]0); $writer.Write([byte]0)
$writer.Write([uint16]1); $writer.Write([uint16]32)
$writer.Write([uint32]$frame.Bytes.Length); $writer.Write([uint32]$offset)
$offset = [uint32]($offset + $frame.Bytes.Length)
}
foreach ($frame in $frames) { $writer.Write([byte[]]$frame.Bytes) }
} finally {
if ($null -ne $writer) { $writer.Dispose() } elseif ($null -ne $file) { $file.Dispose() }
}
$desktop = [Environment]::GetFolderPath('Desktop')
$linkPath = Join-Path $desktop '启动 FengyuToken Claude Code.lnk'
$wsh = New-Object -ComObject WScript.Shell
$link = $wsh.CreateShortcut($linkPath)
$link.TargetPath = Join-Path $env:WINDIR 'explorer.exe'
$link.Arguments = 'claude://code/new'
$link.WorkingDirectory = $env:USERPROFILE
$link.IconLocation = "$iconPath,0"
$link.Description = '启动 FengyuToken Claude Code'
$link.Save()
Start-Process (Join-Path $env:WINDIR 'System32\ie4uinit.exe') -ArgumentList '-show' -WindowStyle Hidden -ErrorAction SilentlyContinue
Write-Host '已创建桌面快捷方式:启动 FengyuToken Claude Code' -ForegroundColor Green再次提醒:这个入口不会保存 Key,也不会强制选择 FengyuToken。它只打开当前 Claude Desktop 模式的 Code 新会话。
在 Chatbox AI 中配置聊天
这条路线适合日常问答,不会改动 ChatGPT 桌面应用或 Codex 配置;第 1 步会只显示已选系统的安装说明。
gpt-5.6-terragpt-5.6-solgpt-5.6-lunagpt-5.5gpt-5.4gpt-5.4-minigpt-5.3-codex-spark按当前系统下载并打开 Chatbox AI
先打开 Chatbox AI 官方下载页,顶部系统切换会只显示与你电脑匹配的安装说明。
macOS
Windows
Linux
如果欢迎页显示 Skip guide / 跳过引导,点击后进入主界面;若当前版本要求 Chatbox 登录,按页面提示完成。这一步只是进入 Chatbox,不是输入本站 Key。
新建一个 API 提供方
- 在 Chatbox 主界面点击左下角 Settings / 设置。
- 点击 AI Provider / Model Provider / Model Settings(不同版本名称可能略有不同)。
- 在提供方列表底部点击 Add / Add Provider / 添加,类型选择 OpenAI API Compatible。
逐项填写,不要把 Host 和 Path 混在一起
FengyuTokenOpenAI API Compatiblehttps://fengyutoken.com(这里不加 /v1)/v1/chat/completions;如果已是这个默认值,保持不变最终请求地址应当只包含一次 /v1/chat/completions。如果填成 .../v1/v1/chat/completions,请将 API Host 末尾的 /v1 删除。
添加模型并检查连接
- 点击 Add Model / 添加模型,Model ID 完整填写
gpt-5.6-terra。模型类型选 Chat;首次只测文字时,能力选项可先不勾选。 - 需要多个模型时,继续点击 Add Model,从本节“开始前”列表逐个复制其他 Chat 模型 ID;不要添加 Responses 或 Messages 模型。
- 只有页面显示服务已就绪时,才点击 Save / 保存,再点击 Check / 检查。看到 Connection successful / 连接成功 后返回主界面。
新建对话并验证扣费记录
- 点击 New Chat / 新对话。
- 点击输入框旁的模型选择器,依次选择 FengyuToken → gpt-5.6-terra。
- 输入“只回复 CONNECTED”并发送。收到回复后,打开本站调用用量,确认有一条模型 ID 为
gpt-5.6-terra的新记录。
CONNECTED,本站调用用量同时出现一条新记录。切换模型、切回原服务或完全移除
- 切换已添加的模型:在聊天页点击输入框旁的模型选择器,选择 FengyuToken 下的另一个模型。
- 模型没出现:点击 Settings → Model Provider → FengyuToken → Add Model,粘贴另一个 Chat 模型 ID,保存后再回聊天页选择。
- 切回你原来的服务:在模型选择器中选择原提供方和原模型。
- 完全移除本站配置:打开 Settings → Model Provider → FengyuToken,点击 Disable / 停用 或 Delete / 删除。这不会改动官方 ChatGPT 桌面端,也不会删除 Chatbox 里的其他提供方。
在 VS Code 终端使用 Codex CLI
本站使用单独的 fengyu 配置,不覆盖原来的 Codex 账号文件。CLI 的 --profile fengyu 不会自动应用到桌面 App;桌面 App 请使用本页路线 A 的独立 CODEX_HOME 方式。
gpt-5.6-terragpt-5.6-solgpt-5.6-lunagpt-5.5gpt-5.4gpt-5.4-minigpt-5.3-codex-spark打开项目和终端
打开 VS Code,点击 File / 文件 → Open Folder / 打开文件夹选择项目,再点击 Terminal / 终端 → New Terminal / 新建终端。
安装 Codex CLI
只运行与你系统对应的一组命令。安装完成后关闭终端,再新建终端。
macOS / Linux
curl -fsSL https://chatgpt.com/codex/install.sh | sh
codex --versionWindows PowerShell
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
codex --version新建本站专用配置文件
先运行与你系统一致的“打开配置文件”命令。文件打开后,把下面“配置内容”完整粘贴进去并保存。不要覆盖 ~/.codex/config.toml,不要删除 auth.json。
macOS / Linux:打开文件
mkdir -p ~/.codex
nano ~/.codex/fengyu.config.toml粘贴后按 Ctrl+O、回车保存,再按 Ctrl+X 退出。
Windows PowerShell:打开文件
New-Item -ItemType Directory -Force "$HOME\.codex" | Out-Null
notepad "$HOME\.codex\fengyu.config.toml"记事本打开后粘贴配置,按 Ctrl+S 保存并关闭。
配置内容
model = "gpt-5.6-terra"
model_provider = "fengyu"
[model_providers.fengyu]
name = "FengyuToken"
base_url = "https://fengyutoken.com/v1"
env_key = "FENGYU_API_KEY"
wire_api = "responses"
requires_openai_auth = false在当前终端隐藏输入 Key
macOS / Linux
printf "API Key(输入不会显示): "
read -r -s FENGYU_API_KEY
export FENGYU_API_KEY
printf "\n"Windows PowerShell
$secureKey = Read-Host "API Key(输入不会显示)" -AsSecureString
$env:FENGYU_API_KEY = [System.Net.NetworkCredential]::new("", $secureKey).Password启动并验证
codex --profile fengyu -m "gpt-5.6-terra"进入后输入 /status,确认模型 ID;再输入“只回复 CONNECTED”。最后到调用用量核对新记录。
切换模型或切回原账号
切模型:在 Codex 中按 Ctrl+C 退回终端,然后从下列完整命令中选一条运行:
codex --profile fengyu -m "gpt-5.6-terra"codex --profile fengyu -m "gpt-5.6-sol"codex --profile fengyu -m "gpt-5.6-luna"codex --profile fengyu -m "gpt-5.5"codex --profile fengyu -m "gpt-5.4"codex --profile fengyu -m "gpt-5.4-mini"codex --profile fengyu -m "gpt-5.3-codex-spark"切回原账号:点击终端工具栏的垃圾桶,再点击 Terminal / 终端 → New Terminal / 新建终端,然后直接运行 codex。如果不关闭终端,执行与你系统对应的命令:
macOS / Linux
unset FENGYU_API_KEY
codexWindows PowerShell
Remove-Item Env:FENGYU_API_KEY -ErrorAction SilentlyContinue
codex切回命令没有 --profile fengyu,因此会读取你原来的 Codex 配置;本站的独立配置文件仍保留,之后需要时可再次使用。
让本机助手代为配置时的安全清单⌄
请只配置 Codex CLI 的独立 fengyu profile:只新建 ~/.codex/fengyu.config.toml,不修改 ~/.codex/config.toml、auth.json 或原账号登录。Base URL 使用 https://fengyutoken.com/v1,模型使用 gpt-5.6-terra,Key 仅由我在本机隐藏输入到 FENGYU_API_KEY。启动时必须显式使用 codex --profile fengyu -m "gpt-5.6-terra",并告诉我直接运行 codex 即可切回原账号。在 PyCharm / JetBrains 终端使用 Codex CLI
本节从安装开始,所有操作都在 PyCharm 自带终端中完成,不需要先阅读 VS Code 教程。本站配置单独保存在 fengyu.config.toml,不会覆盖原来的 Codex 账号。
打开项目和内置终端
打开 PyCharm,点击 File → Open 选择项目,再点击 View → Tool Windows → Terminal(快捷键 Alt+F12)。后面的命令都输入在底部终端中。
安装 Codex CLI
展开与你电脑系统一致的卡片,复制整段命令并运行。看到版本号后,点击终端工具栏的垃圾桶关闭终端,再按 Alt+F12 新建终端。
macOS / Linux
curl -fsSL https://chatgpt.com/codex/install.sh | sh
codex --versionWindows PowerShell
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
codex --version创建独立配置文件
先运行与你系统一致的“打开配置文件”命令;文件打开后,把下面“配置内容”完整粘贴进去并保存。不要编辑 ~/.codex/config.toml,也不要删除 auth.json。
macOS / Linux:打开文件
mkdir -p ~/.codex
nano ~/.codex/fengyu.config.toml粘贴后按 Ctrl+O、回车保存,再按 Ctrl+X 退出。
Windows PowerShell:打开文件
New-Item -ItemType Directory -Force "$HOME\.codex" | Out-Null
notepad "$HOME\.codex\fengyu.config.toml"记事本打开后粘贴配置,按 Ctrl+S 保存并关闭。
配置内容
model = "gpt-5.6-terra"
model_provider = "fengyu"
[model_providers.fengyu]
name = "FengyuToken"
base_url = "https://fengyutoken.com/v1"
env_key = "FENGYU_API_KEY"
wire_api = "responses"
requires_openai_auth = false在当前终端隐藏输入 API Key
运行与你系统一致的整段命令。终端提示输入时,粘贴完整 Key 并按回车;屏幕不会显示输入内容。
macOS / Linux
printf "API Key(输入不会显示): "
read -r -s FENGYU_API_KEY
export FENGYU_API_KEY
printf "\n"Windows PowerShell
$secureKey = Read-Host "API Key(输入不会显示)" -AsSecureString
$env:FENGYU_API_KEY = [System.Net.NetworkCredential]::new("", $secureKey).Password启动并验证
codex --profile fengyu -m "gpt-5.6-terra"Codex 打开后输入 /status 并回车,确认模型是 gpt-5.6-terra;再输入“只回复 CONNECTED”。收到回复后,到本站调用用量确认出现同一模型。
切换模型或切回原账号
切模型:在 Codex 中按 Ctrl+C 退回 PyCharm 底部终端,然后从下列完整命令中选一条运行:
codex --profile fengyu -m "gpt-5.6-terra"codex --profile fengyu -m "gpt-5.6-sol"codex --profile fengyu -m "gpt-5.6-luna"codex --profile fengyu -m "gpt-5.5"codex --profile fengyu -m "gpt-5.4"codex --profile fengyu -m "gpt-5.4-mini"codex --profile fengyu -m "gpt-5.3-codex-spark"切回原账号:点击终端工具栏的垃圾桶,按 Alt+F12 新建终端,然后直接运行 codex。如果不关闭终端,执行:
macOS / Linux
unset FENGYU_API_KEY
codexWindows PowerShell
Remove-Item Env:FENGYU_API_KEY -ErrorAction SilentlyContinue
codex在 VS Code 使用 Claude Code
Claude Code 使用 /v1/messages,只选择价格页中带 Messages 标签的 Claude 模型;不转换为 OpenAI Responses,也不要填写 GPT 模型 ID。
打开API 密钥创建并保存一枚完整 Key;到充值页确认余额足够。
claude-fable-5claude-opus-5claude-opus-4-8claude-opus-4-7claude-opus-4-6claude-sonnet-5claude-sonnet-4-6claude-haiku-4-5列表完全来自当前已上架的 Messages 模型;稳妥默认使用最新 Sonnet,Opus 与 Haiku 保持各自的模型 ID,不会互相映射。
安装 VS Code 和 Claude Code
- 打开 VS Code,点击 Help / 帮助 → About / 关于,确认版本为 1.98 或更高。版本过低时,打开 VS Code 官方下载页 更新。
- 点击左侧 Extensions / 扩展,或按 macOS
Cmd+Shift+X、Windows/LinuxCtrl+Shift+X。 - 搜索 Claude Code,确认发布者为 Anthropic,点击 Install / 安装。
打开项目和终端,再安装 CLI
点击 File / 文件 → Open Folder / 打开文件夹,再点击 Terminal / 终端 → New Terminal / 新建终端。扩展的图形面板自带运行组件,但在终端输入 claude 仍需要单独安装 CLI。
macOS / Linux
curl -fsSL https://claude.ai/install.sh | bash
claude --versionWindows PowerShell
irm https://claude.ai/install.ps1 | iex
claude --version在当前终端输入本站配置
关闭这个终端后配置就会消失,不会删除或覆盖你原有的 Claude 官方登录。地址只填站点根地址,不加 /v1。
macOS zsh
read -s "FENGYU_KEY?API Key(输入不会显示): "; echo
export ANTHROPIC_BASE_URL="https://fengyutoken.com"
export ANTHROPIC_AUTH_TOKEN="$FENGYU_KEY"
export CLAUDE_CODE_USE_GATEWAY=1
export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-5"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-4-5"
export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-5"
export ANTHROPIC_MODEL="claude-sonnet-5"
unset FENGYU_KEYLinux Bash
read -rsp "API Key(输入不会显示): " FENGYU_KEY; echo
export ANTHROPIC_BASE_URL="https://fengyutoken.com"
export ANTHROPIC_AUTH_TOKEN="$FENGYU_KEY"
export CLAUDE_CODE_USE_GATEWAY=1
export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-5"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-4-5"
export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-5"
export ANTHROPIC_MODEL="claude-sonnet-5"
unset FENGYU_KEYWindows PowerShell
$secureKey = Read-Host "API Key(输入不会显示)" -AsSecureString
$env:ANTHROPIC_AUTH_TOKEN = [System.Net.NetworkCredential]::new("", $secureKey).Password
$env:ANTHROPIC_BASE_URL = "https://fengyutoken.com"
$env:CLAUDE_CODE_USE_GATEWAY = "1"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL = "claude-sonnet-5"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL = "claude-haiku-4-5"
$env:ANTHROPIC_DEFAULT_OPUS_MODEL = "claude-opus-5"
$env:ANTHROPIC_MODEL = "claude-sonnet-5"
默认使用当前最新的 Sonnet;选择 Haiku 或 Opus 时使用各自的完整模型 ID,所有请求都是原生 Claude Messages。
启动、检查地址并选择模型
先在 VS Code 终端运行:
claude- Claude Code 打开后输入
/status并回车,确认 Base URL 是https://fengyutoken.com。 - 输入
/model并回车,选择本场景“当前可用的 Claude Code 模型”框中的模型;右下角模型按钮也会打开相同菜单。 - 部分版本会在模型名称旁显示 Cloud gateway,这是正常现象。
验证读取工具
- 在资源管理器新建
fengyu-claude-test.txt。 - 第一行输入
FengyuToken Claude Code test并保存,不要放密码或隐私内容。 - 在 Claude Code 输入:“请只读取 fengyu-claude-test.txt,告诉我第一行,不要修改文件。”
- 确认返回正确内容,再到调用用量核对模型与扣费。
切换模型或切回原账号
切模型:在 Claude Code 内输入 /model 并回车,或点击右下角模型按钮;只选择本节“当前可用的 Claude Code 模型”列表中的 ID。切回原账号:推荐点击终端垃圾桶关闭当前终端,再新建终端并运行 claude。若不关闭终端,可执行与你系统对应的整段命令:
macOS / Linux
unset ANTHROPIC_BASE_URL ANTHROPIC_AUTH_TOKEN ANTHROPIC_MODEL ANTHROPIC_DEFAULT_SONNET_MODEL ANTHROPIC_DEFAULT_OPUS_MODEL ANTHROPIC_DEFAULT_HAIKU_MODEL CLAUDE_CODE_USE_GATEWAY CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY
claudeWindows PowerShell
Remove-Item Env:ANTHROPIC_BASE_URL, Env:ANTHROPIC_AUTH_TOKEN, Env:ANTHROPIC_MODEL, Env:ANTHROPIC_DEFAULT_SONNET_MODEL, Env:ANTHROPIC_DEFAULT_OPUS_MODEL, Env:ANTHROPIC_DEFAULT_HAIKU_MODEL, Env:CLAUDE_CODE_USE_GATEWAY, Env:CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY -ErrorAction SilentlyContinue
claude如果电脑原来没有登录 Claude,切回后会出现官方登录提示;这属于正常情况。
可选:让 VS Code 右下角图形面板使用本站⌄
- 按
Cmd+Shift+P或Ctrl+Shift+P,选择 Preferences: Open User Settings (JSON)打开 VS Code 的settings.json。 - 把下面的
claudeCode.environmentVariables合并进现有 JSON 顶层;如果前一个设置项末尾没有逗号,先补一个英文逗号。不要删除或覆盖其他设置。 - 按
Cmd+S(macOS)或Ctrl+S(Windows/Linux)保存;打开 Settings → Extensions → Claude Code,勾选 Disable Login Prompt。 - 按
Cmd+Shift+P或Ctrl+Shift+P,运行 Developer: Reload Window,点击右下角 ✱ Claude Code。在面板输入/model切换模型。
{
"claudeCode.environmentVariables": [
{ "name": "ANTHROPIC_BASE_URL", "value": "https://fengyutoken.com" },
{ "name": "ANTHROPIC_AUTH_TOKEN", "value": "sk-替换为自己的完整Key" },
{ "name": "CLAUDE_CODE_USE_GATEWAY", "value": "1" },
{ "name": "ANTHROPIC_DEFAULT_SONNET_MODEL", "value": "claude-sonnet-5" },
{ "name": "ANTHROPIC_DEFAULT_OPUS_MODEL", "value": "claude-opus-5" },
{ "name": "ANTHROPIC_DEFAULT_HAIKU_MODEL", "value": "claude-haiku-4-5" },
{ "name": "ANTHROPIC_MODEL", "value": "claude-sonnet-5" }
]
}切回时删除 claudeCode.environmentVariables,取消 Disable Login Prompt,再运行 Developer: Reload Window。
在 PyCharm / JetBrains 使用 Claude Code
本节包含插件、CLI、环境变量和切回命令,可以单独完成。JetBrains 插件负责显示差异、选中代码和诊断信息;Claude Code 本身从 PyCharm 内置终端启动。
打开API 密钥创建并保存一枚完整 Key;到充值页确认余额足够。
claude-fable-5claude-opus-5claude-opus-4-8claude-opus-4-7claude-opus-4-6claude-sonnet-5claude-sonnet-4-6claude-haiku-4-5配置中的默认模型是 claude-sonnet-5;切换时只选本列表中的模型。
安装插件并重启 IDE
打开 Settings / Preferences → Plugins → Marketplace,搜索 Claude Code,点击 Install,然后完整退出并重新打开 PyCharm。
打开项目终端并安装 CLI
点击 View → Tool Windows → Terminal(快捷键 Alt+F12)。展开与你电脑系统一致的卡片,复制整段命令并运行;看到版本号后,完整退出并重新打开 PyCharm。
macOS / Linux
curl -fsSL https://claude.ai/install.sh | bash
claude --versionWindows PowerShell
irm https://claude.ai/install.ps1 | iex
claude --version在当前终端输入完整配置
重新打开底部终端,运行与你系统一致的整段命令。出现输入提示后粘贴完整 API Key 并回车;输入内容不会显示。这里的地址必须是站点根地址 https://fengyutoken.com,末尾不要加 /v1。
macOS zsh
read -s "FENGYU_KEY?API Key(输入不会显示): "; echo
export ANTHROPIC_BASE_URL="https://fengyutoken.com"
export ANTHROPIC_AUTH_TOKEN="$FENGYU_KEY"
export CLAUDE_CODE_USE_GATEWAY=1
export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-5"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-4-5"
export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-5"
export ANTHROPIC_MODEL="claude-sonnet-5"
unset FENGYU_KEYLinux Bash
read -rsp "API Key(输入不会显示): " FENGYU_KEY; echo
export ANTHROPIC_BASE_URL="https://fengyutoken.com"
export ANTHROPIC_AUTH_TOKEN="$FENGYU_KEY"
export CLAUDE_CODE_USE_GATEWAY=1
export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-5"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-4-5"
export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-5"
export ANTHROPIC_MODEL="claude-sonnet-5"
unset FENGYU_KEYWindows PowerShell
$secureKey = Read-Host "API Key(输入不会显示)" -AsSecureString
$env:ANTHROPIC_AUTH_TOKEN = [System.Net.NetworkCredential]::new("", $secureKey).Password
$env:ANTHROPIC_BASE_URL = "https://fengyutoken.com"
$env:CLAUDE_CODE_USE_GATEWAY = "1"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL = "claude-sonnet-5"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL = "claude-haiku-4-5"
$env:ANTHROPIC_DEFAULT_OPUS_MODEL = "claude-opus-5"
$env:ANTHROPIC_MODEL = "claude-sonnet-5"
默认使用当前最新的 Sonnet;选择 Haiku 或 Opus 时使用各自的完整模型 ID,所有请求都是原生 Claude Messages。
启动并检查连接
claudeClaude Code 打开后,先输入 /status 并回车,确认 Base URL 是 https://fengyutoken.com;再输入 /model,选择本节列表中的 Claude 模型。插件通常会自动连接当前 PyCharm。
验证 IDE 读取能力
在编辑器中新建 fengyu-claude-test.txt,第一行输入 FengyuToken PyCharm test 并保存。回到 Claude Code 输入:“请只读取 fengyu-claude-test.txt,告诉我第一行,不要修改文件。”确认返回内容与文件第一行逐字一致,并在本站调用用量看到新记录,即完成接入。
切换模型或切回原账号
切模型:在 Claude Code 输入 /model,选择本节模型列表中的另一个 ID。切回原账号:推荐点击 PyCharm 终端垃圾桶,重新打开终端并直接运行 claude。若不关闭终端,可执行:
macOS / Linux
unset ANTHROPIC_BASE_URL ANTHROPIC_AUTH_TOKEN ANTHROPIC_MODEL ANTHROPIC_DEFAULT_SONNET_MODEL ANTHROPIC_DEFAULT_OPUS_MODEL ANTHROPIC_DEFAULT_HAIKU_MODEL CLAUDE_CODE_USE_GATEWAY CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY
claudeWindows PowerShell
Remove-Item Env:ANTHROPIC_BASE_URL, Env:ANTHROPIC_AUTH_TOKEN, Env:ANTHROPIC_MODEL, Env:ANTHROPIC_DEFAULT_SONNET_MODEL, Env:ANTHROPIC_DEFAULT_OPUS_MODEL, Env:ANTHROPIC_DEFAULT_HAIKU_MODEL, Env:CLAUDE_CODE_USE_GATEWAY, Env:CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY -ErrorAction SilentlyContinue
claude临时配置只作用于当前终端;关闭终端会清除 Key,不会删除原来的 Claude 登录。
在 PyCharm 用 Python 调用 GPT
本节从创建项目开始,完整提供安装、Key、代码、运行、切模型和清理命令,不依赖其他章节。
gpt-5.6-terragpt-5.6-solgpt-5.6-lunagpt-5.5gpt-5.4gpt-5.4-minigpt-5.3-codex-spark创建项目并打开终端
点击 File → New Project → Pure Python,项目位置可保持默认,勾选创建新的 .venv 虚拟环境,再点击 Create。项目打开后,点击 View → Tool Windows → Terminal。如果终端提示符开头出现 (.venv),说明 PyCharm 已自动激活虚拟环境。
激活虚拟环境并安装 Python SDK
如果终端已显示 (.venv),只运行第一张卡片的命令。如果没有显示,运行与系统对应的完整命令。
已显示 (.venv)
python -m pip install --upgrade pip openaimacOS / Linux:尚未激活
python3 -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip openaiWindows PowerShell:尚未激活
py -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install --upgrade pip openai如果 PowerShell 提示禁止运行脚本,先运行 Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass,再重新运行 .\.venv\Scripts\Activate.ps1。该政策只对当前终端生效。
在当前终端隐藏输入 API Key
运行与你系统一致的整段命令。提示输入时粘贴完整 Key 并回车;屏幕不会显示输入内容,Key 只在当前终端生效。
macOS zsh
read -s "FENGYU_API_KEY?API Key(输入不会显示): "; echo
export FENGYU_API_KEYLinux Bash
read -rsp "API Key(输入不会显示): " FENGYU_API_KEY; echo
export FENGYU_API_KEYWindows PowerShell
$secureKey = Read-Host "API Key(输入不会显示)" -AsSecureString
$env:FENGYU_API_KEY = [System.Net.NetworkCredential]::new("", $secureKey).Password新建文件并粘贴代码
在左侧项目目录右键,选择 New → Python File,命名为 fengyu_gpt_test.py,粘贴:
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["FENGYU_API_KEY"],
base_url="https://fengyutoken.com/v1",
)
response = client.chat.completions.create(
model="gpt-5.6-terra",
messages=[{"role": "user", "content": "只回复 CONNECTED"}],
)
print(response.choices[0].message.content)运行并验证
按 Cmd+S(macOS)或 Ctrl+S(Windows/Linux)保存文件,然后在底部终端运行:
python fengyu_gpt_test.py看到 CONNECTED 后,打开本站调用用量,核对模型 ID 和 tokens。
切换模型或清理测试配置
切模型:在 fengyu_gpt_test.py 中找到 model="gpt-5.6-terra",从本场景开头的 Chat 模型列表中复制另一个完整 ID,替换引号里的值。按 Cmd+S(macOS)或 Ctrl+S(Windows/Linux)保存,再在终端运行 python fengyu_gpt_test.py。清理:关闭当前终端即可清除临时 Key;如果不关闭终端,执行与系统对应的命令:
macOS / Linux
unset FENGYU_API_KEY
deactivateWindows PowerShell
Remove-Item Env:FENGYU_API_KEY -ErrorAction SilentlyContinue
deactivate最后可在项目树右键删除 fengyu_gpt_test.py;这些操作不会改变 PyCharm 的其他项目。
按报错代码快速处理
先停止重复请求,再按下面一行排查。不要通过关闭证书校验或改回 HTTP 来绕过错误。
| 看到什么 | 通常表示 | 怎么处理 |
|---|---|---|
| 400 | 模型 ID、标签或请求格式不匹配 | 回价格页重新复制,并确认场景要求 Chat、Responses 还是 Messages |
| 401 | Key 缺失、粘贴错误、已停用或已撤销 | 确认 Key 来自本站且仍启用;泄露时撤销并创建新 Key |
| 402 | Key 已被识别,但余额不足以完成请求前的安全预留;这不是模型故障 | 先充值再重试。当前 Opus 桌面验证实测通常先预留约 $1.01,建议可用余额至少 $2;完成后只扣实际 usage,多余预留会释放 |
| 404 | 地址路径写错 | GPT 地址检查是否重复成 /v1/v1;Claude 地址检查是否误加 /v1 |
| 429 | 短时间请求过多 | 降低并发,稍后重试一次 |
| 503 | 设置页的简化探测未通过,或真实请求使用的模型此刻暂不可用;与余额不足的 402 不同 | Test connection 单独出现 503 时,保存并重启后按 Claude 桌面端的「真实 Code 请求」步骤验证;真实请求也出现 503 时,记录时间和模型 ID,稍后重试或联系管理员 |
ADVANCED高级:接口地址速查
⌄
高级:接口地址速查
GET /v1/models查看已上架模型 ID;具体使用场景仍以价格页标签为准。
POST /v1/chat/completionsGPT 聊天客户端和本页 Python GPT 示例。
POST /v1/responsesCodex 图形客户端和 Codex CLI 使用的 Responses 接口。
POST /v1/messagesClaude Code 使用的 Messages 接口。
最后检查一次密钥安全
- 完整 Key 只保存在自己设备不要发给客服、AI 对话、群聊或截图。
- 一个用途一枚 Key客户端和项目分开创建,出现异常时只停用对应 Key。
- 不要写进代码仓库Python 从环境变量读取 Key,不要提交到 Git。
- 发现异常立即撤销在密钥页永久撤销旧 Key,再创建新 Key。