Codex 설치 프롬프트: AiAkiv 연결과 스킬을 한 번에

Codex 대화창에 붙여 넣으면 Codex 가 AiAkiv 연결 등록, 로그인 창 띄우기, 스킬 일곱 개 설치, 설치 기록 작성까지 스스로 하는 프롬프트. 개발자 모드는 필요 없다. 붙여 넣기 전에 기존 AiAkiv Memory 플러그인을 지우거나, 남겨 둘 거면 이름을 AiAkivCodex 로 바꾼다.

Codex 대화창에 아래 프롬프트를 그대로 붙여 넣으면 Codex 가 다음 일을 스스로 한다.

  1. 주소 https://mcp.aiakiv.com/mcp?apps=all 을 AiAkiv 라는 이름의 MCP 서버로 등록한다.
  2. 로그인 창(OAuth)을 띄운다. 로그인은 사람이 한다.
  3. 공개 저장소 github.com/AiAkiv/aiakiv-plugins 의 AiAkiv 스킬 일곱 개를 ~/.agents/skills/ 에 설치한다.
  4. 작업 폴더에 설치 기록 파일(aiakiv-install-test.md)을 쓴다.

개발자 모드는 필요 없다. 2026-10-13 실측으로 통과한 프롬프트다. 설치가 끝나면 새 세션을 열고 Codex 검증 프롬프트로 확인한다.

왜 플러그인과 따로 설치하는지, 이 연결로 무엇이 되는지는 ChatGPT 연결 §6 에 있다.

붙여 넣기 전에

  • 기존에 설치한 AiAkiv 플러그인(플러그인 디렉터리의 AiAkiv Memory)은 가능하면 먼저 삭제한다. 두 연결이 같은 이름의 도구를 내놓아 AI 가 아무 쪽이나 고르게 되고, 플러그인 쪽에는 앱 실행 도구가 없어 스킬이 부르는 도구가 빠져 있다.
  • 플러그인을 남겨 둘 거면 이름을 AiAkivCodex 로 바꾼다. chatgpt.com 웹 대화에서도 플러그인을 같이 쓰고 싶다면 플러그인은 그대로 두고, 아래 프롬프트의 MCP 이름 AiAkiv 를 AiAkivCodex 로 바꿔 붙여 넣는다. 그러면 "AiAkivCodex 로 저장해 줘" 처럼 어느 쪽을 쓸지 지목할 수 있다.
  • 로그인은 사람이 한다. 로그인 창이 뜨면 www.aiakiv.com 계정으로 로그인하고 동의한다. Codex 가 대신 로그인하지 않는다.

프롬프트

현재 PC에 AiAkiv의 Codex용 MCP와 스킬을 설치하고 OAuth 연결을 완료해 주세요. PC마다 다른 실행파일 위치나 사용자 이름을 고정해서 가정하지 마세요.
설치 대상:

* MCP 이름: AiAkiv
* MCP URL: https://mcp.aiakiv.com/mcp?apps=all
* 스킬 저장소: https://github.com/AiAkiv/aiakiv-plugins
* 설치 범위: 현재 OS 사용자의 Codex 전역 설정과 스킬

다음 순서로 직접 진행해 주세요.

