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-6-astragpt-5.6-solgpt-5.6-terragpt-5.6-luna
Codex(桌面端 / CLI)模型
gpt-6-astragpt-5.6-solgpt-5.6-terragpt-5.6-luna
Claude Code 模型
claude-opus-5-5claude-opus-5claude-opus-4-8claude-sonnet-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-6-astragpt-5.6-solgpt-5.6-terragpt-5.6-luna
macOS · 图形桌面入口
1

每个人创建自己的 Key

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

2

只运行一次通用安装程序

本安装器只适用于 macOS 上的当前版 ChatGPT 桌面应用。请先将官方 ChatGPT / Codex 安装到“应用程序”文件夹。安装器会另建本站专用副本,不修改官方应用。请只保留“应用程序”文件夹里的一份 ChatGPT.app,如果桌面还有一份,请手动移走后再配置。首次配置时,macOS 还可能询问终端访问桌面、钥匙串或控制 ChatGPT 的权限,请选择允许。

  1. 保存工作;若是在重装,只退出 FengyuToken 窗口,官方客户端不需要退出。
  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 组件和 Fast 菜单,创建 ~/.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"

独立副本说明:首次安装或从旧方案升级时,需要确认一次本地兼容签名:仅放宽 FengyuToken 副本的动态库签名检查,不关闭系统全局保护、不修改官方客户端。上述 OpenAI 签名与公证校验针对原始组件,不代表修改后的副本获得官方签名。官方专属的 Computer Use 等身份认证功能请使用官方客户端。副本固定使用已验证的版本,关闭其官方自动升级,由本站安装器维护 Fast;官方客户端可独立更新。尚未确认此说明的旧用户需手动运行一次更新命令,不能直接静默迁移;此后的同类更新可在打开本站入口时自动检查,已运行的窗口在完全退出并重开后使用新版本。

3

双击桌面的「启动 FengyuToken Codex」

以后不要用原 ChatGPT 图标启动本站模式,直接双击桌面上新生成的 启动 FengyuToken Codex。它是一个带 ChatGPT 图标的 macOS 应用入口,启动时不会打开终端窗口。FengyuToken Codex 已经在运行时,再次双击只会唤醒现有窗口,没有 ChatGPT 进程时会直接启动。官方与 FengyuToken 使用不同的界面和配置目录,可以同时运行,不会互相退出。

正确画面:左下角显示 FengyuToken,右下角显示 5.6 Terra(通用旗舰) 或另一个已上架的 Responses 模型。之后发送“只回复 CONNECTED”,并到调用用量确认有新记录。
让下次打开更快:第一次进入后,日常只点左上角红点或按 Cmd+W 关闭窗口,不要按 Cmd+Q 完全退出。这样再次双击桌面入口时会直接恢复现有窗口。若电脑直连 ChatGPT 服务较慢,冷启动可能需要等待桌面外壳完成账号与功能初始化,这不代表本站 API 连接慢。使用规则代理时,可让 ChatGPT / OpenAI 相关地址走代理,同时让本站地址保持直连。

应用外壳仍可能保留原 ChatGPT 登录,这不代表配置失败。请以左下角服务名、右下角模型和本站用量记录为准。

4

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

切换模型:用右下角的模型按钮切换另一个 Responses 模型,在同一处的 Reasoning / 推理强度 选择 Low、Medium 或 High。Low 更快,High 推理更深入且通常更慢。此前已配置但看不到该选项:先按 Cmd+Q 退出,再执行上方“旧版 macOS:启用一键更新”命令一次,然后从桌面入口重新打开,不会再次要求输入 Key。打开官方 Codex:直接双击原来的 ChatGPT / Codex 图标即可,无需退出 FengyuToken。原图标使用官方配置,本站桌面入口使用 FengyuToken 配置。Fast / 1.5× 可在输入框的速度菜单选择;实际速度取决于上游负载,费用按本站 Fast 定价计算。

