Codex 연결

Codex는 연결 토큰으로 연결합니다. Codex CLI, Codex IDE 확장, Codex 데스크톱 앱은 같은 설정 파일을 쓰므로 한 번 설정하면 세 곳에서 함께 씁니다.

준비

자동 설정 명령은 Codex CLI를 사용합니다. 먼저 설치하고 터미널에서 codex --version으로 확인합니다. 설정한 연결은 IDE 확장과 데스크톱 앱에서도 함께 씁니다. CLI를 설치하지 않으려면 아래의 직접 설정 방법을 따릅니다.

연결 순서

1. 콘솔에서 Codex를 고릅니다

   콘솔의 연결 → 연결 추가에서 Codex를 고릅니다.

2. 연결 이름을 확인하고 토큰을 받습니다

   이름은 "Codex"로 미리 채워져 있습니다. 재확인하고 토큰 발급을 누릅니다. 최근 10분 안에 로그인하지 않았다면 이메일 코드로 본인 확인을 한 번 더 합니다.

3. 명령을 복사해 터미널에 붙여 넣습니다

   콘솔의 명령 복사를 누릅니다. 터미널에 붙여 넣고 Enter를 누릅니다. 콘솔은 브라우저의 운영체제에 맞는 명령(macOS·Linux 또는 Windows)을 먼저 보여 줍니다.

4. 토큰을 물으면 토큰을 붙여 넣습니다

   콘솔의 토큰 복사를 누릅니다. 터미널에 붙여 넣고 Enter를 누릅니다. 붙여 넣어도 글자가 보이지 않습니다. 정상입니다.

   성공하면 터미널에 이렇게 보입니다.

   ✓ 저장했어요.
     토큰 위치: ~/.codex/.env
     서버 주소 위치: ~/.codex/config.toml
   이제 codex를 새로 실행하세요. IDE 확장과 데스크톱 앱은 다시 시작하세요.
   

5. Codex를 새로 시작합니다

   터미널의 codex는 새로 실행합니다. IDE 확장과 데스크톱 앱은 다시 시작합니다. Codex가 시작하면서 Clone-Me에 연결하고, 콘솔의 연결 확인이 "연결됨"으로 바뀝니다.

명령이 하는 일

1. 토큰을 ~/.codex/.env에 CLONEME_TOKEN=… 한 줄로 저장합니다. 파일의 다른 줄은 그대로 두고, 본인만 읽을 수 있게(권한 600) 둡니다.
2. codex mcp add cloneme --url … --bearer-token-env-var CLONEME_TOKEN으로 ~/.codex/config.toml의 Clone-Me 서버 설정을 등록하거나 교체합니다. 기존 연결이 있으면 먼저 교체할지 묻습니다. 다른 서버 설정은 유지합니다.
3. CODEX_HOME을 쓰면 그 폴더에 저장합니다.

[mcp_servers.cloneme]
url = "https://clonememcp.102labs.com/mcp"
bearer_token_env_var = "CLONEME_TOKEN"

Codex는 시작할 때 ~/.codex/.env를 읽고, bearer_token_env_var로 정한 변수의 값을 Authorization: Bearer 헤더로 보냅니다. 그래서 셸 설정 파일에 토큰을 넣지 않아도 IDE 확장과 데스크톱 앱이 같은 토큰을 씁니다. 셸에 같은 이름의 변수가 있어도 .env의 값이 우선합니다.

직접 설정하려면

1. ~/.codex/config.toml의 기존 Clone-Me 서버 항목을 위 설정으로 고칩니다. 항목이 없을 때만 추가합니다. [mcp_servers."cloneme"]도 같은 항목이므로 중복으로 넣지 않습니다.
2. ~/.codex/.env에 CLONEME_TOKEN=(연결 토큰) 줄을 넣습니다.
3. chmod 600 ~/.codex/.env로 본인만 읽게 합니다.

등록 확인

• Codex 안에서 /mcp를 입력하면 cloneme의 상태와 도구가 보입니다.
• codex mcp list는 등록 여부만 보여 줍니다. 연결은 시험하지 않습니다.

Windows와 WSL

• Windows용 명령은 %USERPROFILE%\.codex에 저장합니다. CODEX_HOME을 쓰면 그 폴더에 저장합니다.
• WSL 안의 codex는 Windows 쪽 설정 파일을 읽지 않습니다. WSL 터미널에서 macOS·Linux용 명령을 실행합니다.

Codex가 Clone-Me를 잘 쓰게 하기

프로젝트의 AGENTS.md에 다음처럼 적으면 더 자주 씁니다.

내 취향·기준·일하는 방식에 따라 답이 갈리는 선택은 정하기 전에 cloneme의 ask_me로 먼저 확인한다.

안 될 때

더 많은 경우는 문제 해결에 있습니다.

최종 수정 2026. 10. 28.