Codex와 Linear: Codex에 이슈를 배정하거나 @Codex 멘션하기

Codex를 Linear와 함께 쓰는 방법

2026년 11월 14일에 OpenAI와 Linear의 문서에서 확인한 내용이에요. OpenAI의 Codex 문서는 learn.chatgpt.com으로 옮겨졌고, Linear 페이지는 Codex in Linear예요. Slack은 Codex와 Slack을 참고하세요.

Codex for Linear 설정하기

OpenAI의 Linear 문서에 나온 설정 방법이에요. Codex가 이슈를 처리하려면 먼저 GitHub 저장소와 클라우드 환경이 있어야 해요.

1. GitHub 연결하고 클라우드 환경 만들기

   Codex에서 GitHub를 연결하고 저장소용 클라우드 환경을 만드세요. 채팅은 환경의 저장소 맵에 있는 첫 번째 저장소의 기본 브랜치에서 실행돼요.

2. Codex for Linear 설치하기

   chatgpt.com/codex/settings/connectors에서 Codex 커넥터 설정을 열고 워크스페이스에 Codex for Linear를 설치하세요. Enterprise에서는 ChatGPT 관리자가 먼저 Codex 클라우드 채팅(chatgpt.com/admin/settings)과 Codex for Linear 커넥터(chatgpt.com/admin/ca)를 켜요.

3. Linear 계정을 연결하고 이슈 맡기기

   이슈 댓글에서 @Codex를 멘션해 Linear 계정을 연결하세요. 그다음 Codex에 이슈를 배정하거나, 멘션하면서 저장소를 적으세요.

   @Codex fix this in openai/codex

4. 선택: 트리아지에서 위임하기

   Linear 팀 설정에서 Triage를 켜고 Codex에 위임하는 규칙을 추가하세요.

OpenAI의 Codex in Linear 문서

Codex CLI에 Linear MCP 서버 추가하기

로컬 Codex 세션에는 OpenAI가 CLI 명령을 권장해요. ChatGPT 데스크톱 앱, Codex CLI, IDE 확장이 이 설정을 공유하니 한 번만 설정하면 돼요.

1. 서버 추가하기

   터미널에서 실행하고 Linear 로그인을 마치세요.

   # Add Linear's MCP server to Codex (asks you to sign in to Linear)
   codex mcp add linear --url https://mcp.linear.app/mcp

2. 또는 config.toml 편집하기

   직접 설정할 때는 ~/.codex/config.toml에 서버를 넣고 codex mcp login linear로 로그인해요.

   # Or add it by hand in ~/.codex/config.toml
   [mcp_servers.linear]
   url = "https://mcp.linear.app/mcp"
   
   # then sign in (add --no-browser in a headless terminal)
   codex mcp login linear

3. 써 보기

   Codex 세션을 시작하고 예를 들어 “내 미해결 Linear 이슈 보여 줘”나 “ENG-123에 바꾼 내용을 댓글로 달아 줘”라고 요청해 보세요.

OpenAI의 Linear MCP 설정

Linear에서 Codex가 응답하지 않거나 MCP 서버가 연결되지 않을 때

• 설정을 확인하세요: Codex에 GitHub가 연결돼 있고, 저장소용 클라우드 환경이 있고, Codex for Linear가 설치돼 있고, @Codex 멘션으로 Linear 계정을 연결했어야 해요. Enterprise에서는 관리자가 Codex 클라우드 채팅과 커넥터도 켜야 해요.
• Codex가 알맞은 클라우드 환경을 찾지 못하면, 해결 방법을 Linear에 답해요. 다른 환경을 쓰려면 스레드에 답하면서 환경 이름을 적으세요.
• Linear의 Codex는 클라우드 채팅으로 실행되는데, API 키로 Codex에 로그인하면 클라우드 기능을 쓸 수 없어요. 유료 ChatGPT 요금제를 쓰세요.
• Linear는 원격 MCP 연결이 실패하거나 여러 번 시도해야 할 수 있다고 해요. Linear의 MCP 문서는 아직 Codex 사용자에게 ~/.codex/config.toml의 [features] 아래에 experimental_use_rmcp_client = true를 설정하라고 하지만, OpenAI의 현재 MCP 페이지에는 이 플래그가 나오지 않아요.
• 다시 로그인해도 기존 인증 세션 안에서 Linear 워크스페이스가 바뀌지는 않아요.

알아 둘 제한 사항

• OpenAI: “Codex는 실수할 수 있는 대규모 언어 모델을 사용합니다. 답변과 diff를 항상 검토하세요.”
• Codex는 요청을 이해하고 채팅을 만들기 위해 이슈 내용을 받아요.
• Linear는 Codex 같은 서드파티 에이전트에 요금을 청구하지 않고, 에이전트는 유료 시트로 계산되지 않아요. Linear의 Codex에는 유료 ChatGPT 요금제가 필요해요.
• Linear의 클라우드 코딩 에이전트는 Linear의 레거시 요금제에서 쓸 수 없어요. 내 OpenAI 키를 가져와도 샌드박스 비용은 Linear AI 크레딧에서 청구돼요.
• Linear의 예전 MCP용 SSE 엔드포인트는 사용 중단(deprecated)됐어요. https://mcp.linear.app/mcp를 쓰세요.

Codex가 담당자인 Linear 스타일 보드

Linear는 사람을 위해 만들어졌고, 에이전트는 위임받는 쪽으로 더해져요. Crewmark는 AI 직원 팀을 위해 만든 이슈 트래커이고, Codex는 Claude Code처럼 기본으로 그 안에서 돌아가요. 각 직원은 내 컴퓨터에 있는 Codex나 Claude Code 대화로, 직무, KPI, 프로젝트를 가져요. 이슈를 배정하면 일을 시작해요. 근무 시간 동안 하트비트에 맞춰 깨어나 상태를 최신으로 유지하고, 댓글을 달고 다른 직원을 @멘션하며, 내가 필요하면 이슈를 '조치 필요'로 바꿔요.

OpenCode, DeepSeek Harness 같은 다른 에이전트는 ACP(acpx)로 연결되고, 웹의 Work 로그에는 그 에이전트의 답장만 보여요. Crewmark는 Linear와 연결되지 않아요. 팀이 Linear를 계속 쓴다면, 직원은 내가 그 컴퓨터의 Codex에 추가한 Linear MCP 서버를 다른 도구처럼 쓸 수 있어요. Crewmark는 GPL-3.0 오픈 소스이고, 프로젝트 1개와 AI 직원 3명까지 무료예요. Codex는 이미 가진 ChatGPT 요금제로 돌아가요. 맡길 일은 Codex 활용 사례를 참고하세요.

Codex와 Linear FAQ