Codex 安装与启动
自动检测当前环境，通过内置安装流程处理依赖，完成后可直接启动 Codex。
Windows 10/11 · 64 位
把 Codex、API 与创作工具
装进一个工作台
咸鱼 API 助手将安装、配置、启动和日常维护集中到同一个原生 Windows 界面。少切窗口，少填配置，打开就能工作。
蓝奏云高速下载，异常自动切换本站线路
1 个统一工作台
2 条API 可选线路
本地保存配置
自动检测 Codex 环境
一个入口，完成整套环境
从安装到创作，都在这里
围绕 Codex 的高频操作重新整理，让配置过程看得见、改得动、随时能恢复。
一键配置 API
验证密钥后加载可用模型，主线路与 CN2 备用线路可随时切换。
图片生成
单独筛选生图模型，支持上传参考图，并把结果保存到你指定的位置。
恢复与便携管理
管理便携版环境、修复插件市场，并按账户 Provider ID 扫描和恢复聊天记录。
咸鱼 API 助手使用教程
第一次使用，按顺序完成
从下载安装到 API 配置，每一步都对应软件中的实际入口。
准备工作
下载与安装
- 下载安装包
点击页面顶部的“下载 Windows 版”，保存
XianyuApiAssistant-Setup-x64.exe。适用于 Windows 10/11 64 位系统。 - 运行中文安装程序
双击安装包，按中文向导完成安装。建议保留默认安装位置，后续更新更省心。
- 首次启动
安装完成后打开“咸鱼 API 助手”。软件会先检测 Codex 和本地配置，等待右上角状态检查结束即可。
Windows 提示“已保护你的电脑”？确认安装包来自本官网并核对 SHA-256 后，可点击“更多信息”→“仍要运行”。
同步用量
账户与网站会话
- 打开“网站”页签
软件内直接载入
xianyuapi.com。登录或注册均在这个内置页面完成，不需要额外配置账户。 - 回到工作台刷新
登录成功后返回“工作台”，点击账户概览右上角的刷新按钮，同步余额和用量。
- 识别当前状态
没有登录时，首页余额会明确显示“未登录”；这不是余额查询异常。登录后刷新即可显示账户数据。
关键步骤
配置 API
- 准备 API 密钥
在网站控制台创建密钥，然后进入软件“工具”→“Codex 与 API”，粘贴到“API 密钥”输入框。
- 选择线路
默认使用“主线路”；主线路连接异常时切换“CN2 备用”。线路标签下方会显示用途说明。
- 验证并选择模型
点击“验证密钥”。验证成功后模型下拉框会加载可用模型，再选择需要的模型。
- 执行一键配置
点击“一键配置”。助手会写入 Codex 所需的本地配置；密钥不会在网页中公开展示。
开发环境
安装与启动 Codex
- 先点“检测 Codex”
检测结果会显示在按钮下方。已经安装时可直接点击“启动 Codex”。
- 未安装时点“安装 Codex 桌面版”
助手会先检测 winget；系统缺少时自动安装 Microsoft App Installer 及依赖，再通过 Microsoft Store 安装 Codex 桌面版。全程无需操作命令窗口。
- 安装完成后再次检测
状态变为“Codex 已就绪”后再启动。如果仍显示未安装，先退出助手后重新打开并检测。
不要连续点击安装。下载、验证和系统安装都需要时间；等待当前进度结束后再重试。
创作工具
图片生成与参考图
- 进入“图片生成”
模型列表只显示支持生图的模型，避免在通用模型中反复查找。
- 输入描述或上传参考图
写清主体、场景、风格和画面比例；需要保持人物或构图时，添加一张参考图。
- 生成并保存
生成完成后预览图片，点击下载并选择保存位置。建议先保存原图，再进行二次编辑。
独立环境
Codex 便携版
- 打开“便携版”页签
选择一个空间充足、路径简短的位置作为便携版目录，例如
E:\CodexPortable。 - 安装并管理环境
通过页面按钮完成下载、启动、停止和更新。每个便携环境独立保存，不影响系统中已安装的 Codex。
- 迁移前先关闭
复制便携版目录前先停止运行，避免会话索引或配置文件仍被占用。
维护工具
插件市场修复与聊天记录恢复
- 插件市场异常
进入“插件市场”，使用修复入口重新检查组件。修复完成后重启 Codex 再验证市场是否恢复。
- 刷新账户列表
在“工具”→“聊天记录恢复”点击“刷新账户”，从列表选择正确的 Provider ID。
- 扫描并确认恢复
点击“扫描聊天记录”，核对待恢复记录数量后再点击“恢复所选记录”。不要在扫描中途退出软件。
Provider ID 要选对。配置、会话、索引和当前账户可能对应不同 ID；优先选择你原先使用的账户标识。
可选组件
安装 Clash Verge
- 进入“工具”页底部
Clash Verge 是独立安装入口，不会替换或修改你已有的 Clash 配置。
- 点击“安装 Clash Verge”
安装包从本地资源启动。按系统安装向导完成后，再自行导入你的订阅或配置。
- 网络问题仍需单独排查
Clash 只负责本机网络代理；API 密钥、模型权限和账户余额仍需在对应位置检查。
SHA-256 文件校验
886605B2AA5DEF1A7E721794F4F750D38FC65B641E7A6342E1B5E25971D53544
在 PowerShell 中运行 Get-FileHash .\XianyuApiAssistant-Setup-x64.exe -Algorithm SHA256，结果应与上方一致。
常见问题
遇到问题，先看这里
多数异常来自登录状态、网络线路或安装进程尚未结束。
首页为什么显示“未登录”，余额查不到？
这表示软件内的网站会话尚未登录。进入“网站”页签登录 xianyuapi.com，成功后返回工作台刷新账户概览。首页不会额外弹出登录页。
API 验证成功，但模型选择框没有内容？
先确认密钥具有可用额度和模型权限，再切换主线路或 CN2 备用线路重新验证。模型列表只会加载当前密钥能够调用的模型。
Codex 下载完成后仍提示安装失败怎么办？
不要连续重复安装。退出助手并重新打开，先点“检测 Codex”；如仍未检测到，请确认 Windows 更新服务和 Microsoft Store 相关组件可用。
聊天记录恢复时该选择哪个账户 ID？
选择原先产生这些聊天记录的 Provider ID。先点击“刷新账户”，再扫描记录并核对数量，确认无误后恢复。
主线路和 CN2 备用线路有什么区别？
主线路是默认入口；当本地网络访问不稳定或延迟明显时，可切换 CN2 备用线路。两者仍使用同一账户密钥。