日本語

Linear で Codex を使用する

Linear の issue から Codex タスクを実行します

Linear で Codex を使用すると、issue から作業を委任できます。issue を Codex に割り当てるか、コメントで @Codex をメンションすると、Codex がクラウドチャットを作成し、進捗と結果を返信します。

Linear の Codex は有料プランで利用できます(料金を参照)。

Enterprise プランを利用している場合は、ChatGPT ワークスペース管理者に依頼して、ワークスペース設定で Codex クラウドチャットをオンにし、コネクター設定Codex for Linear を有効にしてください。

Linear 連携を設定する

  1. Codex で GitHub に接続し、Codex に作業させるリポジトリの環境を作成して、Codex クラウドチャットを設定します。
  2. Codex の設定に移動し、ワークスペースに Codex for Linear をインストールします。
  3. Linear の issue にあるコメントスレッドで @Codex をメンションし、Linear アカウントをリンクします。

Codex に作業を委任する

委任する方法は 2 つあります。

issue を Codex に割り当てる

連携機能をインストールすると、チームメンバーに割り当てる場合と同じ方法で issue を Codex に割り当てられます。Codex は作業を開始し、進捗を issue に投稿します。

Linear の issue を Codex に割り当てる(ライトモード)

コメントで @Codex をメンションする

コメントスレッドで @Codex をメンションして、作業を委任したり質問したりすることもできます。Codex が返信した後、同じチャットを続けるにはスレッドで追加のコメントを送信します。

Linear の issue コメントで Codex をメンションする(ライトモード)

Codex は issue の作業を開始すると、作業に使用する環境とリポジトリを選択します。特定のリポジトリを固定するには、コメントにリポジトリを含めます。例:@Codex fix this in openai/codex

進捗を確認するには、次の操作を行います。

  • issue の Activity を開いて、進捗の更新を確認します。
  • チャットのリンクを開き、詳細な進行状況を確認します。

Codex は完了すると、pull request を作成できるように、要約と完了したチャットへのリンクを投稿します。

Codex が環境とリポジトリを選択する仕組み

  • Linear は、issue のコンテキストに基づいてリポジトリを提案します。Codex は、その提案に最も適した環境を選択します。リクエストが曖昧な場合は、直近で使用した環境を使用します。
  • チャットは、その環境のリポジトリマップに最初に記載されたリポジトリのデフォルトブランチを対象に実行されます。別のデフォルトや追加のリポジトリが必要な場合は、Codex でリポジトリマップを更新してください。
  • 適切な環境またはリポジトリがない場合、Codex は再試行前に問題を解決する方法を Linear で返信します。

issue を Codex に自動的に割り当てる

トリアージ規則を使用して、issue を Codex に自動的に割り当てられます。

  1. Linear で Settings に移動します。
  2. Your teams でチームを選択します。
  3. ワークフロー設定で Triage を開き、オンにします。
  4. Triage rules で規則を作成し、Delegate > Codex(および設定したいその他のプロパティ)を選択します。

トリアージに入った新しい issue は、Linear によって自動的に Codex へ割り当てられます。トリアージ規則を使用する場合、Codex は issue 作成者のアカウントを使用してチャットを実行します。

すべてを Codex に割り当て、「Triage」ステータスのラベルを付けるトリアージ規則の例(ライトモード)

データの使用、プライバシー、セキュリティ

@Codex をメンションするか issue を割り当てると、Codex はリクエストを理解してチャットを作成するために、issue の内容を受け取ります。データの取り扱いには、OpenAI のプライバシーポリシー利用規約、およびその他の適用されるポリシーが適用されます。セキュリティの詳細については、Codex のセキュリティドキュメントを参照してください。

Codex が使用する大規模言語モデルは、誤りを生じる場合があります。回答と差分は必ず確認してください。

ヒントとトラブルシューティング

  • 接続がない:Codex が Linear への接続を確認できない場合、アカウント接続用のリンクを issue に返信します。
  • 意図しない環境が選択された:希望する環境をスレッドで返信します(例:@Codex please run this in openai/codex)。
  • コードの誤った部分が対象になっている:issue にコンテキストを追加するか、@Codex コメントで明確な指示を与えます。
  • その他のヘルプOpenAI ヘルプセンターを参照してください。

ローカル作業用に Linear を接続する(MCP)

ChatGPT デスクトップアプリ、Codex CLI、または IDE 拡張機能を使用しており、ローカルから Linear の issue にアクセスさせたい場合は、Linear Model Context Protocol(MCP)server を設定します。

詳細については、Linear MCP のドキュメントを参照してください。

IDE 拡張機能と CLI は同じ設定を共有するため、どちらを使用しても MCP server の設定手順は同じです。

CLI を使用する(推奨)

CLI をインストール済みの場合は、次を実行します。

codex mcp add linear --url https://mcp.linear.app/mcp

Linear アカウントでサインインし、Codex に接続するよう求められます。

手動で設定する

  1. エディターで ~/.codex/config.toml を開きます。
  2. 次の内容を追加します。
[mcp_servers.linear]
url = "https://mcp.linear.app/mcp"
  1. codex mcp login linear を実行してログインします。