Blog スタッフブログ

Python システム開発 ひとくちコードスニペット

[Codex]PythonからCodex CLIを実行するコードスニペット

こんにちは、株式会社MIXシステム開発担当のBloomです。

今回は前回の記事でWindows環境に導入したCodex CLIを、Pythonで作成したアプリケーションから実行する方法について紹介します。

Codex CLIはターミナルから対話形式で利用するだけでなく、Pythonなどの外部プログラムから呼び出すことも可能です。

これを利用すれば、Pythonで作成したWindowsアプリケーションにAIによるファイル解析や自動処理などの機能を組み込むことができます。

Codex CLIの非対話モード

通常、Codex CLIは以下のコマンドで起動します。

codex

この場合は対話モードで起動しますが、外部プログラムから実行する場合はexecオプションを利用します。

codex exec "Pythonの特徴を簡単に説明してください"

これにより指定した指示をCodexに実行させ、処理が完了すると自動的に終了します。

PythonからCodex CLIを実行する

Pythonから外部コマンドを実行するには標準ライブラリのsubprocessを利用します。

以下はCodexへ指示を送信し、回答を受け取るコードスニペットです。

import subprocess
import shutil

codex = shutil.which("codex")

if codex is None:
    raise RuntimeError("Codex CLIが見つかりません")

result = subprocess.run(
    [
        codex,
        "exec",
        "--sandbox", "read-only",
        "Pythonの特徴を簡単に説明してください"
    ],
    capture_output=True,
    text=True,
    encoding="utf-8",
    errors="replace",
    timeout=180
)

if result.returncode == 0:
    print(result.stdout)
else:
    print(result.stderr)

これだけでPythonからCodex CLIを起動し結果を取得することができます。

Codexの回答だけを取得する

先ほどの方法では標準出力に実行情報などが含まれます。回答のみを取得したい場合は--output-last-messageのコマンドを利用してみましょう。

import subprocess
import tempfile
from pathlib import Path

with tempfile.TemporaryDirectory() as tmp:
    output = Path(tmp) / "result.txt"

    result = subprocess.run(
        [
            codex,
            "exec",
            "--sandbox", "read-only",
            "--output-last-message", str(output),
            "Pythonの特徴を簡単に説明してください"
        ],
        capture_output=True,
        text=True,
        encoding="utf-8",
        errors="replace",
        timeout=180
    )

    if result.returncode == 0 and output.exists():
        print(output.read_text(encoding="utf-8"))
    else:
        print(result.stderr)

これによりCodexの最終回答のみをファイル経由で取得できます。

注意点

PythonからCodexを起動する場合でも事前にCodex CLI側でログイン認証を済ませておく必要があります。

自分で利用するぶんには特段問題ありませんが、開発したアプリケーションを他人に利用させる場合はCodex CLIの導入手順まで含めてのサポートが必要になるため注意しましょう。

また、今回の例ではCodexの権限を読み取り専用に制限していますが、ファイルの編集などを行わせる場合は適切な権限設定と実行対象ディレクトリの管理が必要になります。

これだけでPythonからCodex CLIを利用できるようになりました。良かったですね。