開発ツール

jcode Windows インストール チュートリアル: マルチセッション AI プログラミング、ブラウザ ツール、バックグラウンド モード

Windows での jcode のインストール、TUI、マルチセッションの回復、バックグラウンド サービス、Firefox ブラウザ ツールの構成について紹介します。

jcode は、マルチセッション、低リソース使用量、およびスケーラブルなワークフローに重点を置いて Rust で開発されたターミナル AI プログラミング エージェントです。インタラクティブな TUI、単一の非インタラクティブなタスク、バックグラウンド サービス、および組み込みの Firefox ブラウザ制御ツールをサポートします。

プロジェクトアドレス: 1jehuang/jcode

Windows クイック インストール

Windows 11 および PowerShell 5.1 以降を正式にサポートします。

1

irm https://jcode.sh/install.ps1 | iex

インストール スクリプトは、リモート コード実行の一種です。慎重なユーザーは、通常のユーザー権限でコンテンツを実行する前に、まずコンテンツをダウンロードして確認する必要があります。インストール後、新しいターミナルを開いて次を実行します。

1

jcode

共通コマンド 

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12

# 启动交互式 TUI
jcode

# 执行一次任务
jcode run "say hello"

# 恢复名为 fox 的会话
jcode --resume fox

# 启动后台服务并连接
jcode serve
jcode connect

バックグラウンド モードは、プロセス内のセッションを維持し、他の端末からアクセスする場合に適しています。タスクをディレクトリ、ブランチ、またはその他の分離境界に分割していない限り、複数のセッションで同じリポジトリ内の同じファイルを同時に変更しないでください。

ブラウザツールを設定する

jcode にはブラウザ ツールが組み込まれており、現在の公式アクセスは Firefox Agent Bridge です。まずステータスを確認し、セットアップを実行します。

1
2

jcode browser status
jcode browser setup

完了すると、エージェントはページを開いて、スナップショットを読み取り、クリックして入力し、ファイルをアップロードし、スクリーンショットを撮り、ページ スクリプトを実行できるようになります。最初のテストでは、アカウントなしで公開ページを使用し、ツールの権限とブラウザーのプロファイルを確認してから、ログイン ステータスをタッチします。

複数のセッションでの競合を回避する方法

  1. 各セッションは 1 つの明確なタスクのみを担当します。
  2. 変更前の現在の Git ステータスを記録します。
  3. 2 つのセッションでフォーマットと依存関係の更新を同時に実行しないでください。
  4. データベースの移行、ロック ファイル、共有設定は別のセッションに引き渡されます。
  5. マージする前に git diff を確認します。エージェントの概要のみに依存しないでください。

jcode のメモリ フットプリントは低いため、複数のセッションを簡単に開くことができますが、十分なリソースがあるからといって、ファイルの書き込みが本質的に安全であるとは限りません。同時作業の鍵となるのはやはりタスクの境界です。

インストール前に確認すべきことは何ですか?

jcode は、Windows 上で PowerShell インストール スクリプトを提供します。実行前に確認してください:

  • システムはサポートされているバージョンの Windows です。
  • PowerShell は jcode.sh にアクセスできます。
  • インストール ディレクトリと PATH は、会​​社のポリシーに準拠するように変更されます。
  • Git がインストールされ、プロジェクトで動作している。
  • モデルプロバイダー、認証方法、料金は受け入れられます。
  • セキュリティ ソフトウェアは、ダウンロードされたバイナリをサイレントに隔離しません。

公式ドキュメントに必須と明記されていない限り、管理者端末を使用してインストールすることはお勧めできません。エージェント自体も、通常のユーザー権限で実行しようとします。

TUI、実行、提供のいずれかを選択する方法

インタラクティブ TUI 

1

jcode

プロジェクトの調査、進行中のディスカッション、ツール呼び出しの段階的な承認に最適です。初めて使用する場合は、エージェントの計画とコマンドを観察するのが最も簡単なため、このモードで開始する必要があります。

単一の非対話型タスク 

1

jcode run "summarize the repository structure without editing files"

スクリプトや簡単なクエリに適しています。自動化に使用する場合は、終了コード、標準出力、障害処理の確認が必要です。コマンドがテキストを生成するかどうかだけを判断することはできません。

セッションを復元する 

1

jcode --resume fox

セッション名は覚えやすいですが、回復後に現在の作業ディレクトリと Git のステータスを確認する必要があります。セッションの一時停止中に他の人によってコードが変更された可能性があります。

バックグラウンドサービス 

1
2

jcode serve
jcode connect

