iCode Agent · はじめに

iCode Agent をインストールします。

1 つのパッケージを 1 回インストールするだけ。iCode Agent は Node.js 22 以降で、Windows、macOS、Linux 上で動作します。

このガイドではターミナルエージェントを扱います。デスクトップ環境についてはiCode Workbenchをご覧ください。

1. インストール

グローバルにインストールし、任意のプロジェクトで実行します。

npm install -g @icodehq/icode-agent
cd ~/my-project
icode-agent

インストールしたくない場合は、npx @icodehq/icode-agent で一度だけ実行できます。

2. モデルを設定する

初回起動時、iCode Agent はワークスペースを開く前にモデルを設定します。openai と anthropic プロトコルに対応しているため、公式 API とも互換エンドポイントとも連携できます。

  • 既存の設定を選ぶか、新しく追加します。プロトコル、エンドポイント、モデル名、API キーです。
  • 保存される前に、実際の接続テストに合格する必要があります。
  • 設定は ~/.icode-agent/models.json にローカル保存されます。

モデルは /model または Ctrl+P でいつでも切り替えられます。

3. タスクを渡す

タスクを自然な言葉で入力し、Enter を押します。

Fix the failing tests in this repository.

iCode Agent はコードを調べ、変更を加え、あなたのコマンドを実行し、自身の作業を検証します。ライブで見守り、いつでも方向を指示できます。

非対話での使用

スクリプトと CI 向け:

icode-agent -p "run the tests and report failures"   # print the final response
icode-agent --mode json -p "find TODO comments"      # stream events as JSON lines
icode-agent -c -p "now fix what you found"           # continue the last session

トラブルシューティング

  • ワークスペースが開かない — まだモデルが有効になっていません。セットアップを完了するか、~/.icode-agent/models.json を直接作成してください。
  • コマンドがすぐに失敗する — Windows では既定で PowerShell でコマンドが実行されます。CMD を使うには設定で "shell": "cmd" を指定してください。
  • 長いタスクが遅くなる — iCode Agent はリクエストを抑えるため古いコンテキストを要約します。実行すると通知します。

クロスプラットフォーム対応は実装済みです。自動検証は Linux で行われており、Windows と macOS のネイティブ検証は保留中です。

解決しない場合は、Issue を作成してください。