FengyuToken
菜单
GET STARTED

接入指南

不需要先理解接口术语。ChatGPT 风格的图形聊天客户端、Visual Studio Code(简称 VS Code,不是 Visual Studio)和 PyCharm 都有独立步骤;找到你正在使用的软件,只看对应的一节,照着“打开或点击 → 输入 → 验证 → 切换模型 → 切回原配置”完成即可。

连接地址已使用 HTTPS 输入 API Key 前,仍请确认浏览器地址栏没有证书警告。完整 Key 只在自己的设备上输入,不要发到聊天、邮件或截图中。
选择教程
接入指南 / 开始使用
文档首页
先选择你的电脑系统,教程会自动切换
第 1 步:选系统仅显示对应系统的安装步骤
CHOOSE A SCENE

你想在哪个软件里使用?

选择最接近的一项。每个场景都是独立教程,不必从头读完整页。

BEFORE YOU START

所有场景都先准备这 3 样东西

1

一枚已经保存好的 API Key

登录后打开API 密钥,点击“创建密钥”,按用途命名,例如“我的 MacBook”。完整 Key 只显示一次,请立即保存在密码管理器中。还没有账号时,请先注册并验证邮箱

2

足够完成测试的余额

先在充值页完成充值,再用一句短消息测试。请求结束后可到调用用量核对模型、tokens 和扣费。

3

与软件匹配的模型 ID

价格页复制完整模型 ID。聊天客户端和 Python GPT 示例选择 Chat;Codex 选择 Responses;Claude Code 选择 Messages

Chat 模型
gpt-5.6-terragpt-5.6-solgpt-5.6-lunagpt-5.5gpt-5.4gpt-5.4-minigpt-5.3-codex-spark
Codex(桌面端 / CLI)模型
gpt-5.6-terragpt-5.6-solgpt-5.6-lunagpt-5.5gpt-5.4gpt-5.4-minigpt-5.3-codex-spark
Claude Code 模型
claude-fable-5claude-opus-5claude-opus-4-8claude-opus-4-7claude-opus-4-6claude-sonnet-5claude-sonnet-4-6claude-haiku-4-5
GRAPHICAL CLIENT CENTER

图形客户端:先选产品,再选系统

这里只分三条路线。先按用途选产品,再点击下方醒目的系统按钮;之后页面只保留你当前系统需要看的步骤。

先选你的电脑系统
当前为 macOS。下面及后续教程会自动只显示该系统的步骤。
第 1 步:选系统选完再进入产品教程
普通 ChatGPT 聊天不能填写本站 API Key。ChatGPT 桌面应用里只有独立启动的 Codex 模式使用本站 Responses 模型;普通聊天仍使用你的 OpenAI 账号。不要把本站 Key 填进 OpenAI 登录页,也不要把本站 Key 填到“Sign in with API key”。
需要改代码和文件选 ChatGPT / Codex 或 Claude Desktop Code。
只需要聊天问答选 Chatbox,不要配置普通 ChatGPT。
Linux 图形桌面当前图形聊天选 Chatbox;Codex / Claude 图形教程仅支持 macOS 和 Windows。
GRAPHICAL CLIENT · CODEX

在 ChatGPT 桌面应用中配置 Codex

这不是普通 Chat 对话。请使用页面顶部的系统选择;此处只显示你当前系统需要执行的 Codex 图形配置步骤。

本场景开始前:打开API 密钥创建并保存一枚完整 Key;到充值页确认余额足够;只能选择下面带 Responses 协议的模型。
gpt-5.6-terragpt-5.6-solgpt-5.6-lunagpt-5.5gpt-5.4gpt-5.4-minigpt-5.3-codex-spark
macOS · 图形桌面入口
1

每个人创建自己的 Key

管理员只需要发这一份通用教程,不需要发送或代填 API Key。用户登录自己的账号,在API 密钥页创建 Key 并暂时保存。安装程序稍后会在用户自己的 Mac 上弹出隐藏输入框。

2

只运行一次通用安装程序

本安装器只适用于 macOS 上的当前版 ChatGPT 桌面应用。第一次使用新电脑时,请先从原图标打开 ChatGPT,按页面提示完成一次账号登录;进入应用后再继续。请只保留“应用程序”文件夹里的一份 ChatGPT.app;如果桌面还有一份,请手动移走后再配置。首次配置时,macOS 还可能询问终端访问桌面、钥匙串或控制 ChatGPT 的权限,请选择允许。

  1. Cmd+Q 完全退出 ChatGPT。
  2. 打开 Terminal / 终端,复制下面整段命令并回车。
  3. 出现“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 登录,也不会处理其他目录的组件。

