Skip to content

About

macOS version manager for Claude Code and OpenAI Codex CLI

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

21 Commits

Folders and files

Repository files navigation

Claude Codex Version Manager

cvm 是面向 macOS、Linux 与 Windows bash 环境的 Claude Code 与 OpenAI Codex CLI 版本管理工具。

它可以复用已有的 CVM 安装、npm/npx 缓存、全局 npm 安装以及 macOS 上的 Homebrew Codex,只有本地不存在目标版本时才联网下载。

要求

  • macOS、Linux,或 Windows 的 Git Bash/MSYS2/Cygwin
  • bash 或 zsh
  • Node.js 与 npm
  • curl

安装

bash <(curl -fsSL https://raw.githubusercontent.com/DoBestone/claude-codex-version-manager/main/install.sh)
source ~/.cvm/cvm.sh

安装器可以重复执行。升级时仅替换 ~/.cvm/cvm.sh,不会删除已安装版本、 收藏或缓存导入结果。默认会按当前 shell 写入 ~/.zshrc、~/.bashrc 或 ~/.profile;也可以通过 CVM_SHELL_RC=/path/to/rc bash install.sh 指定。

以 root 运行时默认启用全局安装:管理脚本写入 /usr/local/share/cvm/cvm.sh, 固定命令包装器写入 /usr/local/bin,并通过 /etc/profile.d/cvm.sh 为新 shell 加载动态版本命令。普通用户也可以显式执行:

bash install.sh --global

全局包装器支持 cvm、claude-v-l、claude-v、codex-v 等固定命令。 安装器还会尽量从 npm 读取已发布版本,并生成 claude-2.1.175、 claude-auto-2.1.175、codex-0.139.0 这类版本化全局命令。若安装时无法 读取 npm 版本列表,仍可使用等价命令 claude-v 2.1.175 或 codex-v 0.139.0。

本地克隆安装:

git clone https://github.com/DoBestone/claude-codex-version-manager.git
cd claude-codex-version-manager
bash install.sh
source ~/.cvm/cvm.sh

Windows 需在 Git Bash、MSYS2 或 Cygwin 中运行上述命令。当前不提供原生 PowerShell 安装器。

Claude Code

claude-2.1.177        # 安装或复用后运行指定版本
claude-v 2.1.177      # 同上
claude-l-a            # 本地可用版本
claude-l-l            # 版本及发布时间
claude-l-r 2.1.177    # 卸载指定版本
claude-install 2.1.177 # 只安装指定版本
claude-current        # 当前系统版本
claude-uninstall 2.1.177
claude-remove 2.1.177 # uninstall 的别名
claude-auto           # 当前版本免权限确认运行
claude-auto-2.1.177   # 指定版本免权限确认运行
claude-latest         # 临时运行 npm 最新版
claude-versions       # npm 全部版本
claude-update         # 更新全局 Claude Code
claude-detect         # 检测 Claude Code 安装来源
claude-config         # 读取 Claude Code 配置文件信息(敏感字段脱敏)

claude-v-a、claude-v-l、claude-v-r 保留为兼容别名。

Codex

codex-0.139.0         # 安装或复用后运行指定版本
codex-v 0.139.0       # 同上
codex-l-a             # 本地可用版本
codex-l-l             # 版本及发布时间
codex-l-r 0.139.0     # 卸载 CVM 副本和 npx 缓存
codex-install 0.139.0 # 只安装指定版本
codex-current         # 当前系统版本
codex-uninstall 0.139.0
codex-remove 0.139.0  # uninstall 的别名
codex-auto            # 当前版本跳过审批与沙箱运行
codex-auto-0.139.0    # 指定版本跳过审批与沙箱运行
codex-latest          # 临时运行 npm 最新版
codex-versions        # npm 全部版本
codex-update          # 按当前来源使用 Homebrew(macOS) 或 npm 更新
codex-detect          # 检测 Codex 安装来源
codex-config          # 读取 Codex 配置文件信息(敏感字段脱敏)

codex-v-a、codex-v-l、codex-v-r 保留为兼容别名。

Codex 的卸载不会删除 Homebrew 或 npm 的系统安装,只清理 CVM 副本与匹配的 npx 缓存。

claude-auto* 和 codex-auto* 会关闭对应 CLI 的安全确认,仅应在可信目录 和明确了解命令影响时使用。Codex 原生命令继续直接使用,例如 codex exec、codex review、codex resume、codex mcp 和 codex plugin。

CVM 子命令

cvm                                      # 打开交互式菜单
cvm menu                                 # 同上
cvm help                                 # 显示命令帮助
cvm doctor
cvm installed
cvm use 2.1.177
cvm install 2.1.177
cvm uninstall 2.1.177
cvm detect [claude|codex]
cvm config [claude|codex]                 # 默认脱敏显示
cvm config [claude|codex] --show-secrets  # 显示认证/API 原始值
cvm config set claude api-url https://api.example.com
cvm config set claude api-key sk-ant-...
cvm config set claude model claude-opus-4-7
cvm config clear claude api-url
cvm reset [claude|codex|all]              # 清除全部第三方覆盖变量,恢复官方订阅/登录状态
cvm profile list [claude|codex]
cvm profile add claude work https://api.example.com sk-ant-... claude-opus-4-7 socks5://127.0.0.1:7890
cvm profile use claude work
cvm profile delete claude work
cvm self-update

cvm codex installed
cvm codex use 0.139.0
cvm codex install 0.139.0
cvm codex uninstall 0.139.0

数据目录

~/.cvm/
├── cvm.sh
├── env
├── profiles.json
├── pins
├── versions/
└── codex-versions/

profiles.json 保存多套模型/API 配置;env 保存当前生效配置。使用 cvm menu 可以创建、编辑、删除、切换 Claude 或 Codex 配置,列表会显示编号, 编辑、删除和切换都按编号选择。每套配置包含名称、API URL、API Key、模型和 可选代理(http://... 或 socks5://...)。

卸载

保留已安装版本数据:

bash uninstall.sh

彻底删除:

bash uninstall.sh --purge

开发验证

bash tests/smoke.sh
shellcheck install.sh uninstall.sh tests/smoke.sh

说明

本项目不是 Anthropic 或 OpenAI 官方项目。Claude Code、Codex 及相关名称 归各自权利方所有。

About

macOS version manager for Claude Code and OpenAI Codex CLI

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages