Starstruk Logo MarkStarstruk

v3.1.0

farion1231/cc-switchv3.1.0Sep 1, 2025by github-actions[bot]

AI Summary

This release introduces Codex vendor management with one-click switching support, allowing users to manage vendor copies in ~/.codex/ and switch between configurations. It also adds automatic import of current Codex configuration as the default vendor and implements automatic backup before v1→v2 migration for safe rollback.

Key Highlights

  • New Codex vendor management with one-click switching capability
  • Automatic import of current Codex configuration as default vendor
  • Automatic backup before v1→v2 migration (config.v1.backup.<timestamp>.json)
  • Backup of cc-switch's own configuration during migration
  • Improved documentation for migration instructions and compatibility notes

New Features

  • Codex support: Manage ~/.codex/ vendor copies (auth-<name>.json, config-<name>.toml) with one-click switch to main config (auth.json, config.toml)
  • Import default: Detect ~/.codex/auth.json and import as default vendor
  • Migration safety: Automatic backup of cc-switch config before v1→v2 migration
  • Non-intrusive switching: File-level copy without changing ~/.claude/ and ~/.codex/ effective file structure

Full Release Notes

## Claude Code 与 Codex 供应商切换工具

### 亮点

    - 新增 Codex 供应商管理与一键切换
    - 自动导入当前 Codex 配置为默认供应商
    - v1→v2 迁移前自动备份，回滚更安心

### 新增

    - Codex 支持：管理 ~/.codex/ 的供应商副本（auth-<name>.json、config-<name>.toml），一键切换到主配置（auth.json、config.toml）
    - 导入默认：检测 ~/.codex/auth.json 时可导入为 default 供应商

### 改进

    - 迁移安全：在 v1→v2 迁移前备份 cc-switch 自身配置为 ~/.cc-switch/config.v1.backup.<timestamp>.json
    - 文档：完善迁移说明与兼容性提示

### 兼容性

    - 不改变 ~/.claude/ 与 ~/.codex/ 的生效文件结构，切换仅进行文件级复制
    - 降级到旧版 cc-switch 时，建议使用备份文件或在旧版中重新导入

### 迁移说明

    - 首次运行 v3.1.0 时，如检测到 v1 配置，将备份旧文件并自动迁移到 v2
    - 备份文件路径：~/.cc-switch/config.v1.backup.<timestamp>.json
### 鸣谢


    - 感谢社区用户对 Codex 支持诉求与测试反馈


### 下载

- macOS: `CC-Switch-macOS.zip`（解压即用）
- Windows: `CC-Switch-Setup.msi`（安装版）；`CC-Switch-Windows-Portable.zip`（绿色版）
- Linux: `*.deb`（Debian/Ubuntu 安装包）

### macOS 安装说明
1. 下载 ZIP 文件后解压
2. 由于作者没有苹果开发者账号，首次打开可能出现"未知开发者"警告，请先关闭，然后前往"系统设置" → "隐私与安全性" → 点击"仍要打开"，之后便可以正常打开