以后更新:已启用新版更新器后,直接打开桌面的「启动 FengyuToken Codex」即可在后台检查并安全更新。旧版用户只需执行一次下面的“启用一键更新”命令;不会再次要求输入 Key。
旧版 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"
3

双击桌面的「启动 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 登录,这不代表配置失败。请以左下角服务名、右下角模型和本站用量记录为准。

4

切换模型或推理强度;官方账号仍用原图标

切换模型:用右下角的模型按钮切换另一个 Responses 模型;在同一处的 Reasoning / 推理强度 选择 LowMediumHigh。Low 更快,High 推理更深入且通常更慢。此前已配置但看不到该选项:先按 Cmd+Q 退出,再执行上方“旧版 macOS:启用一键更新”命令一次,然后从桌面入口重新打开;不会再次要求输入 Key。打开官方 Codex:先按 Cmd+Q 完全退出 FengyuToken Codex,再双击原来的 ChatGPT / Codex 图标。原图标不会携带独立 CODEX_HOME,因此会使用原官方配置。

Windows 10 / 11 · 图形一键版

Windows:生成「启动 FengyuToken Codex」图形客户端入口

请先安装新版 ChatGPT 图形应用这一版会直接打开 Microsoft Store 的 OpenAI 官方 ChatGPT/Codex 图形应用,不再打开 PowerShell 或 Codex CLI。本站 Key 只填在安装器弹窗,不要填到 OpenAI 登录页。
1

安装并退出 ChatGPT 图形应用;再打开 PowerShell

  1. 先从 Microsoft Store 安装最新版 ChatGPT。未安装时,可在 PowerShell 运行 winget install --id 9PLM9XGG6VKS -s msstore
  2. 安装后打开 ChatGPT 一次,再完全退出应用。
  3. 在开始菜单搜索并打开 Windows PowerShell;不要用 CMD。
  4. 用户在API 密钥页创建并保存完整 Key。
2

复制这一行,一键安装

只复制下面这一整行到 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
3

在弹窗中粘贴这位用户自己的 Key

请先在密钥页点“领取并复制”,确认显示“已复制完整 Key”,然后立即粘贴到弹窗。Key 不显示、不写入 TOML,Windows 会用当前账号的 DPAPI 加密保存。本站配置只写入 %USERPROFILE%\.codex-fengyu;不会覆盖官方 %USERPROFILE%\.codex

4

先验证原官方图标,再启动本站模式

安装完成后不会自动启动 ChatGPT。先点击安装前就存在的官方 ChatGPT/Codex 图标,确认原官方账号仍能正常打开;然后从应用菜单完全退出,任务管理器中确认没有 ChatGPT.exe,再双击桌面「启动 FengyuToken Codex」。点左上角产品名称进入 Codex 并创建任务;普通 Chat / Work 不会使用本站 Key。默认模型由安装器从当前可用列表自动选择;右下角既可切换 Responses 模型,也可在 Reasoning / 推理强度 选择 LowMediumHigh。Low 更快,High 推理更深入且通常更慢。此前已配置但看不到该选项:从应用菜单完全退出后,先执行下方一次“启用一键更新”命令;以后打开桌面入口会自动检查更新,无需重新输入 Key。输入“只回复 CONNECTED”,并在调用用量看到新记录,才算配置完成。

成功标准:原官方图标先验证正常;完全退出后,本站入口打开白色 ChatGPT/Codex 图形界面,请求得到回复,且本站出现新的调用记录。
旧版 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 与官方快捷方式均不会改动。

5

三个入口的用途与单实例限制

  • 使用本站:双击桌面新生成的「启动 FengyuToken Codex」,它只给本次启动设置独立的 CODEX_HOME=%USERPROFILE%\.codex-fengyu
  • 使用官方账号:先完全退出 ChatGPT,再点击原来的官方 ChatGPT/Codex 图标;它仍使用原官方账号和配置。
  • 保险入口:安装器还会额外生成「切回 OpenAI 官方 Codex」,在完全退出后可用它明确按官方 %USERPROFILE%\.codex 启动;它不会替换原官方图标。
  • 换模型或 Key:模型只选已上架的 Responses 模型;更换 Key 时重新执行第 2 步。