Windows 10 / 11 · 图形一键版

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

Microsoft Store 版 ChatGPT 必须通过 Windows 应用标识启动;新版入口会在直接路径被系统拒绝时自动改用受支持的应用激活方式,不修改 WindowsApps 权限,也不覆盖官方配置。

请先安装新版 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 / 推理强度 选择 Low、Medium 或 High。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 type:Gateway。
  4. Credential kind:Static API key。
  5. Gateway API key:再次粘贴同一枚 Key。
  6. Gateway auth scheme:Bearer。
  7. Gateway base URL:https://fengyutoken.com,不要加 /v1。
4

添加模型并保存

  1. 关闭 Model discovery(保持关闭),删除自动出现的模型。
  2. 把下面当前实时列表中的模型逐个添加:Model ID 和 Display name 都填同一 ID;ID 含 opus 时 Tier alias 选 opus,含 sonnet 时选 sonnet。
  3. 点击 Apply Changes / Apply locally,出现 Save & Restart 时继续点。
claude-opus-5-5claude-opus-5claude-opus-4-8claude-sonnet-5

此实时列表中的 Claude Messages 模型均来自已验证目录,不要添加 GPT / Codex 模型。需要 Sonnet 时同样添加,Tier alias 选 sonnet;只使用当前实时列表中的模型 ID。设置页 Test connection 若单独显示 503,不用理会,以第 5 步真实请求为准。

5

发一次真实请求验证

  1. 双击桌面「启动 FengyuToken Claude Code」→ Local → Select folder,按 Shift+Cmd+N 新建空文件夹 FengyuToken-test 并选择。
  2. 右下角选 claude-opus-5-5,发送:“只回复 CONNECTED,不读取、创建或修改任何文件。”
  3. 返回 CONNECTED、且本站调用用量出现同模型记录,即成功。
以后使用:直接双击桌面入口。换 Key 时先在 Claude 的 Gateway 设置里改 Key,再重跑第 2 步。真实请求报 402=余额不足请充值,报 503=稍后再试,不要靠充值解决。
6

解除沙箱 / 网络拦截(让 Claude 能执行命令、连服务器)

先分清两件事:FengyuToken 的接入连接始终走网关,不受沙箱影响,沙箱只隔离「Claude 帮你执行的终端命令」(连服务器、装依赖、curl 等)。所以出现“连不上服务器”多半不是 Key 或余额问题,而是命令被权限或网络沙箱挡住了。命令沙箱在 macOS / Linux / WSL2 生效。

  1. 日常放行(推荐):Claude 要改文件或运行命令时会弹权限,点 Allow / 允许(本次)或 Always allow / 始终允许(记住该操作)。想少弹窗,用 Shift+Tab 切换权限模式:Accept edits 自动允许改文件,Plan 只读规划。
  2. 放行某个 IP / 域名:命令首次访问新主机会提示,选允许即对本次会话生效,选“记住”会写入本地允许规则。要预先固定放行(例如你的服务器 IP),在 Claude Code 终端输入 /sandbox 打开面板并在 Network 里添加,或在 ~/.claude/settings.json 写入 sandbox.network.allowedDomains,支持 IP、IP:端口、*.域名:
{
  "sandbox": {
    "enabled": true,
    "network": {
      "allowedDomains": ["203.0.113.10", "203.0.113.10:22", "github.com", "*.npmjs.org"]
    }
  }
}

把 203.0.113.10 换成你自己的服务器地址,IPv6 用方括号,如 "[::1]:443"。改完后重开 Claude Code 会话生效,查看或编辑 allow / ask / deny 规则可在终端输入 /permissions。

