iCode Agent · FAQ

よくある質問にお答えします。

iCode Agent のインストール方法は?

Node.js 22 以降をインストールし、npm install -g @icodehq/icode-agent を実行してください。詳しくははじめにをご覧ください。

iCode Workbench と iCode Agent はどう違いますか?

iCode Workbench(pre-1.0)はデスクトップ ADE です。Claude Code、Codex、OpenCode を並列で実行し、それぞれが独自の Git ワークツリーを持ち、タスク、レビュー、プロジェクト横断の Mira を備えます。iCode Agent は、この FAQ で説明しているターミナルに特化したエージェントです。別々の製品で、どちらも単独で動作します。

Agent を使うには Workbench が必要ですか?

いいえ。iCode Agent は単独の CLI で、npm でインストールし、任意のリポジトリで実行できます。現在の Workbench は iCode Agent をラップしたり起動したりしません。

どのモデルを使えますか?

iCode Agent は openai と anthropic プロトコルに対応しているため、公式 API とも互換エンドポイントとも連携できます。/model で設定してください。

Bun は必要ですか?

いいえ。Bun は iCode Agent 自体を開発するためのランタイムです。公開パッケージは Node.js 22 以降で動作します。

検証済みのプラットフォームは?

Windows、macOS、Linux 向けのクロスプラットフォーム対応は実装済みです。自動検証は Linux で行われており、Windows と macOS のネイティブ検証はまだ実施されていません。

iCode Agent はコードをアップロードしますか?

ローカルで動作し、指定した API キーを使って、設定したモデルエンドポイントとのみ通信します。ソースは、実行するタスクのコンテキストとしてそのエンドポイントに送信され、プロバイダー自身のデータポリシーが適用されます。

実行にはいくらかかりますか?

iCode Agent 自体は無料のオープンソース(Apache-2.0)です。支払うのは、使用したトークンに対するモデルプロバイダーへの費用だけです。iCode Agent は、長いタスクでその費用を抑えるように設計されています。

iCode Agent はどうやってトークン使用量を抑えますか?

コンテキストはあらゆる境界で管理されます。出力は生成時に上限が設けられ、古いツール結果はリクエストが予算を超える場合にのみ削減され、あふれた履歴は最近の末尾を残して要約されます。詳しくはコンテキストの管理方法をご覧ください。

コンテキストを削減すると情報は失われますか?

省略された結果は、完全な出力がまだ存在する場所を示すマーカーに置き換わるため、エージェントはそれを読み戻せます。失敗の証拠とエラーは決して省略されず、削減は送信されるリクエストだけを変えます。保存されたセッションにはすべての結果が残ります。

作業はどこに保存されますか?

セッションは設定ディレクトリ(~/.icode-agent/)に自動保存されます。最新のセッションは --continue、特定のセッションは --resume <id> で再開するか、/session で管理できます。

どのエージェントやエディターと連携しますか?

iCode Agent は独立したターミナルエージェントです。ほかのエージェント経由ではなく、直接使います。その設定とセッションを読むのは CLI と TUI だけです。

本番環境で使えますか?

iCode Agent は初期の実験的開発段階にあり、急速に変化しています。各リリースの内容は変更履歴をご覧ください。