Windows 不能同时运行两个模式:ChatGPT/Codex 是单实例应用。若另一个模式仍在后台,点击任何图标都只会唤醒旧进程,看起来就像快捷方式被覆盖。切换前必须从应用菜单完全退出;新版安装器不会自动启动或关闭 ChatGPT,并会校验已有快捷方式及官方配置在安装前后没有变化。
GRAPHICAL CLIENT · CLAUDE DESKTOP

在 Claude Desktop 中配置 Code

在官方 Claude Desktop 的 Code 图形界面中使用 FengyuToken。页面顶部已选定系统后,这里只显示相应教程;Windows 不需要另外安装 Claude Code CLI。

macOS:一键安装 + 图形 Code

使用独立配置和钥匙串,不覆盖原有 Claude 登录,也不会修改 ~/.claude

1

准备 Claude、余额和 Key

  1. Claude 官方下载页安装最新版 Claude,将 Claude.app 放进「应用程序」,并至少打开一次。
  2. 到本站API 密钥创建并保存自己的完整 Key;到充值页确认可用余额至少为 $2
  3. 打开 Terminal / 终端,运行:
curl -fsSL https://claude.ai/install.sh | bash
claude --version
2

运行一次一键安装

复制整段命令到终端并回车;弹窗出现后,粘贴这个用户自己的 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。

3

在 Claude 中填写连接

即使 Claude 当前显示登录页,也不用先登录,直接使用屏幕最上方菜单栏:

  1. Help → Troubleshooting → Enable Developer Mode
  2. Developer → Configure Third-Party Inference…
  3. Connection typeGateway
  4. Credential kindStatic API key
  5. Gateway API key:再次粘贴同一枚 Key。
  6. Gateway auth schemeBearer
  7. Gateway base URLhttps://fengyutoken.com,不要加 /v1
4

只添加 Opus,然后保存

  1. Models 中把 Model discovery 开关关闭。
  2. 删除自动出现的模型。首次验证建议只保留 claude-opus-5;Model ID 和 Display name 都填同一 ID,Tier alias 选 opus
  3. 点击 Apply Changes / Apply locally;出现 Save & Restart 时继续点击。

Model discovery 始终保持关闭。设置页的 Test connection 若单独显示 503 service_temporarily_unavailable,不要反复点击;真实 Code 请求仍然可用时,配置就是成功的。

5

在空白文件夹发一次真实 Code 请求

  1. 双击桌面的「启动 FengyuToken Claude Code」,选择 Local → Select folder
  2. Shift+Cmd+N 新建空白文件夹 FengyuToken-test,确认模型为 claude-opus-5
  3. 发送:“只回复 CONNECTED,不读取、创建或修改任何文件。”
  4. Claude 返回 CONNECTED,且本站调用用量出现同模型记录,才算完成。不要仅凭设置页的绿色提示宣称成功。
以后使用:直接双击桌面入口。需要更换 Key 时,先在 Claude 的 Gateway 设置中更新 Key,再重新运行第 2 步。真实请求若返回 402,请充值;真实请求若返回 503,请稍后再试,不要通过充值来处理 503。

Opus 首次验证实测会先安全预留 $1.01 左右,完成后按实际 usage 扣费,多余预留自动退回。

Windows 10 / 11:官方 Claude Desktop 图形 Code

不安装第三方客户端,不把 Key 写入 PowerShell,也不使用黑色终端版 Claude Code。

先看懂模式切换:原 Claude 图标和「启动 FengyuToken Claude Code」快捷方式打开的是同一个官方 Claude Desktop。快捷方式只负责进入 Code,不会绑定 Gateway,也不会创建第二个独立 Claude。同一 Windows 用户同一时间使用当前激活的一种模式;切回官方 Claude 时,先完全退出应用,再回到模式选择页选择 Anthropic 登录。配置 Gateway 不会自动删除已保存的官方账号。
1

安装官方 Claude Desktop 和 Git

  1. Claude 官方下载页安装最新版 Claude Desktop(Windows 10 build 19041+ / Windows 11,x64 或 Arm64),并打开一次。
  2. Git for Windows 官方页安装 Git;安装后完全退出 Claude,再重新打开。
  3. 到本站API 密钥创建并复制自己的完整 Key;到充值页确认可用余额至少 $2。Key 只填入后面的 Gateway API key,不要填到 Claude 登录页、PowerShell 或聊天中。
