alt
개발자 문서

개발자 문서

CLI

대화형 설정 도우미 하나로 터미널에서 Alt 연동을 설정하세요.

altalt CLI는 기존 설정을 덮어쓰지 않고 MCP, REST API와 웹훅 설정을 안내합니다. Alt를 연동할 프로젝트 폴더에서 실행하세요:

npx
npx altalt

Node.js 18 이상이 필요합니다. npx가 실행할 때 최신 CLI 패키지를 내려받으므로 전역 설치는 필요하지 않습니다.

설정 도우미가 하는 일

  1. 1

    MCP 연결

    Claude Code와 Codex를 감지하고 Cursor 설정을 제공한 뒤, 브라우저 OAuth로 Alt 호스팅 MCP 서버를 연결합니다. 수동 설정은 MCP 문서를 참고하세요.

  2. 2

    API와 웹훅 확인

    계정 콘솔을 열고 입력한 API 키가 유효한지 확인한 뒤 현재 프로젝트에 저장합니다. 선택한 웹훅 엔드포인트에는 사용자가 승인한 후 테스트 이벤트를 보낼 수 있습니다.

  3. 3

    구현 인계

    확인 후 기계 판독용 개발자 문서를 참조하는 프롬프트를 코딩 에이전트에 전달합니다. 지원 에이전트가 없으면 붙여 넣을 프롬프트를 출력합니다.

모드와 플래그

--mcp-only설정 단계를 브라우저 OAuth 기반 MCP 연결로 제한한 뒤 에이전트 인계를 제안합니다.
--api-onlyREST API와 웹훅 확인만 진행한 뒤 코딩 에이전트 인계를 제안합니다.
--print-prompt코딩 에이전트용 프롬프트를 출력하고 종료합니다.
--dev개발 스택을 대상으로 실행합니다. 출시 전 QA에만 사용하세요.
--version설치된 CLI 버전을 출력합니다.
--help명령 사용법과 지원 플래그를 출력합니다.

설정과 키 보호

  • 환경 파일을 변경하기 전에 키를 검증하고, 현재 프로젝트 디렉터리에 ALT_API_KEY로 저장합니다.
  • 기존 Alt MCP 설정은 삭제하거나 덮어쓰지 않습니다. 필요하면 OAuth 설정을 alt-oauth라는 별도 항목으로 추가합니다.
  • 코딩 에이전트 인계와 웹훅 테스트 전송은 모두 사용자의 확인을 받은 뒤 진행합니다. 배포 전 보안 문서의 키 관리 지침을 확인하세요.

현재 제공 범위

CLI 패키지는 공개되어 있지만, 내부 시험 운영 기간에는 운영 OAuth와 API 키 발급을 Alt 관리자에게만 제공합니다. 기존 API 키 방식의 MCP 연결은 계속 지원합니다. 콘솔에서 404가 나타나거나 OAuth 접근을 승인할 수 없다면 아직 해당 계정에 기능이 열리지 않은 상태입니다.