メインコンテンツへ移動

インストール

自分で管理できる Python 環境へ QZX をインストール

仮想環境内の pip、または CLI を分離する pipx を使えます。インストール後はバージョンを確認し、読み取り専用診断を一つ実行してください。

インストール済みでも qzx が起動しませんか?

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 はプロジェクトを調査しますが、そのテストやビルドスクリプトは実行しません。

解決しない場合はインストールの相談へ

診断結果を共有する前に、個人用パス、認証情報、非公開プロジェクトの情報を取り除いてください。