2

打开 Third-Party Inference

  1. 打开 Claude Desktop;即使显示登录页,也不需要登录或创建 Anthropic 账号
  2. 点击左上角菜单:Help → Troubleshooting → Enable Developer Mode
  3. Claude 重启后打开:Developer → Configure Third-Party Inference…
3

填写 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
留空
4

先用一个模型验证

  1. Model list / Models 中关闭 Model discovery,删除自动出现的模型。
  2. 首次只添加 claude-opus-5Model ID / Name 填完整 ID;Display label / Display name 可填同一 ID;Tier mapping / Tier aliasopus,并把它放在列表第一项(第一项即默认)。
  3. 点击 Apply locally / Apply Changes / Save & Restart(按钮名随版本可能不同);重启后选择 Continue with Gateway 或含义相同的第三方模式入口。

Test connection 单独出现 503 service_temporarily_unavailable 不足以判定配置失败:不要反复点击,也不要通过充值处理 503;保存并完全重启后,以下一步真实 Code 请求为准。

5

发送真实 Code 请求

  1. 进入 Claude Desktop → Code → Local → Select folder,选择一个空白文件夹 FengyuToken-test
  2. 确认当前模型为 claude-opus-5,发送:“只回复 CONNECTED,不读取、创建或修改任何文件。”
  3. 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 模式。

6

可选:创建官方高清图标的桌面入口

打开 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 新会话。

GRAPHICAL CLIENT · CHATBOX AI

在 Chatbox AI 中配置聊天

这条路线适合日常问答,不会改动 ChatGPT 桌面应用或 Codex 配置;第 1 步会只显示已选系统的安装说明。

本场景开始前:登录本站后打开API 密钥创建并保存一枚完整 Key;到充值页确认余额足够;从下面列表选择一个 Chat 模型 ID。
gpt-5.6-terragpt-5.6-solgpt-5.6-lunagpt-5.5gpt-5.4gpt-5.4-minigpt-5.3-codex-spark
1

按当前系统下载并打开 Chatbox AI

先打开 Chatbox AI 官方下载页,顶部系统切换会只显示与你电脑匹配的安装说明。

macOS
下载 DMG,打开后将 Chatbox 拖入 Applications / 应用程序,再从应用程序中打开。
Windows
下载安装包,双击并按提示完成安装,然后从开始菜单打开 Chatbox。
Linux
根据发行版选择 AppImage、deb 或 rpm;完成安装后从应用菜单启动。

如果欢迎页显示 Skip guide / 跳过引导,点击后进入主界面;若当前版本要求 Chatbox 登录,按页面提示完成。这一步只是进入 Chatbox,不是输入本站 Key。

2

新建一个 API 提供方

  1. 在 Chatbox 主界面点击左下角 Settings / 设置
  2. 点击 AI Provider / Model Provider / Model Settings(不同版本名称可能略有不同)。
  3. 在提供方列表底部点击 Add / Add Provider / 添加,类型选择 OpenAI API Compatible
3

逐项填写,不要把 Host 和 Path 混在一起

Provider Name
FengyuToken
API Type
OpenAI API Compatible
API Key
粘贴你在本站创建并保存的完整 Key
API Host
https://fengyutoken.com(这里不加 /v1
API Path
/v1/chat/completions;如果已是这个默认值,保持不变

最终请求地址应当只包含一次 /v1/chat/completions。如果填成 .../v1/v1/chat/completions,请将 API Host 末尾的 /v1 删除。

4

添加模型并检查连接

  1. 点击 Add Model / 添加模型,Model ID 完整填写 gpt-5.6-terra。模型类型选 Chat;首次只测文字时,能力选项可先不勾选。
  2. 需要多个模型时,继续点击 Add Model,从本节“开始前”列表逐个复制其他 Chat 模型 ID;不要添加 Responses 或 Messages 模型。
  3. 只有页面显示服务已就绪时,才点击 Save / 保存,再点击 Check / 检查。看到 Connection successful / 连接成功 后返回主界面。
5

新建对话并验证扣费记录

  1. 点击 New Chat / 新对话
  2. 点击输入框旁的模型选择器,依次选择 FengyuToken → gpt-5.6-terra
  3. 输入“只回复 CONNECTED”并发送。收到回复后,打开本站调用用量,确认有一条模型 ID 为 gpt-5.6-terra 的新记录。
