インストール
自分で管理できる Python 環境へ QZX をインストール
仮想環境内の pip、または CLI を分離する pipx を使えます。インストール後はバージョンを確認し、読み取り専用診断を一つ実行してください。
60秒で QZX を試す
読み取り専用の ISO タイムスタンプをすばやく取得し、QZX の動作を確認します。
python -m pip install --upgrade qzx
qzx getCurrentDateTime --output-format iso --json
この2つのコマンドをターミナルで実行してください。JSON に success: true と空でない message があれば最初の確認は成功です。コピーだけではインストールも実行もされません。
QZX — Quick Zap Exchange は Alejandro Sánchez が作成・保守しています。
Codex、Claude Code、Gemini CLI 向け QZX — クイックスタートpip を使う
適切な Python 環境の中で PyPI の公開パッケージをインストールします。
python -m pip install --upgrade qzx
qzx version
pipx で CLI を分離
pipx は QZX 専用の環境を作り、実行ファイルを PATH から利用できるようにします。
pipx install qzx
qzx version
最初の実用チェック
まず状態を変更しないコマンドで確認してください。コーディングエージェントなら diagnoseProject が有用な開始点です。
qzx getCurrentDateTime
qzx diagnoseProject .
インストールしたのに qzx が見つからない場合
インストール方法に合った手順を選んでください。起動コマンドが見つからなくても、パッケージ自体はインストールされている場合があります。
pip でインストールした場合:同じ Python から実行
インストール時と同じ Python(python、python3、py -3.13 など)を使います。
python -m qzx version --json
python -m qzx getCurrentDateTime --output-format iso --json
python -m pip install --upgrade qzx を実行したものと同じインタープリターを使ってください。モジュールとして実行すれば、PATH 上に qzx の起動コマンドがなくても利用できます。
python3 または py -3.13 でインストールした場合は、以下のすべてのコマンドの python を同じプレフィックスに置き換えてください。途中でインタープリターを切り替えないでください。
No module named qzx または想定外のバージョンが表示される場合
再インストールする前に、使用中のインタープリターを確認します。QZX をインストールした環境を有効にして、pip とパッケージの場所を調べてください。
python -m pip --version
python -m pip show qzx
ここで pip が QZX を見つけられなければ、このインタープリターにはパッケージがありません。qzx version --json とモジュール実行でバージョンが異なる場合は、別々のインストールを参照しています。使用する方だけを更新してください。externally-managed-environment が出た場合は、管理対象の Python を強制変更せず、自分で管理する環境か pipx を使います。
pipx でインストールした場合:起動コマンドを復旧
まず pipx list を実行します。QZX が一覧にあれば pipx ensurepath を実行し、案内に従ってターミナルを開き直すか環境を再読み込みした後、qzx version --json を試してください。一覧になければ、上の pipx によるインストール手順を使います。
通常、システムの Python から pipx の隔離環境内のパッケージはインポートできません。python -m qzx は pipx の修復手順ではありません。pipx run が試すのは一時環境であり、既存のインストールではありません。
確認できたら自分のプロジェクトのフォルダーを開き、pip で使ったインタープリターなら python -m qzx diagnoseProject .、pipx の起動コマンドなら qzx diagnoseProject . を試してください。QZX はプロジェクトを調査しますが、そのテストやビルドスクリプトは実行しません。
診断結果を共有する前に、個人用パス、認証情報、非公開プロジェクトの情報を取り除いてください。