For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to the page URL.
기본 탐색 메뉴
Theme

Linear에서 Codex 사용하기

Linear 이슈에서 Codex 채팅 시작하기

Linear 이슈에서 Codex에 작업을 맡길 수 있습니다. Codex에 이슈를 할당하거나 댓글에서 @Codex를 멘션하면 Codex가 클라우드 채팅을 만들고 진행 상황과 결과를 이슈에 답글로 남깁니다.

유료 플랜에서 Linear용 Codex를 사용할 수 있습니다. 자세한 내용은 요금 안내를 참고하세요.

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

Linear 연동 설정하기

  1. Codex 클라우드 채팅을 설정하려면 Codex에서 GitHub를 연결하고 Codex가 작업할 리포지터리의 환경을 만드세요.
  2. Codex 설정으로 이동해 워크스페이스에 Codex for Linear를 설치하세요.
  3. Linear 이슈의 댓글 스레드에서 @Codex를 멘션해 Linear 계정을 연결하세요.

Codex에 작업 맡기기

두 가지 방법으로 작업을 맡길 수 있습니다.

Codex에 이슈 할당하기

Linear 연동을 설치하면 팀원에게 이슈를 할당할 때와 같은 방법으로 Codex에 이슈를 할당할 수 있습니다. Codex는 작업을 시작하고 해당 이슈에 진행 상황을 게시합니다.

댓글에서 @Codex 멘션하기

댓글 스레드에서 @Codex를 멘션해 작업을 맡기거나 질문할 수도 있습니다. Codex가 답글을 남기면 같은 스레드에 답글을 달아 채팅을 이어 가세요.

Codex는 이슈 작업을 시작하면 작업할 환경과 리포지터리를 선택합니다. 특정 리포지터리를 지정하려면 댓글에 리포지터리 이름을 포함하세요. 예를 들어 @Codex openai/codex에서 이 문제를 수정해 주세요라고 입력하세요.

진행 상황은 다음과 같이 확인할 수 있습니다.

  • 이슈에서 Activity를 열어 진행 상황을 확인하세요.
  • 더 자세히 살펴보려면 채팅 링크를 여세요.

작업을 마치면 Codex가 이슈에 요약과 완료된 채팅 링크를 게시합니다. 이 링크를 열어 pull request를 만들 수 있습니다.

Codex가 환경과 리포지터리를 선택하는 방식

  • Linear는 이슈의 컨텍스트를 바탕으로 리포지터리를 제안합니다. Codex는 제안된 리포지터리에 가장 잘 맞는 환경을 선택합니다. 요청이 모호하면 사용자가 가장 최근에 사용한 환경을 선택합니다.
  • 채팅은 해당 환경의 리포지터리 맵에 첫 번째로 나열된 리포지터리의 기본 브랜치에서 실행됩니다. 다른 리포지터리를 기본값으로 사용하거나 리포지터리를 더 추가하려면 Codex에서 리포지터리 맵을 업데이트하세요.
  • 적합한 환경이나 리포지터리가 없으면 Codex가 Linear에 답글을 남겨 다시 시도하기 전에 문제를 해결하는 방법을 안내합니다.

Codex에 이슈 자동 할당하기

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

  1. Linear에서 Settings를 여세요.
  2. Your teams 아래에서 팀을 선택하세요.
  3. 워크플로우 설정에서 Triage를 열고 기능을 켜세요.
  4. Triage rules에서 규칙을 만들고 Delegate > Codex를 선택하세요. 필요한 다른 속성도 함께 설정하세요.

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

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

@Codex를 멘션하거나 Codex에 이슈를 할당하면 Codex가 이슈 내용을 받아 요청을 파악하고 채팅을 만듭니다. 데이터는 OpenAI의 개인정보 보호 정책, 이용약관 및 기타 관련 정책에 따라 처리됩니다. 보안에 관한 자세한 내용은 Codex 보안 문서를 참고하세요.

Codex가 사용하는 대규모 언어 모델은 실수할 수 있습니다. 답변과 코드 변경 사항을 항상 검토하세요.

팁 및 문제 해결

  • 계정 연결을 확인할 수 없는 경우: Codex가 Linear 연결을 확인할 수 없으면 이슈에 답글로 계정 연결 링크를 남깁니다.
  • 예상과 다른 환경이 선택된 경우: 스레드에 답글로 원하는 환경을 지정하세요. 예를 들어 @Codex 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"
  1. codex mcp login linear를 실행해 로그인하세요.