Linear에서 Codex 사용하기

Linear에서 Codex를 사용하여 이슈의 작업을 위임할 수 있습니다. 이슈를 Codex에 할당하거나 댓글에서 @Codex을(를) 멘션하면 Codex가 클라우드 채팅을 생성하고 진행 상황과 결과를 답글로 남깁니다.

Linear의 Codex는 유료 플랜에서 사용할 수 있습니다(요금제 참조).

Enterprise 플랜을 사용 중이라면 ChatGPT 워크스페이스 관리자에게 워크스페이스 설정에서 Codex 클라우드 채팅을 켜고 커넥터 설정에서 Codex for Linear를 활성화해 달라고 요청하세요.

Linear 통합 설정하기

1. Codex에서 GitHub를 연결하고 Codex가 작업할 저장소의 환경을 생성하여 Codex 클라우드 채팅을 설정합니다.
2. Codex 설정으로 이동하여 워크스페이스에 Codex for Linear를 설치합니다.
3. Linear 이슈의 댓글 스레드에서 @Codex을(를) 멘션하여 Linear 계정을 연결합니다.

Codex에 작업 위임하기

다음 두 가지 방법으로 작업을 위임할 수 있습니다.

Codex에 이슈 할당하기

통합을 설치한 후에는 팀원에게 할당하는 것과 같은 방식으로 이슈를 Codex에 할당할 수 있습니다. Codex가 작업을 시작하고 진행 상황을 이슈에 업데이트합니다.

댓글에서 @Codex 멘션하기

댓글 스레드에서 @Codex을(를) 멘션하여 작업을 위임하거나 질문할 수도 있습니다. Codex가 답변한 후 같은 채팅을 계속하려면 해당 스레드에서 후속 댓글을 남기세요.

Codex가 이슈 작업을 시작하면 작업할 환경과 저장소를 선택합니다. 특정 저장소를 지정하려면 댓글에 저장소를 포함하세요. 예: @Codex fix this in openai/codex.

진행 상황을 추적하려면 다음과 같이 하세요.

• 이슈에서 Activity를 열어 진행 상황 업데이트를 확인합니다.
• 채팅 링크를 열어 더 자세한 진행 과정을 확인합니다.

Codex는 작업을 완료하면 요약과 완료된 채팅 링크를 게시하며, 이 링크에서 풀 리퀘스트를 생성할 수 있습니다.

Codex가 환경과 저장소를 선택하는 방식

• Linear는 이슈 컨텍스트를 기반으로 저장소를 제안합니다. Codex는 해당 제안과 가장 잘 일치하는 환경을 선택합니다. 요청이 모호하면 가장 최근에 사용한 환경을 대신 선택합니다.
• 채팅은 해당 환경의 저장소 맵에 첫 번째로 나열된 저장소의 기본 브랜치를 기준으로 실행됩니다. 다른 기본 저장소나 더 많은 저장소가 필요하면 Codex에서 저장소 맵을 업데이트하세요.
• 적합한 환경이나 저장소가 없으면 Codex는 다시 시도하기 전에 문제를 해결하는 방법을 Linear에 답글로 안내합니다.

Codex에 이슈 자동 할당하기

분류 규칙을 사용하여 이슈를 Codex에 자동으로 할당할 수 있습니다.

1. Linear에서 Settings로 이동합니다.
2. Your teams에서 팀을 선택합니다.
3. 워크플로 설정에서 Triage를 열어 활성화합니다.
4. Triage rules에서 규칙을 생성하고 Delegate > Codex를 선택합니다(설정하려는 다른 속성도 함께 선택).

Linear는 분류 단계로 들어오는 새 이슈를 Codex에 자동으로 할당합니다. 분류 규칙을 사용하면 Codex는 이슈 생성자의 계정을 사용하여 채팅을 실행합니다.

데이터 사용, 개인정보 보호 및 보안

@Codex을(를) 멘션하거나 이슈를 할당하면 Codex는 요청을 이해하고 채팅을 생성하기 위해 이슈 콘텐츠를 수신합니다. 데이터 처리는 OpenAI의 개인정보 처리방침, 이용 약관 및 기타 관련 정책을 따릅니다. 보안에 관한 자세한 내용은 Codex 보안 문서를 참조하세요.

Codex는 실수할 수 있는 대규모 언어 모델을 사용합니다. 답변과 diff를 항상 검토하세요.

팁 및 문제 해결

• 연결 누락: Codex가 Linear 연결을 확인할 수 없으면 계정을 연결할 수 있는 링크를 이슈에 답글로 남깁니다.
• 예상과 다른 환경 선택: 스레드에 원하는 환경을 답글로 남기세요(예: @Codex please run this in openai/codex).
• 잘못된 코드 부분: 이슈에 컨텍스트를 더 추가하거나 @Codex 댓글에 명시적인 지침을 작성하세요.
• 추가 도움말: OpenAI 도움말 센터를 참조하세요.

로컬 작업을 위해 Linear 연결하기(MCP)

ChatGPT 데스크톱 앱, Codex CLI 또는 IDE 확장을 사용하면서 로컬에서 Linear 이슈에 액세스하려면 Linear Model Context Protocol (MCP) 서버를 구성하세요.

자세한 내용은 Linear MCP 문서를 확인하세요.

IDE 확장과 CLI는 동일한 구성을 공유하므로 어느 쪽을 사용하든 MCP 서버 설정 단계는 같습니다.

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"

3. codex mcp login linear을(를) 실행하여 로그인합니다.