进阶(请谨慎):把 allowedDomains 设为 ["*"] 放行所有网络,或用 Shift+Tab 切到 Bypass permissions(跳过所有确认,CLI 对应 --dangerously-skip-permissions,Pro/Max 首次需在 Settings → Claude Code → Allow bypass permissions mode 打开)。放得越开风险越大——Claude 将能不经确认读写文件、执行命令、访问任意网络,请只在完全信任的自用电脑上这样做。

菜单与按钮名称随 Claude 版本可能不同,以屏幕上的实际提示为准。

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. 把下面当前实时列表中的模型逐个添加:Model ID 填完整 ID,Display name 可填同一 ID;ID 含 opus 时 Tier alias 选 opus,含 sonnet 时选 sonnet。把首选模型放在列表首位(首位即默认)。
  3. 点击 Apply locally / Apply Changes / Save & Restart(按钮名随版本可能不同),重启后选 Continue with Gateway 或含义相同的第三方入口。
claude-opus-5-5claude-opus-5claude-opus-4-8claude-sonnet-5

此实时列表中的 Claude Messages 模型均来自已验证目录,不要添加 GPT / Codex 模型。需要 Sonnet 时同样添加,Tier alias 选 sonnet;只使用当前实时列表中的模型 ID。Test connection 单独出现 503 不用理会,以第 5 步真实请求为准。

5

发一次真实请求验证

  1. 进入 Claude Desktop → Code → Local → Select folder,选择空文件夹 FengyuToken-test。
  2. 选 claude-opus-5-5,发送:“只回复 CONNECTED,不读取、创建或修改任何文件。”
  3. 返回 CONNECTED、且本站调用用量出现同模型新记录,即成功。
6

权限与网络(让 Claude 能执行命令、连服务器)

FengyuToken 的接入连接始终走网关,不受权限沙箱影响。如果 Code 里连不上服务器或装不了依赖,通常不是 Key 或余额问题,而是命令的权限没放行。Claude 要改文件或运行命令时会弹权限:

  • 逐条放行:弹窗里点 Allow / 允许(本次)或 Always allow / 始终允许(记住该操作)。
  • 少弹窗:用 Shift+Tab 切换权限模式,Accept edits 自动允许改文件,Plan 只读规划。
  • 进阶(请谨慎):切到 Bypass permissions 会跳过所有确认,Pro/Max 首次需在 Settings → Claude Code → Allow bypass permissions mode 打开,Claude 将能不经确认读写文件、执行命令,请只在完全信任的自用电脑上使用。

原生 Windows 没有针对终端命令的网络沙箱(该功能仅 macOS / Linux / WSL2 有),因此这里主要通过上面的权限弹窗与模式来放行,无需修改 settings.json 的 allowedDomains。菜单与按钮名称随版本可能不同,以屏幕实际提示为准。

7

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

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

新建对话并验证扣费记录

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

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

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

让 Codex Agent 直接在 Linux 服务器上工作

这条路线会把 Agent 安装在你登录的服务器用户下:它通过 FengyuToken 调用 Responses 模型,并在服务器当前项目中读取文件、修改代码、运行命令和测试。不需要另外开放 Agent 端口,也不需要先把服务器代码拉到本地。

本场景开始前:在API 密钥页为这台服务器创建一枚独立 Key,并到充值页确认余额足够。建议使用专门的低权限 Linux 用户,不要以 root 运行 Agent。
1

SSH 登录并选择使用方式

普通 SSH 或 VS Code Remote‑SSH 的集成终端都能使用。默认安装使用独立的 ~/.codex-fengyu-server,不会修改原来的 ~/.codex。

如需 VS Code 左侧官方 Codex 面板,请使用专门的远程 Linux 用户并选择下方“Remote‑SSH 侧边栏”。若该用户已有 ~/.codex,安装器会拒绝覆盖并保持原样。
2

运行一键安装(二选一)

安装器会检查 Codex CLI、下载当前 Responses 模型,隐藏读取 Key,并在写入前发送一次真实测试请求。

