Skip to content

CoderRelay v0.7.0 — Rebrand and Native Installers

Choose a tag to compare

View all tags
@Lortzing Lortzing released this 22 Jul 09:20
v0.7.0
6b41ac9

CoderRelay v0.7.0

CoderRelay v0.7.0 是项目更名后的首个版本。

本版本将原 CodexRelay 全面重构为 CoderRelay，统一更新了项目名称、命令行入口、Python 模块、配置目录、安装器和 Release 产物，为后续支持 Claude Code 及其他 Coding Agent CLI 做准备。

主要变化

项目正式更名为 CoderRelay

项目不再绑定单一工具：

CodexRelay → CoderRelay

新的项目定位：

面向 Codex CLI、Claude Code 及其他编码智能体 CLI 的账户、Profile 与 API 路由管理工具。

当前版本仍完整支持 OpenAI Codex CLI。Claude Code 支持将在后续版本中加入，本版本不会修改 Claude Code 配置。

新的命令行入口

推荐使用新的短命令：

cdy --help

也可以使用完整命令：

coder-relay --help

原有命令 cxr 已移除，不再提供兼容入口。

新的包与模块名称

项目 | 旧名称 | 新名称 -- | -- | -- 项目名称 | CodexRelay | CoderRelay CLI 短命令 | cxr | cdy CLI 完整命令 | codex-relay | coder-relay Python 分发名 | codex-relay | coder-relay Python 模块 | codex_relay | coder_relay 配置目录 | ~/.config/codex-relay | ~/.config/coder-relay 环境变量 | CODEX_RELAY_HOME | CODER_RELAY_HOME

原生安装包

本版本开始为多个操作系统和处理器架构提供原生安装包。

Windows

提供安装版和便携版：

CoderRelay-Setup-0.7.0-windows-x86.exe
CoderRelay-Setup-0.7.0-windows-x86_64.exe
CoderRelay-Setup-0.7.0-windows-arm64.exe

CoderRelay-Portable-0.7.0-windows-x86.zip

CoderRelay-Portable-0.7.0-windows-x86_64.zip

CoderRelay-Portable-0.7.0-windows-arm64.zip

Setup 版本会：

  • 安装 cdy.exe

  • 将安装目录加入用户 PATH

  • 注册标准 Windows 卸载程序

  • 支持通过系统设置卸载

macOS

提供 Intel 和 Apple Silicon 两个版本：

CoderRelay-0.7.0-macOS-x86_64.dmg

CoderRelay-0.7.0-macOS-arm64.dmg

DMG 中包含 PKG 安装器，安装后可直接运行：

cdy --help

Linux

提供通用压缩包、DEB 和 RPM：

coder-relay-0.7.0-linux-x86_64.tar.gz

coder-relay-0.7.0-linux-aarch64.tar.gz


coder-relay_0.7.0_amd64.deb

coder-relay_0.7.0_arm64.deb


coder-relay-0.7.0-1.x86_64.rpm

coder-relay-0.7.0-1.aarch64.rpm

Release 同时包含：

SHA256SUMS.txt

可用于校验下载文件的完整性。

当前功能

CoderRelay 当前支持：

  • 管理多个 ChatGPT/Codex 登录 Profile

  • 管理 API Key + Base URL + Model 类型的兼容 API

  • 首次运行时自动导入当前 Codex 配置

  • 手动切换 Profile

  • API 和账户健康检查

  • 自动故障转移

  • 高优先级 Profile 恢复后自动切回

  • 展示套餐、限额窗口、Credits、API 余额和延迟

  • 使用文件锁、原子写入和备份安全替换配置

  • Bash、Zsh 和 Fish 自动补全

  • 自更新和卸载命令

升级注意事项

这是一次不向后兼容的重命名。

升级前建议备份旧配置：

cp -R ~/.config/codex-relay ~/.config/codex-relay.backup

如需迁移旧配置，可复制到新目录：

cp -R ~/.config/codex-relay ~/.config/coder-relay

随后使用新命令：

cdy status

旧的以下入口不再使用：

cxr

codex-relay

codex_relay

CODEX_RELAY_HOME

安全提示

本版本的 Windows 和 macOS 安装包未进行数字签名。

因此：

  • Windows 可能显示 SmartScreen 或“未知发布者”提示

  • macOS 可能被 Gatekeeper 阻止

安装包仍可正常构建和使用，但请仅从本项目的官方 GitHub Release 页面下载，并通过 SHA256SUMS.txt 校验文件完整性。

验证

本版本已完成：

  • 34 项自动化测试

  • Python Wheel 构建测试

  • Python source distribution 构建测试

  • cdy --help 安装后冒烟测试

  • Windows、macOS 和 Linux 安装脚本静态检查

  • 旧项目名、旧模块名和旧 CLI 入口残留检查

下一步

后续版本计划加入：

  • Claude Code Profile 管理

  • Claude Code API Endpoint 与认证配置切换

  • Codex 与 Claude Code 的统一状态展示

  • 跨 Coding Agent 的健康检查与自动故障转移

  • 更完整的迁移和升级机制

Assets 17
Loading