v0.1.6: PyPI installation and upgrade documentation

Published on PyPI

Claude Provider Switcher is available by package name. This documentation-only patch replaces the outdated unpublished notice in the PyPI description, adds PyPI badges and installation/upgrade instructions to both READMEs, and records that Trusted Publishing authorization is complete.

No provider switching, credential, configuration schema, or history behavior changes. The APIMaster preset and one-time private key prompt remain unchanged. Existing tags and published files have not been replaced.

Install or upgrade

pipx install claude-provider-switcher
# For an existing PyPI-based pipx installation:
pipx upgrade claude-provider-switcher

In an activated virtual environment or another pip-managed Python environment:

python -m pip install --upgrade claude-provider-switcher
ccs --version

For Ubuntu/Debian system Python's externally-managed-environment protection, use pipx, a virtual environment, Homebrew, or the versioned standalone installer. Do not use --break-system-packages.

To move an existing GitHub-URL pipx installation to PyPI, use pipx install --force claude-provider-switcher once. Reapply ccs use <profile> if the installation location changes so the credential helper points to the correct path.

Homebrew formula: brew install RomaCredit/codex/claude-provider-switcher after brew tap RomaCredit/codex.

Verification

• Local: 127 tests, OK (11 platform-specific or opt-in skips).
• Source/wheel build and twine check: passed.
• Windows/macOS/Linux Python 3.10 and 3.13, build, and tagged-install checks: passed.
• OIDC PyPI publishing: succeeded.
• Clean isolated PyPI installation and pip/pipx upgrade from 0.1.5: both command names report 0.1.6; dependency check passed.
• PyPI package.

Tests use synthetic/local data and loopback, not billable live inference or the user's real history. They do not establish compatibility with every client or gateway.

Full changelog: v0.1.5...v0.1.6

v0.1.5: clearer Claude Code profiles and PyPI publishing

Reworks the overview and quick start around repeatable Claude Code provider profiles, private credentials, settings backups, and conservative history diagnostics. Adds bilingual navigation, issue forms, contribution and citation metadata, and a tag-based PyPI Trusted Publishing workflow. PyPI Trusted Publishing is configured; version 0.1.5 was successfully published after the account owner authorized the publisher.

Full Changelog: v0.1.4...v0.1.5

Install

pipx install https://github.com/RomaCredit/claude-provider-switcher/archive/refs/tags/v0.1.5.zip

brew tap RomaCredit/codex
brew install RomaCredit/codex/claude-provider-switcher

PyPI publication is complete: https://pypi.org/project/claude-provider-switcher/0.1.5/. Install this version in a virtual environment with python -m pip install claude-provider-switcher==0.1.5, or use pipx install claude-provider-switcher==0.1.5. The original authorization error was resolved and the upload rerun succeeded: https://github.com/RomaCredit/claude-provider-switcher/actions/runs/34030865108.

ccs use apimaster retains the one-time private API key prompt. Ordinary switches only inspect history. Explicit repair requires Claude to be stopped. No transcript migration or universal provider compatibility is claimed.

Verification

• Three-OS / two-Python test matrix passed.
• Homebrew macOS/Linux installation and tests passed.
• Source and wheel builds passed twine check; clean-environment installation and both command aliases were verified.
• Tests use local fixtures and do not establish compatibility with every upstream client version or live gateway.