1. 현재 사용자, 작업 폴더, Codex 설정 위치를 확인하세요. CODEX_HOME이 설정되어 있다면 그 값을 확인하고, 실제 사용하는 config.toml을 찾으세요. 인증 정보가 포함된 설정 전체를 출력하지 마세요.
2. Codex CLI를 찾으세요. 먼저 PATH에서 확인하고, 없으면 Codex 앱의 실제 설치 위치와 동봉된 실행파일을 확인하세요. 사용자 이름이나 버전별 폴더 이름을 추정하지 마세요. 찾은 실행파일의 버전을 확인하고 이후 명령은 전체 경로로 호출하세요. CLI를 찾지 못하면 앱 설정으로 진행할 수 있는지 확인하고, 사용자 조작이 필요한 부분을 안내하세요.
3. 기존 AiAkiv MCP와 스킬의 설치 여부를 확인하세요. 동일한 항목이 있으면 중복 설치하지 마세요. 기존 설치 기록과 현재 상태가 다르면 설정 위치 차이를 조사하세요. 플러그인 디렉터리에서 설치한 AiAkiv Memory 플러그인이 아직 있으면 도구 이름이 겹치므로 진행을 멈추고, 플러그인을 삭제한 뒤 다시 시작하거나 둘을 같이 쓰려면 MCP 이름을 AiAkivCodex로 바꿔 달라고 안내하세요.
4. 현재 사용자의 Codex 전역 설정에 AiAkiv를 등록하세요. 기존 항목의 이름과 URL이 맞으면 유지하세요. 다른 설정 항목은 보존하세요. CODEX_HOME을 임의로 변경하지 마세요.
5. 같은 실행파일과 설정 환경에서 MCP 목록을 조회하여 AiAkiv가 보이는지 확인하세요. 이어서 필요한 OAuth 인증을 진행하세요. 로그인과 동의는 제가 완료하겠습니다.
6. HTTP 요청 실패가 발생하면 원인을 조사하세요. 명령 실행 환경의 네트워크 제한 여부도 확인하고, 지원되는 승인 절차가 필요하면 이유를 설명하여 진행하세요.
7. 저장소 구조를 확인하고 AiAkiv 스킬을 모두 설치하세요. Node.js나 npx를 새로 설치하지 말고, 내장 skill-installer 또는 ZIP 다운로드와 파일 복사 방식을 사용하세요. 각 SKILL.md와 함께 있는 참고 파일을 보존하세요. 기존 스킬이 있으면 버전이나 내용 차이를 확인하고, 교체가 필요한 이유를 설명하세요.
8. 현재 작업 폴더에 aiakiv-install-test.md를 작성하거나 기존 기록을 갱신하세요. 발견한 실행파일 경로, 실제 설정 위치, 설치한 스킬 이름과 위치, MCP 등록 상태, OAuth 결과, 오류와 해결 과정을 기록하세요. 토큰, 비밀번호, 인증 코드는 기록하지 마세요.
9. 설치 후 도구와 스킬이 현재 세션에 나타나는지 확인하세요. 새 세션이 필요하면 안내하고, 새 세션에서 AiAkiv의 get_save_target을 호출할 확인 프롬프트를 제공하세요.

메모리 저장, 카드 생성, 컨텐츠 수정은 하지 마세요. 마지막에 완료된 항목과 사용자 조작이 남은 항목을 간단히 정리하세요.

알아 둘 것

  • 설치되는 스킬은 일곱 개다. aiakiv-onboarding, aiakiv-save-and-recall, aiakiv-graph-query, aiakiv-links, aiakiv-cards, aiakiv-console, aiakiv-contents. 각각 ~/.agents/skills/<스킬 이름>/ 에 들어간다. 콘솔의 폴더 ZIP 에 든 스킬과 같은 경로다.

  • 사람이 직접 칠 때는 두 줄이다. Codex 에게 맡기지 않고 터미널에서 직접 하려면 아래 두 줄을 친다. 첫 줄은 연결을 등록하고, 둘째 줄은 스킬 일곱 개를 설치한다. 플러그인을 남겨 둔다면 첫 줄의 AiAkiv 를 AiAkivCodex 로 바꾼다. 둘째 줄의 Skills CLI 에 --all 을 주면 모든 에이전트 폴더에 스킬 링크를 뿌리므로 쓰지 않는다.

    codex mcp add AiAkiv --url "https://mcp.aiakiv.com/mcp?apps=all"
npx skills add AiAkiv/aiakiv-plugins -a codex -s '*' -g -y

  • 스킬이 실제로 읽히는지 보려면 codex debug prompt-input "hello" 를 실행한다. Codex 가 모델에 보낼 프롬프트를 뽑아 보여 주는데, 그 안의 스킬 목록에 일곱 이름이 있으면 된다. 모델을 부르지 않으므로 사용량이 들지 않는다.

  • 연결 확인은 새 세션에서 한다. Codex 검증 프롬프트를 붙여 넣으면 도구, 저장 위치, 스킬을 하나씩 확인해 준다.

  • 저장은 Main 으로 간다. 이 연결은 콘솔에서 정한 Main 프로젝트를 따라간다. 폴더마다 프로젝트를 고정하려면 프로젝트 고정 API 키를 쓴다 → ChatGPT 연결 §2.

  • AI 가 무언가를 바꾸는 콘솔 일은 켜 둔 것만 한다. 콘솔의 참고 → AI 권한에서 켠 일만 할 수 있다 → AI에게 콘솔 일 시키기.

  • 어디에 적용되나. Codex CLI 에서 실측했다. Codex 데스크톱 앱과 IDE 확장은 OpenAI 문서상 같은 설정을 읽지만 아직 실측하지 않았다. chatgpt.com 웹 대화에는 이 연결이 보이지 않는다.

관련 문서

전체 목차 → 문서 이 문서를 마크다운으로