成功标准:Chatbox 显示 CONNECTED,本站调用用量同时出现一条新记录。
6

切换模型、切回原服务或完全移除

  • 切换已添加的模型:在聊天页点击输入框旁的模型选择器,选择 FengyuToken 下的另一个模型。
  • 模型没出现:点击 Settings → Model Provider → FengyuToken → Add Model,粘贴另一个 Chat 模型 ID,保存后再回聊天页选择。
  • 切回你原来的服务:在模型选择器中选择原提供方和原模型。
  • 完全移除本站配置:打开 Settings → Model Provider → FengyuToken,点击 Disable / 停用Delete / 删除。这不会改动官方 ChatGPT 桌面端,也不会删除 Chatbox 里的其他提供方。
SCENE 02 · VS CODE + CODEX

在 VS Code 终端使用 Codex CLI

本站使用单独的 fengyu 配置,不覆盖原来的 Codex 账号文件。CLI 的 --profile fengyu 不会自动应用到桌面 App;桌面 App 请使用本页路线 A 的独立 CODEX_HOME 方式。

本场景开始前:登录本站后打开API 密钥创建并保存一枚完整 Key;到充值页确认余额足够;从下面列表选择 Responses 模型。
gpt-5.6-terragpt-5.6-solgpt-5.6-lunagpt-5.5gpt-5.4gpt-5.4-minigpt-5.3-codex-spark
1

打开项目和终端

打开 VS Code,点击 File / 文件 → Open Folder / 打开文件夹选择项目,再点击 Terminal / 终端 → New Terminal / 新建终端

2

安装 Codex CLI

只运行与你系统对应的一组命令。安装完成后关闭终端,再新建终端。

macOS / Linux
curl -fsSL https://chatgpt.com/codex/install.sh | sh
codex --version
Windows PowerShell
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
codex --version
3

新建本站专用配置文件

先运行与你系统一致的“打开配置文件”命令。文件打开后,把下面“配置内容”完整粘贴进去并保存。不要覆盖 ~/.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
4

在当前终端隐藏输入 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
5

启动并验证

codex --profile fengyu -m "gpt-5.6-terra"

进入后输入 /status,确认模型 ID;再输入“只回复 CONNECTED”。最后到调用用量核对新记录。

6

切换模型或切回原账号

切模型:在 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
codex
Windows 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 即可切回原账号。
SCENE 03 · PYCHARM + CODEX

在 PyCharm / JetBrains 终端使用 Codex CLI

本节从安装开始,所有操作都在 PyCharm 自带终端中完成,不需要先阅读 VS Code 教程。本站配置单独保存在 fengyu.config.toml,不会覆盖原来的 Codex 账号。

本场景开始前:打开API 密钥创建并保存一枚完整 Key;到充值页确认余额足够。本节默认模型是 gpt-5.6-terra;需要切换时,只选择价格页中带 Responses 标签的模型。
1

打开项目和内置终端

打开 PyCharm,点击 File → Open 选择项目,再点击 View → Tool Windows → Terminal(快捷键 Alt+F12)。后面的命令都输入在底部终端中。

2

安装 Codex CLI

展开与你电脑系统一致的卡片,复制整段命令并运行。看到版本号后,点击终端工具栏的垃圾桶关闭终端,再按 Alt+F12 新建终端。

macOS / Linux
curl -fsSL https://chatgpt.com/codex/install.sh | sh
codex --version
Windows PowerShell
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
codex --version
3

创建独立配置文件

先运行与你系统一致的“打开配置文件”命令;文件打开后,把下面“配置内容”完整粘贴进去并保存。不要编辑 ~/.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
4

在当前终端隐藏输入 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
5

启动并验证

codex --profile fengyu -m "gpt-5.6-terra"

Codex 打开后输入 /status 并回车,确认模型是 gpt-5.6-terra;再输入“只回复 CONNECTED”。收到回复后,到本站调用用量确认出现同一模型。

6

切换模型或切回原账号

切模型:在 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
codex
Windows PowerShell
Remove-Item Env:FENGYU_API_KEY -ErrorAction SilentlyContinue
codex
SCENE 04 · VS CODE + CLAUDE CODE

在 VS Code 使用 Claude Code

