はじめに
Open Codexは、開発者向けに設計されたオープンソースのコマンドラインAIツールで、自然言語命令を正確なシェルコマンドに変換します。ネイティブ言語モデル(例:phi-4-mini)を使用し、ネットワークやAPIキーを必要とせず、すべての操作はローカルで実行されます。ユーザーは簡単な記述でシェルコマンドやコードを生成できるので、素早いプログラミング作業に適している。このプロジェクトはGitHubでホストされており、インストールが簡単で、macOS、Linux、Windowsをサポートしている。open Codexはセキュリティを重視しており、システムを保護するためにコマンドを実行する前にユーザーの確認が必要である。
機能一覧
- 自然言語からシェルコマンドへユーザーからの自然言語入力を実行可能なシェルコマンドに変換します。
- ローカルモデルの実行phi-4-miniのような、インターネットに接続することなく、プライバシーを保護したローカルモデルをサポートします。
- コード生成記述に基づいて複数のプログラミング言語でコードスニペットを生成します。
- 注文確認の仕組み悪用防止のため、コマンド生成後にユーザー確認が必要です。
- 運営経緯コマンド履歴を保存し、ビューと部分的なアンドゥ機能をサポートします。
- プラグイン拡張機能開発者によるプラグインのカスタマイズをサポートし、ツールの機能を拡張。
- クロスプラットフォーム対応macOS、Linux、Windowsに対応し、複数の端末に適しています。
ヘルプの使用
設置プロセス
Open Codexは、さまざまなオペレーティングシステムやユーザーの習慣に合わせて複数のインストール方法をサポートしています。以下は、素早く始めるための詳細な手順です。
Homebrew経由でのインストール(macOS/Linux)
- Open CodexのHomebrewソースを追加:
brew tap codingmoh/open-codex
- インストールツール:
brew install open-codex
- インストールを確認し、バージョンをチェックする:
open-codex --version
pipxによるインストール(クロスプラットフォーム)
- Python(3.8以上)とpipxがインストールされていることを確認してください。
- Open Codexをグローバルにインストールする:
pipx install open-codex
- インストールを確認する:
open-codex --version
ソースコードによるインストール
- GitHubリポジトリをクローンする:
git clone https://github.com/codingmoh/open-codex.git
- プロジェクト・カタログにアクセスする:
cd open-codex
- 依存関係をインストールします:
pip install .
- インストールを確認する:
open-codex --version
基本的な使い方
インストール後、Open Codexはコマンドラインから起動できます。以下はコア機能の操作方法です。
自然言語からシェルコマンドへ
Open Codexの中核機能は、自然言語をシェルコマンドに変換することである。その手順は以下の通りである:
- ターミナルで自然言語コマンドを入力する:
open-codex "列出当前目录下所有Python文件"
- ツールを使って対応するシェルコマンドを生成することができる:
ls *.py
- システムはユーザーに選択を促す:
y
コマンドを実行する。c
コマンドをクリップボードにコピーする。n
操作をキャンセルします。
- オプション
y
コマンドはローカルで実行され、結果を表示する。.py
ドキュメンテーション
複雑なシェルコマンドの生成
複雑なタスクの場合、Open Codexは複数ステップのコマンドを生成することもできます。例えば
- インプット:
open-codex "查找所有txt文件并统计行数"
- ツールが生成されるかもしれない:
find . -name "*.txt" -exec wc -l {} \;
- ユーザーが確認すると、コマンドが実行され、各txtファイルの行数と合計数が表示される。
コードの生成
シェルコマンドに加えて、Open Codexはコード生成もサポートしている:
- インプット:
open-codex "用 Bash 写一个备份文件夹的脚本"
- ツールはコードを返す:
#!/bin/bash tar -czf backup_$(date +%F).tar.gz /path/to/folder
- ユーザーが選択可能:
- ファイルに保存: Enter
open-codex --save backup.sh
. - クリップボードにコピー:選択
c
. - 直接実行:選択
y
(スクリプトが実行可能であることを確認する必要がある)。
- ファイルに保存: Enter
履歴を見る
- 生成・実行されたコマンドの履歴を見る:
open-codex --history
- 履歴は時間順にソートされ、コマンドと実行状況が表示される。
- 元に戻す操作(サポートされている場合):
open-codex --undo
カスタムモデル
Open Codexはデフォルトでφ4-miniモデルを使用しています。段階的にモデルを切り替える
- 設定ファイルを編集する。
~/.open-codex/config.yaml
):model: phi-4-mini
- 修正
model
のフィールドは、その他のサポートされているローカルモデルである。 - 保存し、ターミナルを再起動すると、スイッチが有効になります。
注目の機能操作
セキュリティ確認メカニズム
悪用を防ぐため、すべてのコマンドは実行前にユーザーの確認を必要とする:
- 自然言語のコマンドを入力すると、ツールはコマンドの候補を表示する。
- ユーザーには以下のものが提供される。
y
(実施)、c
(複製)またはn
(キャンセル)セレクション - オプション
y
コマンドがサンドボックス環境で実行されると、システムの安全性が確保される。
ローカル・オペレーションがプライバシーを保証
Open Codexはローカルで動作し、インターネット接続を必要としません。ユーザーデータや生成されたコンテンツはクラウドにアップロードされないため、プライバシーが強く求められるシナリオに適しています。例えば
- オフライン環境でコマンドやコードを生成。
- 機密性の高いプロジェクトを扱う際には、データ漏洩を避ける。
プラグイン拡張機能
開発者はプラグインの拡張機能を作成できる:
- プロジェクトのルート・ディレクトリに
plugins
フォルダー - ドキュメントに従ってプラグインを記述する(GitHubのリポジトリで
CONTRIBUTING.md
). - Open Codexを再起動すると、プラグインが自動的にロードされます。
ほら
- Python 3.8以上がインストールされていることを確認してください。
- Homebrewやpipxのインストールには安定したネットワークが必要です。
- ソースコードのインストールは手動で更新する必要があり、定期的に実行することを推奨する。
git pull
. - このツールは開発段階にあり、未完成の機能があるかもしれないので、GitHub Issuesに目を通すことをお勧めする。
- 複雑なコマンドの生成はモデルの能力によって制限されることがあり、ユーザーはコマンドの精度をチェックする必要がある。
アプリケーションシナリオ
- クイック・コマンド生成
開発者は、特定のシェルコマンド(例えば、unzip tar.gz)を忘れて、次のようにタイプする。open-codex "解压 tar.gz 文件"
取得tar -xzf file.tar.gz
そして実行に移す。 - オフライン開発
開発者はOpen Codexを使用して、ネットワークレスの環境でシェルスクリプトやPythonコードを生成し、プロジェクトのプライバシーを保護します。 - システム管理
管理者の入力open-codex "查找占用磁盘空间最大的文件"
取得du -ah | sort -rh | head
問題を素早く特定する。 - シェルスクリプトを学ぶ
初心者の入力open-codex "用 Bash 写一个监控CPU的脚本"
サンプルコードを入手し、スクリプトを学ぶ。 - 地域開発
開発者は、新しいモデルのサポートの追加やコマンド生成ロジックの最適化など、GitHubを通じて新機能を提供する。
品質保証
- シェルコマンドに対する自然言語の精度は?
phi-4-miniは一般的なタスクを処理することができ、複雑なコマンドでは、生成された結果を確認することをお勧めします。 - 他のターミナルコマンドはサポートされていますか?
主なサポートはシェルコマンド(bash/zsh)で、将来的にはPowerShellなどにも拡張される可能性がある。詳細はGitHubのロードマップを参照のこと。 - Generate Errorコマンドはどのように処理すればよいですか?
コマンドをチェックした後n
執行の取消し、またはopen-codex --history
履歴を確認し、必要であれば取り消す。 - 多言語入力に対応していますか?
現在、中国語と英語の入力に最適化されているが、他の言語ではより正確な説明が必要になる場合がある。 - 問題点をフィードバックするにはどうすればよいですか?
GitHub リポジトリ (https://github.com/codingmoh/open-codex) にアクセスして、Issue や Pull Request を提出してください。