Agentプロセスの長期保存や複数端末からのアクセスに適しています。バックグラウンド サービスには、リスニング アドレス、認証、およびセッションの永続性が含まれるため、構成を確認することなく LAN またはパブリック ネットワークに公開すべきではありません。

推奨される単一セッション検証プロセス

  1. テスト リポジトリで jcode を開始します。
  2. 作業ディレクトリと Git ブランチを指定します。
  3. 読み取り専用ディレクトリ分析を実行します。
  4. 文書のタイプミスを修正させます。
  5. 実際の git diff を表示します。
  6. 実行中のプロジェクトはテスト済みです。
  7. ​​KEEP_2 を使用して終了し、復元します。
  8. セッションが最新のファイルのステータスを認識していることを確認します。

これらの手順が安定した後でのみ、バックグラウンドとマルチセッションを使用してください。

マルチセッション分離ソリューション

ディレクトリごとに分割

完全に独立したサブプロジェクトに適しています。セッションごとに書き込むことができる明示的なディレクトリは 1 つだけであり、共有設定はメイン セッションによって処理されます。

Git Worktree で分割

タスクごとに個別のワークツリーとブランチを作成すると、ファイルの対象範囲が減ります。欠点は、依存関係、ビルド キャッシュ、データベースを個別に管理する必要があることです。

読み取り専用の探索セッション

1 つのセッションに検索と計画を担当させ、ファイルへの書き込みを明示的に無効にします。別のセッションが実装を担当します。これにより、2 つの実装セッションで同時にコードが変更される可能性が低くなります。

どの方法を使用するかに関係なく、複数のセッションでロック ファイル、データベースの移行、およびグローバル構成を同時に変更することは許可しないでください。

ブラウザツールの権限の説明

jcode のブラウザ ツールは、ページを開く、コンテンツを読み取る、インタラクティブな要素を見つける、クリック、入力、フォームへの記入、スクリーンショットの撮影、スクリプトのアップロードと実行を実行できます。アクションが異なれば、リスクも異なります。

アクション リスク 推薦
公開ページを開いて読む 低い 最初のテストに使用できます
クリックしてスクロール 中 アクションがコミットされないことを確認します。
フォーム入力 中～高 実際のパスワードとトークンを入力しないでください。
ファイルをアップロードする 高 特殊なテスト ファイルを使用する
ページスクリプトを実行する 高 サイトと目的を限定する
ログインプロファイルを使用する 高 単一プロファイル、最小権限

ブラウザ自動化では、デフォルトで日次プロファイルを使用しないでください。使用しないと、エージェントがメールボックス、クラウド プラットフォーム、ログインしたバックエンドに公開される可能性があります。

Firefox エージェント ブリッジのトラブルシューティング

最初の実行:

1

jcode browser status

ステータスが異常な場合は、再度実行します。

1

jcode browser setup

それでも失敗する場合は、Firefox のバージョン、Bridge のインストール状況、ブラウザが起動しているか、プロファイルが正しいか、セキュリティ ソフトウェアがローカル通信をブロックしていないかを確認してください。 Bridge が接続されていないときに、モデルが繰り返しクリックを試みないようにしてください。

バックグラウンド サービスのセキュリティ境界

jcode serve を使用する前に、リスニング アドレス、ポート、認証方法を確認してください。安全対策には次のものが含まれます。

  • デフォルトでは、ローカル マシンのみが監視されます。
  • ルーターを経由せずにポートを直接転送します。
  • リモート アクセスには制御されたトンネルまたは VPN を使用します。
  • 無関係なクラウド プラットフォーム キーをサービス環境に挿入しないでください。
  • 不要になったセッションを定期的にクリーンアップします。
  • 接続ソースとツール呼び出しをログに記録します。

「バックグラウンド実行」は単なるプロセス形式であり、マルチユーザーサーバーのセキュリティ設計を意味するものではありません。

パフォーマンス データを理解する方法

リポジトリは他の CLI エージェントとのメモリ比較を提供しますが、これらの数値はバージョン、オペレーティング システム、セッション数、機能スイッチによって異なります。評価するときは、自分のプロジェクト内で測定する必要があります。

  1. シングルセッションメモリを解放します。
  2. 10 セッションの合計メモリ。
  3. ローカル埋め込みをオンにした後の変更。
  4. 長時間セッションの起動と回復にかかる時間。
  5. ブラウザツールランタイム用の追加リソース。

メモリが少ないと同時実行性には優れていますが、モデル API のレイテンシ、ツールの安定性、書き込み競合も実際の効率に影響します。

共通故障マトリックス

