ドキュメントの目次02 / 16

はじめに02 / 16

インストールと準備

このページの内容

まず Noea デスクトップアプリをインストールし、少なくとも一つのコーディング Agent を準備します。インストール、ログイン、接続の検証はアプリが案内します。

インストーラを選ぶ

Noea のダウンロード欄で、OS とプロセッサに合う版を選びます。

システム選び方
macOSApple silicon、macOS 13 以降。Intel Mac 用インストーラは現在提供していません。
WindowsIntel / AMD は x64、Windows on ARM デバイスは ARM64。
Linuxプロセッサに合わせて x86_64 または ARM64。AppImage と .deb を提供しています。

macOS はディスクイメージを開いてインストールします。Windows はインストーラを実行します。現在のユーザー向けにインストールされ、管理者権限は不要です。Linux はディストリビューションに応じて AppImage または .deb を使います。

最初の Agent を準備する

Noea 起動時に準備完了の Agent がない場合、セットアップガイドが開きます。

  1. 一覧で Agent を選び、インストールをクリックします。
  2. ダウンロードを待ち、詳細パネルに従ってログインしてアクセスを許可します。
  3. Noea が接続を検証するのを待ちます。準備完了だけが検証合格を意味します。
  4. Noea の使用を開始する項目を選び、ワークベンチに進みます。

現在、Codex、Claude Code、OpenCode、CodeBuddy Code に対応しています。開始時は一つで十分です。後から設定 → エージェントで追加できます。

必要なランタイムは Noea がダウンロードするため、事前に Node.js をインストールする必要はありません。ダウンロードと準備の進行状況はアプリ内に表示されます。

Agent に応じた方法でログインする

ログインではブラウザ、アプリ内ターミナル、システムのターミナルが開く場合や、API キーの入力を求められる場合があります。選んだ Agent の案内に従ってください。

Codex は macOS と Windows ではブラウザ、Linux ではデバイスコードによるログインを優先します。OpenCode はモデルプロバイダーに接続して設定します。アカウント、API キー、カスタムエンドポイントはAgent、モデル、使用量をご覧ください。

ログイン後、Noea は再度接続を検証します。ログイン要求や失敗が続く場合は、Agent の詳細パネルで理由を確認します。

別のターミナルツールで Agent を使っていても、ここで使用可能かどうかは Noea の一覧の状態で判断してください。

ダウンロードや検証の問題を解決する

ダウンロードと Agent のリクエストはシステムの HTTP(S) プロキシ設定を使います。プロキシ環境変数がある場合はそちらが優先されます。この仕組みは SOCKS プロキシには対応していません。

ダウンロードが失敗したらネットワークとプロキシを確認し、同じ場所から再試行します。データ受信が短時間止まった際の準備中表示は、必ずしも失敗ではありません。

インストール後の検証が失敗したら、詳細パネルで再ログイン、プロバイダー設定の修正、ネットワーク問題の解決を行います。相談時は診断情報をコピーできます。トラブルシューティングをご覧ください。

プロジェクトを開く

ワークベンチでフォルダを開く…を選び、コードのフォルダを指定します。Noea はリンクされたプロジェクトを開くか作成します。最初のチュートリアルに完全な要件書、MCP サーバー、Skills は不要です。

最初のワークフローに進みましょう。