推荐:SSH / VS Code 终端
installer="$(mktemp)"
curl -fsSL "https://fengyutoken.com/downloads/fengyutoken-codex-linux.sh" -o "$installer" && bash "$installer"
status=$?; rm -f "$installer"; [ "$status" -eq 0 ]

只新增 fengyu-codex 命令,直接运行 codex 仍是原官方配置。

可选:Remote‑SSH 侧边栏
installer="$(mktemp)"
curl -fsSL "https://fengyutoken.com/downloads/fengyutoken-codex-linux.sh" -o "$installer" && bash "$installer" --enable-remote-vscode
status=$?; rm -f "$installer"; [ "$status" -eq 0 ]

只在 ~/.codex 完全不存在时建立安全链接,发现任何原配置就立即停止。

3

在服务器项目中启动 Agent

cd /path/to/your-project
fengyu-codex

把路径换成真实项目目录。进入后输入 /status 确认模型,再先让它“只读检查项目并告诉我如何运行测试”,确认无误后再授权修改。

4

在 VS Code Remote‑SSH 中使用

  1. 连接 Remote‑SSH 并打开服务器项目文件夹。
  2. 稳定方式:点击 Terminal / 终端 → New Terminal / 新建终端,运行 fengyu-codex,Agent 实际在远程服务器执行。
  3. 侧边栏方式:先用 --enable-remote-vscode 安装,再确认官方 Codex 扩展安装在 SSH: 当前服务器,执行 Developer: Reload Window 后打开 Codex 图标。

不要只在扩展的官方登录框粘贴 FengyuToken Key:Key 不包含 API 地址,单独粘贴仍会走官方线路。

5

自动化、换 Key 与原账号

  • 非交互任务:fengyu-codex exec "运行测试并总结失败原因"。
  • 换 Key / 更新模型:重新执行第 2 步,新配置验证成功后才替换旧配置。
  • 原官方账号:默认模式下直接运行 codex,仍读取原来的 ~/.codex。
  • 密钥安全:Key 不写入项目、shell 启动文件或 VS Code 设置,仅保存在当前 Linux 用户可读的 0600 文件中。
SCENE 02 · VS CODE + CODEX

在 VS Code 官方 Codex 侧边栏使用 FengyuToken

这是 VS Code 里的官方 Codex 对话侧边栏,不是终端窗口。安装器会新建 FengyuToken 专用的 VS Code 配置、扩展目录和 Codex 配置,原来的 VS Code、Codex、扩展和官方账号都不会被覆盖。若代码实际在远程服务器,请改用“Linux 服务器 Agent”教程。

本场景开始前:登录本站后,在API 密钥页创建并保存一枚自己的完整 Key,到充值页确认余额足够。只选择下面列出的 Responses 模型。
gpt-6-astragpt-5.6-solgpt-5.6-terragpt-5.6-luna
1

关闭 VS Code,并运行一次对应系统的安装命令

运行后会先要求输入你的 Key(输入不会显示),再安装官方 Codex 扩展、建立隔离配置并做一次连接测试。只有测试成功才会创建专用启动入口。请不要把 Key 发给客服或粘贴到聊天记录。

macOS
installer="$(mktemp)"
curl -fsSL "https://fengyutoken.com/downloads/fengyutoken-vscode-codex-macos.sh?v=20260903-launcher-fix" -o "$installer" && zsh "$installer"
installer_exit=$?; rm -f "$installer"; test "$installer_exit" -eq 0

请在 macOS 的“终端”中运行,如系统询问终端访问钥匙串或打开应用的权限,请允许。Key 只保存在本机钥匙串。此前失败留下的旧专用目录不会被修改,本版本会建立新的隔离配置。

Windows PowerShell
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
$installer = Join-Path $env:TEMP "install-fengyutoken-vscode-codex-windows.ps1"
Invoke-WebRequest -UseBasicParsing "https://fengyutoken.com/downloads/fengyutoken-vscode-codex-windows.ps1" -OutFile $installer
powershell.exe -NoProfile -ExecutionPolicy Bypass -File $installer