Claude Code 使用 /v1/messages,只选择价格页中带 Messages 标签的 Claude 模型;不转换为 OpenAI Responses,也不要填写 GPT 模型 ID。

本场景开始前

打开API 密钥创建并保存一枚完整 Key;到充值页确认余额足够。

当前可用的 Claude Code 模型
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,不会互相映射。

1

安装 VS Code 和 Claude Code

  1. 打开 VS Code,点击 Help / 帮助 → About / 关于,确认版本为 1.98 或更高。版本过低时,打开 VS Code 官方下载页 更新。
  2. 点击左侧 Extensions / 扩展,或按 macOS Cmd+Shift+X、Windows/Linux Ctrl+Shift+X
  3. 搜索 Claude Code,确认发布者为 Anthropic,点击 Install / 安装
2

打开项目和终端,再安装 CLI

点击 File / 文件 → Open Folder / 打开文件夹,再点击 Terminal / 终端 → New Terminal / 新建终端。扩展的图形面板自带运行组件,但在终端输入 claude 仍需要单独安装 CLI。

macOS / Linux
curl -fsSL https://claude.ai/install.sh | bash
claude --version
Windows PowerShell
irm https://claude.ai/install.ps1 | iex
claude --version
3

在当前终端输入本站配置

关闭这个终端后配置就会消失,不会删除或覆盖你原有的 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_KEY
Linux 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_KEY
Windows 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。

4

启动、检查地址并选择模型

先在 VS Code 终端运行:

claude
  1. Claude Code 打开后输入 /status 并回车,确认 Base URL 是 https://fengyutoken.com
  2. 输入 /model 并回车,选择本场景“当前可用的 Claude Code 模型”框中的模型;右下角模型按钮也会打开相同菜单。
  3. 部分版本会在模型名称旁显示 Cloud gateway,这是正常现象。
5

验证读取工具

  1. 在资源管理器新建 fengyu-claude-test.txt
  2. 第一行输入 FengyuToken Claude Code test 并保存,不要放密码或隐私内容。
  3. 在 Claude Code 输入:“请只读取 fengyu-claude-test.txt,告诉我第一行,不要修改文件。”
  4. 确认返回正确内容,再到调用用量核对模型与扣费。
6

切换模型或切回原账号

切模型:在 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
claude
Windows 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 右下角图形面板使用本站
这种方式会把完整 Key 明文保存在 VS Code 用户设置中,仅适合自己的私人电脑。共享电脑请不要使用本方式,而是在新终端中隐藏输入 Key,用完直接关闭该终端。
  1. Cmd+Shift+PCtrl+Shift+P,选择 Preferences: Open User Settings (JSON)打开 VS Code 的 settings.json
  2. 把下面的 claudeCode.environmentVariables 合并进现有 JSON 顶层;如果前一个设置项末尾没有逗号,先补一个英文逗号。不要删除或覆盖其他设置。
  3. Cmd+S(macOS)或 Ctrl+S(Windows/Linux)保存;打开 Settings → Extensions → Claude Code,勾选 Disable Login Prompt
  4. Cmd+Shift+PCtrl+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

SCENE 05 · PYCHARM + CLAUDE CODE

在 PyCharm / JetBrains 使用 Claude Code

本节包含插件、CLI、环境变量和切回命令,可以单独完成。JetBrains 插件负责显示差异、选中代码和诊断信息;Claude Code 本身从 PyCharm 内置终端启动。

本场景开始前

打开API 密钥创建并保存一枚完整 Key;到充值页确认余额足够。

本节可以选择的 Claude 模型
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;切换时只选本列表中的模型。

1

安装插件并重启 IDE

打开 Settings / Preferences → Plugins → Marketplace,搜索 Claude Code,点击 Install,然后完整退出并重新打开 PyCharm。

2

打开项目终端并安装 CLI

点击 View → Tool Windows → Terminal(快捷键 Alt+F12)。展开与你电脑系统一致的卡片,复制整段命令并运行;看到版本号后,完整退出并重新打开 PyCharm。

macOS / Linux
curl -fsSL https://claude.ai/install.sh | bash
claude --version
Windows PowerShell
irm https://claude.ai/install.ps1 | iex
claude --version
3

在当前终端输入完整配置

重新打开底部终端,运行与你系统一致的整段命令。出现输入提示后粘贴完整 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_KEY
Linux 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_KEY
Windows 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。

4

启动并检查连接

claude