現象 内容を確認する
インストール スクリプトが失敗しました ネットワーク、実行ポリシー、インストールログ
コマンドが PATH にありません 新しい端末、ユーザーのインストール ディレクトリ
プロバイダー認証に失敗しました キー、API ベース、モデル名、クォータ
古いリカバリ セッションのコンテンツ 現在のディレクトリ、ブランチ、およびファイルの変更
2 つのセッションが相互に上書きする Worktree で境界を書き込む
ブラウザの状態異常 Firefox ブリッジとプロファイル
serve 接続できません サービス プロセス、リスニング アドレス、ポート、ファイアウォール

よくある質問

Windows のインストール後にコマンドが見つかりません

新しいターミナルを開き、PATH をチェックします。スクリプトがユーザー ディレクトリにインストールされている場合は、そのディレクトリが現在のアカウントの環境変数に追加されていることを確認します。

ブラウザの設定は完了しましたが、エージェントをクリックできません

jcode browser status を実行して、Firefox Bridge が接続されていることを確認します。次に、対象のページに許可の確認、ダウンロードウィンドウ、またはログインページがポップアップ表示されるかどうかを確認します。

これは Codex または Claude Code の代替として適していますか?

代替は、モデル、ツール、承認メカニズム、チームのプロセスによって異なります。 jcode の利点はマルチセッションと拡張可能なターミナル フレームワークですが、コードの品質は依然としてモデルとタスクの制約に依存します。

Windows PowerShell 5.1 はインストールできますか?

公式のインストール手順には、PowerShell 5.1 以降がサポートされていることが示されています。企業がスクリプトをブロックするポリシーを適用している場合は、組織の規制に従ってポリシーを確認して署名する必要があり、セキュリティ ポリシーを無効にすることで回避すべきではありません。

jcode run は CI に適していますか?

調査は可能ですが、バージョンを固定し、権限を制限し、終了コードを処理し、信頼できない PR にプロダクション キーを渡さないようにする必要があります。最初に読み取り専用チェック タスクで検証してください。

同じサービスに接続するときに、複数のクライアントがコンテキストを共有しますか?

特定のセッションとクライアントの動作は、現在のドキュメントと実際のテストの対象となる必要があります。クライアントが使用前に自然に分離されているとは想定せず、機密データを含まないテスト セッションで検証してください。

プロバイダー構成を個別に検証する必要があるのはなぜですか?

jcode は Agent Harness であり、最終的な回答の品質とツールの呼び出しは依然としてモデル プロバイダーに依存します。構成後、短いダイアログ、長いファイルの読み取り、構造化ツールの呼び出し、コード編集、エラー回復をそれぞれテストします。 「挨拶」だけで環境全体が利用可能であると判断しないでください。

プロバイダーがカスタム API ベースを使用している場合は、TLS、プロキシ、モデル名、コンテキスト制約、ストリーミング応答も確認してください。チームは、他の運用サービスと無制限に資格情報を共有することを避けるために、jcode に別個のキーとバジェットを使用する必要があります。

ログ、テレメトリ、機密情報

長いセッションには、ソース コード、コマンド出力、Web ページのコンテンツ、エラー ログが含まれる場合があります。バックグラウンドサービスを有効にする前に、セッションの保存場所、保存期間、削除方法を確認してください。ブラウザ ツールによって入力されたフォームの内容も、ログに完全にエコーされるべきではありません。

プライベート リポジトリを扱う場合は、次の点を確認することが重要です。

  • プロバイダーが完全なファイルを受け取るかどうか。
  • ローカル埋め込みが有効かどうか。
  • セッションが外部サービスに同期されているかどうか。
  • クラッシュ レポートにプロンプ​​トの単語とパスが含まれているかどうか。
  • 複数のクライアントが他のセッションを参照できますか。
  • セッションの削除後にディスク ファイルがクリーンアップされるかどうか。

アップグレード前後の回帰ステップ

現在の jcode バージョンと構成を文書化し、アップグレード後に TUI、run、--resume、serve/connect、およびブラウザ ブリッジを再テストします。ツールのアップグレードとモデルの切り替えのトラブルシューティングを同日に行わないでください。そうしないと、変更の原因を特定することが困難になります。

チームが自動スクリプトに依存している場合は、終了コード、出力形式、コマンド パラメーターが変更されているかどうかをさらに確認し、検証済みのバージョンをロックします。

概要

jcode は、ターミナルで複数のエージェント セッションを維持したり、バックグラウンド サービスを使用したり、Firefox を直接制御したりする開発者に適しています。 Windows では、最初にインストールと単一セッションを確認し、次にバックグラウンド モードとブラウザ ツールを徐々に有効にして、Git を介して同時変更を分離します。