请使用普通 PowerShell,不必以管理员身份运行。Key 使用当前 Windows 用户的加密保护,不写入 VS Code 设置。

2

从新的专用入口打开 VS Code

  1. 安装成功后,桌面会出现 “启动 FengyuToken Codex VS Code”。从它打开,而不是从原来的 VS Code 图标打开。
  2. 点击 File / 文件 → Open Folder / 打开文件夹,选择你想让 Codex 协助的项目。
  3. 右侧会自动打开 Codex 面板,若没有显示,按 macOS Cmd+Shift+P 或 Windows Ctrl+Shift+P,运行 Codex: Open Codex Sidebar。

不要在扩展的官方登录页粘贴本站 Key,也不需要登录官方账号,专用入口已经带好本站连接配置。

3

先做一个安全测试,再开始使用

在 Codex 面板输入:只回复 CONNECTED。收到回复后,到调用用量确认出现一条 Responses 模型记录。首次让它处理真实项目时,建议先让它“只读检查项目并说明如何运行测试”。

4

更新 Key、模型或切回原来的 VS Code

  • 更新 Key 或刷新当前模型:重新运行第 1 步的同一条安装命令,配置会先重新测试,再替换 FengyuToken 专用入口。
  • 换模型:在 Codex 面板输入 /model,只选择本节顶部列出的 Responses 模型。
  • 切回原账号:关闭 FengyuToken 专用 VS Code,再直接从原来的 VS Code 图标打开即可。两套目录彼此独立。
备用:只想在 VS Code 终端运行 Codex CLI⌄

下面是旧式终端方式。它不会出现官方侧边栏,且 Key 只在当前终端有效,优先使用上方的一键侧边栏方式。

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 完全分开。

macOS / Linux:打开文件
mkdir -p ~/.codex-fengyu-cli
nano ~/.codex-fengyu-cli/config.toml

粘贴后按 Ctrl+O、回车保存,再按 Ctrl+X 退出。

Windows PowerShell:打开文件
New-Item -ItemType Directory -Force "$HOME\.codex-fengyu-cli" | Out-Null
notepad "$HOME\.codex-fengyu-cli\config.toml"

记事本打开后粘贴配置,按 Ctrl+S 保存并关闭。

配置内容

model = "gpt-6-astra"
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
export CODEX_HOME="$HOME/.codex-fengyu-cli"
printf "\n"
Windows PowerShell
$secureKey = Read-Host "API Key(输入不会显示)" -AsSecureString
$env:FENGYU_API_KEY = [System.Net.NetworkCredential]::new("", $secureKey).Password
$env:CODEX_HOME = "$HOME\.codex-fengyu-cli"
5

启动并验证

codex -m "gpt-6-astra"

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

6

切换模型或切回原账号

切模型:在 Codex 中按 Ctrl+C 退回终端,然后从下列完整命令中选一条运行:

codex -m "gpt-6-astra"
codex -m "gpt-5.6-sol"
codex -m "gpt-5.6-terra"
codex -m "gpt-5.6-luna"

切回原账号:点击终端工具栏的垃圾桶,再点击 Terminal / 终端 → New Terminal / 新建终端,然后直接运行 codex。如果不关闭终端,执行与你系统对应的命令:

macOS / Linux
unset CODEX_HOME FENGYU_API_KEY
codex
Windows PowerShell
Remove-Item Env:FENGYU_API_KEY -ErrorAction SilentlyContinue
Remove-Item Env:CODEX_HOME -ErrorAction SilentlyContinue
codex

清除 CODEX_HOME 后会重新读取原来的 Codex 配置,本站独立目录仍保留,之后需要时可再次使用。

