始める前に
- macOS、Windows、Linux のいずれかを搭載したパソコンが必要です。
- Shisa AI アカウントが必要です。設定中に作成または接続できます。
- 最初は実験してもよいフォルダを使ってください。大切な作業はバックアップまたは Git で管理してください。
1. ターミナルとは？
ターミナルは、文字でパソコンへ指示するアプリです。コマンドを入力し、Enter キーを押します。Jouzu はターミナルの中で動きます。コマンドを暗記する必要はありません。このガイドに入力する文字をそのまま載せています。
開き方
macOS
- 1.Command + Space を押します。
- 2.「ターミナル」と入力します。
- 3.Enter を押します。
Windows
- 1.スタートメニューを開きます。
- 2.「Windows Terminal」と入力します。
- 3.Windows Terminal または PowerShell を選びます。
Linux
- 1.アプリ一覧で「Terminal」または「端末」を検索します。
- 2.多くのデスクトップでは Ctrl + Alt + T でも開けます。
2. Jouzu をインストール
お使いのパソコンを選択
先に Node.js 22.19 以降、Git、Bash をインストールし、ターミナルで次のコマンドを実行します： Node.js をダウンロード
npm install -g jouzuインストールが終わったら、Jouzu が使えることを確認します：
jz --versionJouzu と Pi のバージョン情報が表示されれば完了です。
3. プロジェクトフォルダを開く
Jouzu は、起動したフォルダ内のファイルを読み書きできます。cd コマンドでターミナルをフォルダへ移動します。例のパスは自分のフォルダに置き換えてください。
cd ~/Documents/my-project続けて Jouzu を起動します：
jzProject trust
4. Shisa AI アカウントを接続
Jouzu の中で次のコマンドを入力し、Enter を押します。ブラウザが開くので、ログインして接続を許可し、ターミナルへ戻ります。
/login shisaブラウザに接続成功と表示されたら、Jouzu が Shisa のモデルカタログを更新します。
5. モデルを選ぶ
モデル選択画面を開き、Shisa のモデルを選んで Enter を押します。迷った場合は Jouzu が表示する既定のモデルを選んでください。
/model/status/status を使うと、現在のモデルとフォルダをいつでも確認できます。
6. 最初のタスクを完了する
最初は、結果を確認しやすい小さな依頼にします。やりたいこと、対象のファイルや場所、完了の判断方法を伝えます。
最初のプロンプト例
このプロジェクトを、ファイルを変更せずに読んでください。何をするプロジェクトか、主なフォルダ、既存テストの実行方法を説明してください。次の依頼例
見つけたテストコマンドを README に追記してください。編集する前に変更案を見せてください。受け入れる前に確認
7. よく使うコマンド
/status | 現在のフォルダ、モデル、コンテキスト使用量を表示。 |
|---|---|
/model | モデルを選択。 |
/settings | 言語、アカウント、カタログなどを設定。 |
/hotkeys | このターミナルで有効なショートカットを表示。 |
/voice | 音声入力を開始または停止。 |
/scrollback | 会話をターミナルへ出力して検索可能に。 |
/bug | 確認してから送信できる公開 Issue の下書きを作成。 |
/quit | Jouzu を終了。 |
8. トラブルシューティング
jz: command not found
インストール後にターミナルを閉じて開き直し、jz --version を実行します。解決しない場合は再インストールするか、npm のグローバル bin フォルダが PATH にあるか確認します。
ブラウザでログインした後、Jouzu に戻らない
接続許可後にターミナルへ戻ります。時間切れの場合は /login shisa を再実行します。リモート環境ではターミナルに表示される手動 URL またはコードを使います。
Shisa のモデルが表示されない
/catalogs で Shisa カタログを更新します。/logout shisa の後に /login shisa を実行する方法もあります。
Jouzu が待機中、または自動作業が止まった
/flow を実行します。保留リクエスト、待機、一時停止中の作業と、解除に必要な操作が表示されます。
音声入力が使えない
音声入力にはリアルタイム音声認識を利用できる Shisa アカウントが必要です。/login shisa の後、/voice devices でマイクを確認します。
Windows インストーラーがブロックされた
Windows に表示される発行元が Shisa Inc. であることを確認し、公開 SHA-256 チェックサムと照合します。発行元が一致しない警告は回避しないでください。
Jouzu の外で次を実行すると、設定を変更せず診断できます：
jz doctor