Claude Code 打开后,先输入 /status 并回车,确认 Base URL 是 https://fengyutoken.com;再输入 /model,选择本节列表中的 Claude 模型。插件通常会自动连接当前 PyCharm。

5

验证 IDE 读取能力

在编辑器中新建 fengyu-claude-test.txt,第一行输入 FengyuToken PyCharm test 并保存。回到 Claude Code 输入:“请只读取 fengyu-claude-test.txt,告诉我第一行,不要修改文件。”确认返回内容与文件第一行逐字一致,并在本站调用用量看到新记录,即完成接入。

6

切换模型或切回原账号

切模型:在 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
claude
Windows 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 登录。

SCENE 06 · PYTHON + GPT

在 PyCharm 用 Python 调用 GPT

本节从创建项目开始,完整提供安装、Key、代码、运行、切模型和清理命令,不依赖其他章节。

本场景开始前:打开API 密钥创建并保存一枚完整 Key;到充值页确认余额足够;从下面列表选择一个 Chat 模型。
gpt-5.6-terragpt-5.6-solgpt-5.6-lunagpt-5.5gpt-5.4gpt-5.4-minigpt-5.3-codex-spark
1

创建项目并打开终端

点击 File → New Project → Pure Python,项目位置可保持默认,勾选创建新的 .venv 虚拟环境,再点击 Create。项目打开后,点击 View → Tool Windows → Terminal。如果终端提示符开头出现 (.venv),说明 PyCharm 已自动激活虚拟环境。

2

激活虚拟环境并安装 Python SDK

如果终端已显示 (.venv),只运行第一张卡片的命令。如果没有显示,运行与系统对应的完整命令。

已显示 (.venv)
python -m pip install --upgrade pip openai
macOS / Linux:尚未激活
python3 -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip openai
Windows 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。该政策只对当前终端生效。

3

在当前终端隐藏输入 API Key

运行与你系统一致的整段命令。提示输入时粘贴完整 Key 并回车;屏幕不会显示输入内容,Key 只在当前终端生效。

macOS zsh
read -s "FENGYU_API_KEY?API Key(输入不会显示): "; echo
export FENGYU_API_KEY
Linux Bash
read -rsp "API Key(输入不会显示): " FENGYU_API_KEY; echo
export FENGYU_API_KEY
Windows PowerShell
$secureKey = Read-Host "API Key(输入不会显示)" -AsSecureString
$env:FENGYU_API_KEY = [System.Net.NetworkCredential]::new("", $secureKey).Password
4

新建文件并粘贴代码

在左侧项目目录右键,选择 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)
5

运行并验证

Cmd+S(macOS)或 Ctrl+S(Windows/Linux)保存文件,然后在底部终端运行:

python fengyu_gpt_test.py

看到 CONNECTED 后,打开本站调用用量,核对模型 ID 和 tokens。

6

切换模型或清理测试配置

切模型: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
deactivate
Windows PowerShell
Remove-Item Env:FENGYU_API_KEY -ErrorAction SilentlyContinue
deactivate

最后可在项目树右键删除 fengyu_gpt_test.py;这些操作不会改变 PyCharm 的其他项目。

TROUBLESHOOTING

按报错代码快速处理

先停止重复请求,再按下面一行排查。不要通过关闭证书校验或改回 HTTP 来绕过错误。

看到什么通常表示怎么处理
400模型 ID、标签或请求格式不匹配回价格页重新复制,并确认场景要求 Chat、Responses 还是 Messages
401Key 缺失、粘贴错误、已停用或已撤销确认 Key 来自本站且仍启用;泄露时撤销并创建新 Key
402Key 已被识别,但余额不足以完成请求前的安全预留;这不是模型故障先充值再重试。当前 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/completions

GPT 聊天客户端和本页 Python GPT 示例。

POST /v1/responses

Codex 图形客户端和 Codex CLI 使用的 Responses 接口。

POST /v1/messages

Claude Code 使用的 Messages 接口。

SECURITY

最后检查一次密钥安全

  • 完整 Key 只保存在自己设备不要发给客服、AI 对话、群聊或截图。
  • 一个用途一枚 Key客户端和项目分开创建,出现异常时只停用对应 Key。
  • 不要写进代码仓库Python 从环境变量读取 Key,不要提交到 Git。
  • 发现异常立即撤销在密钥页永久撤销旧 Key,再创建新 Key。