让本机助手代为配置时的安全清单⌄
请只配置 Codex CLI 的独立 CODEX_HOME:新建 ~/.codex-fengyu-cli/config.toml,不修改 ~/.codex/config.toml、auth.json 或原账号登录。Base URL 使用 https://fengyutoken.com/v1,模型使用 gpt-6-astra,Key 仅由我在本机隐藏输入到 FENGYU_API_KEY。启动时只给当前终端设置 CODEX_HOME=~/.codex-fengyu-cli,清除 CODEX_HOME 和 FENGYU_API_KEY 后直接运行 codex 即可切回原账号。
SCENE 03 · PYCHARM + CODEX

在 PyCharm / JetBrains 终端使用 Codex CLI

本节从安装开始,所有操作都在 PyCharm 自带终端中完成。本站配置保存在独立的 CODEX_HOME,不会覆盖原来的 Codex 账号。

本场景开始前:打开API 密钥创建并保存一枚完整 Key,到充值页确认余额足够。本节默认模型是 gpt-6-astra,需要切换时,只选择价格页中带 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 完全分开。

macOS / Linux:打开文件
mkdir -p ~/.codex-fengyu-cli
nano ~/.codex-fengyu-cli/config.toml

粘贴后按 Ctrl+O、回车保存,再按 Ctrl+X 退出。

Windows PowerShell:打开文件
New-Item -ItemType Directory -Force "$HOME\.codex-fengyu-cli" | Out-Null
notepad "$HOME\.codex-fengyu-cli\config.toml"

记事本打开后粘贴配置,按 Ctrl+S 保存并关闭。

配置内容

model = "gpt-6-astra"
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
export CODEX_HOME="$HOME/.codex-fengyu-cli"
printf "\n"
Windows PowerShell
$secureKey = Read-Host "API Key(输入不会显示)" -AsSecureString
$env:FENGYU_API_KEY = [System.Net.NetworkCredential]::new("", $secureKey).Password
$env:CODEX_HOME = "$HOME\.codex-fengyu-cli"
5

启动并验证

codex -m "gpt-6-astra"

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

6

切换模型或切回原账号

切模型:在 Codex 中按 Ctrl+C 退回 PyCharm 底部终端,然后从下列完整命令中选一条运行:

codex -m "gpt-6-astra"
codex -m "gpt-5.6-sol"
codex -m "gpt-5.6-terra"
codex -m "gpt-5.6-luna"

切回原账号:点击终端工具栏的垃圾桶,按 Alt+F12 新建终端,然后直接运行 codex。如果不关闭终端,执行:

macOS / Linux
unset CODEX_HOME FENGYU_API_KEY
codex
Windows PowerShell
Remove-Item Env:FENGYU_API_KEY -ErrorAction SilentlyContinue
Remove-Item Env:CODEX_HOME -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-opus-5-5claude-opus-5claude-opus-4-8claude-sonnet-5

列表完全来自当前已上架且已验证的 Messages 模型,稳妥默认使用最新 Sonnet;Opus 使用各自完整模型 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_OPUS_MODEL="claude-opus-5-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_OPUS_MODEL="claude-opus-5-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_OPUS_MODEL = "claude-opus-5-5"
$env:ANTHROPIC_MODEL = "claude-sonnet-5"

默认使用当前最新的 Sonnet,选择 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+P 或 Ctrl+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+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-5" },
    { "name": "ANTHROPIC_DEFAULT_HAIKU_MODEL", "value": "claude-sonnet-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-opus-5-5claude-opus-5claude-opus-4-8claude-sonnet-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_OPUS_MODEL="claude-opus-5-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_OPUS_MODEL="claude-opus-5-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_OPUS_MODEL = "claude-opus-5-5"
$env:ANTHROPIC_MODEL = "claude-sonnet-5"

默认使用当前最新的 Sonnet,选择 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-6-astragpt-5.6-solgpt-5.6-terragpt-5.6-luna
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-6-astra",
    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-6-astra",从本场景开头的 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。