IRIS 설치 패키지 v2.0.38

IRIS 설치 패키지 2.0.38 (2026-09-23)

바뀜 — 무엇을 고르든 Claude·Codex 두 비서를 늘 함께 설치합니다

• 구독 화면에서 Claude 만, ChatGPT 만, 둘 다 — 어느 것을 골라도 두 프로그램을 모두 설치하고 켭니다. 고른 것은 「로그인」 상자만 가릅니다.
• 그래서 IRIS 창을 처음 열면 Claude·Codex 선택 단추가 늘 둘 다 보입니다. 나중에 다른 구독이 생기면 IRIS 창의 한도 화면(대시보드)에서 계정만 더하면 바로 연결됩니다.
• 고르지 않은 쪽의 내려받기가 실패하면(학교 망 차단 등) 설치를 멈추지 않고 경고만 남깁니다.

고침 — 같은 계정으로 다시 로그인하면 「로그인을 가져오는 중입니다」에서 멈추던 문제

• 원인: 계정 중계기는 같은 계정을 한 번만 셉니다. 이미 연결된 계정으로 다시 로그인하면 계정 수가 늘지 않아, 설치기가 "아직 안 끝남"으로 보고 계속 기다렸습니다.
• 이제 로그인을 가져온 뒤 그 종류의 계정이 1개 이상 있으면 완료로 봅니다.

함께 — IRIS 창 2.76.0

• 두 에이전트 단추를 늘 보이고, 계정이 없으면 "대시보드에서 계정 추가", 프로그램이 없으면 "설치 파일 다시 실행"을 단추 옆에 알려 줍니다. 계정을 더하면 안내가 저절로 사라집니다.
• 예전 판으로 설치한 PC 도 IRIS 창이 시작할 때 설치된 프로그램을 스스로 켭니다(Codex 단추가 안 보이던 PC).

이미 설치한 PC

• zip 을 받아 실행 → 「업데이트 시작」(또는 IRIS 창 설정 → 업데이트). 기존 폴더·설정·로그인은 그대로입니다.
• 예전에 ChatGPT 만 골라 설치한 PC 는 Claude 프로그램이 없습니다. 이 판으로 업데이트하면 Claude Code 가 없을 때만 내려받아 채웁니다(이미 있으면 건드리지 않음). 내려받기가 막혀도 업데이트는 끝나며, IRIS 창이 Claude 단추 옆에 "설치 파일 다시 실행"을 알려 줍니다.

첨부: zip · .sha256 · .sha256.sig(공식 서명). 미러: iris-workspace.com 내려받기 단추.

sha256: 1328a9c9f4ff5f94d38a8136a1296112631b18d1ab42844420c426f19b943b27 IRIS-Setup_v2.0.38_2026-09-23.zip

IRIS 설치 패키지 2.0.37 — 「IRIS 열기」 node.exe 오류 수정

IRIS 설치 패키지 2.0.37 (2026-09-23)

고침 — 설치 끝에 「IRIS 열기」를 누르면 "IRIS-Face could not start node.exe." 창이 뜨던 문제

• 원인: IRIS 창 실행기(launch-hidden.vbs)는 동봉 node 의 위치를 IRIS_FACE_NODE 로 받고, 그 값이 없으면 PATH(프로그램을 찾아보는 폴더 목록)에서 node 를 찾습니다. 바탕화면 「IRIS」 아이콘은 이 값을 넘기지만, 설치 화면의 「IRIS 열기」는 넘기지 않았습니다.
• 설치 화면은 node 가 PATH 에 등록되기 전에 켜진 프로그램이라, 자기 PATH 에 node 가 없습니다. 그래서 실패했습니다. 새로 연 터미널에서 node --version 이 정상으로 나오는 것은, 새 창은 바뀐 PATH 를 읽기 때문입니다.
• 이제 「IRIS 열기」와 업데이트 뒤 자동 재실행 모두 동봉 node 의 경로를 직접 넘깁니다. PATH 에 node 가 전혀 없는 상태에서 실제 실행기로 확인했습니다.

이미 설치한 PC

• 설치는 제대로 끝나 있습니다. 바탕화면 「IRIS」 아이콘으로 열면 바로 됩니다.
• 새 판으로 올리려면 zip 을 받아 실행 → 「업데이트 시작」(또는 IRIS 창 설정 → 업데이트). 기존 폴더·설정·로그인은 그대로입니다.

첨부: zip · .sha256 · .sha256.sig(공식 서명). 미러: iris-workspace.com 내려받기 단추.

sha256: 0c6f7dd29445e70fb3ab21b8d711749c22c48bdc1afb09036824d1d8e1f5eefb IRIS-Setup_v2.0.37_2026-09-23.zip

IRIS 설치 패키지 2.0.36

IRIS 설치 패키지 2.0.36 (2026-09-23)

고침 — 「로그인」을 눌러도 브라우저가 전혀 안 뜨던 문제

• 원인: Claude Code 내려받기가 실패해도 로그인 단추가 켜져 있어, 없는 프로그램으로 로그인을 띄우고 곧장 꺼졌습니다. 계정이 0개로 남아 중계기가 시작되지 않았고(대시보드 "프록시 연결 안 됨"), IRIS 창은 설치가 덜 끝난 것으로 보고 첫 세션 인터뷰 대신 「설치 이어하기」를 보였습니다.
• 이제 Claude Code 가 ✓ 가 되기 전에는 「로그인」이 잠기고, 까닭을 칸 안에 적습니다. 내려받기가 실패하면 그 이유 한 줄과 「Claude Code 다시 받기」 단추가 나옵니다(학교 망이 막으면 휴대폰 핫스팟).
• 로그인 전에 프로그램이 있는지 먼저 확인합니다. 없으면 창을 띄우지 않고 "다시 받기" 안내로 멈춥니다. 주소를 한 번도 못 띄우고 꺼진 로그인도 따로 알립니다.
• 누른 지 20초가 지나도 로그인 창이 안 보이면 "작업 표시줄 확인 → 「다시 로그인」" 안내와 단추를 미리 보입니다. 로그인 링크는 진행 중 계속 보이고 다시 열 수 있습니다.
• 첫 인터넷 확인에 로그인 주소 claude.com·platform.claude.com 을 더했습니다. 이 둘만 막는 망이면 이제 첫 화면에서 알려 줍니다.
• 내려받기·로그인이 실패한 화면에도 「개발자에게 신고하기」가 보입니다.

바뀐 것 — 안내 문구

• 대시보드: 로그인한 계정이 0개면 "로그인한 계정이 없습니다 — IRIS 창 설정에서 로그인" 을 보이고, 첫 로그인이 끝나면 중계기를 스스로 시작합니다.
• IRIS 창(Face 2.75.0): 구독을 고르지 않아 잠들어 있는 에이전트가 있으면 새 세션 창에 "Codex 잠들어 있음 — 설정 「에이전트 깨우기」" 를 보입니다.

적용 방법

• 이미 설치된 PC: zip 을 받아 실행 → 「업데이트 시작」(또는 IRIS 창 설정 → 업데이트). 기존 폴더·설정·로그인은 그대로입니다.
• 로그인이 안 됐던 PC: 새 zip 으로 다시 실행 → Claude Code ✓ 확인 → 「로그인」.

첨부: zip · .sha256 · .sha256.sig(공식 서명). 미러: iris-workspace.com 내려받기 단추.

sha256: 3c21043103bf52248685b2c7f841fc157e4708a56b84bd02653c42ddc97b6e6c IRIS-Setup_v2.0.36_2026-09-23.zip

IRIS 설치 패키지 2.0.35

IRIS 설치 패키지 2.0.35 (2026-09-21)

바뀐 것 — 폴더 구조는 설치 뒤 대화로

• 설치기가 더는 폴더 구성을 묻지 않습니다. 설치는 IRIS 폴더 하나(와 안의 도구 폴더)만 만듭니다.
• 설치가 끝나고 IRIS 창이 열리면 비서가 폴더 구조 인터뷰를 바로 시작합니다. 역할(R)부터 영역(D)·프로젝트(P)까지 한 번에 한 질문씩 여쭤 보고, 확정한 뒤에만 폴더를 만듭니다. 대본은 _agent\setup\interview.md.
• 이미 폴더가 있는 PC(업데이트)는 인터뷰를 다시 하지 않고 이전과 똑같이 인사합니다.

고침 — IRIS 창을 열지 않은 터미널에서 claude/codex 가 안 되던 문제

• 원인은 폴더 위치가 아니라 IRIS 창을 열기 전엔 중계기(127.0.0.1:3456)가 떠 있지 않던 것이었습니다. 이제 claude·codex를 어느 터미널에서 치든 중계기가 꺼져 있으면 스스로 띄웁니다(최대 8초).
• 로그온 때 중계기를 자동으로 띄우는 항목(HKCU Run 「IRIS relay」)도 등록합니다. 창은 뜨지 않습니다.

적용 방법

• 이미 설치된 PC: zip 을 받아 실행 → 「업데이트 시작」(또는 IRIS 창 설정 → 업데이트). 기존 폴더는 그대로입니다.
• 새 PC: IRIS-설치.cmd 두 번 클릭 → 설치 뒤 IRIS 창에서 인터뷰.

첨부: zip · .sha256 · .sha256.sig(공식 서명). 미러: iris-workspace.com 내려받기 단추.

sha256: 7789b38748589e2642924c2f4c2ab98b2955974c6d24318d0fe0c388404a775a IRIS-Setup_v2.0.35_2026-09-21.zip

IRIS 설치 패키지 2.0.34

IRIS 설치 패키지 2.0.34 (2026-09-21)

고침 — 업데이트 뒤 메신저 모듈이 두 개로 보이던 문제

• 2.0.x 업데이트가 메신저 모듈의 옛 폴더(messenger.prev)를 IRIS 창의 모듈 폴더 안에 남겨, 설정에 메신저가 두 개(하나는 "맞지 않음", 제거 불가)로 보이고 헤더 아이콘에 느낌표가 떴습니다. 이제 모듈은 IRIS 창의 모듈 설치기가 제자리에서 교체하며, 로그인·설정(state)도 새 판으로 이어집니다.
• 이미 남아 있는 옛 폴더는 이번 업데이트가 스스로 거둡니다(지우지 않고 face\modules-prev\로 옮김). 현재 메신저에 로그인 정보가 없으면 옛 폴더의 로그인을 되살립니다.
• IRIS 창(Face 2.73.1): 이름 규칙 밖 폴더는 모듈로 읽지 않습니다 — 잔재가 남아 있어도 모듈은 하나만 보입니다.
• 업그레이드 검사에 "모듈 폴더에 잔재 없음" 항목을 더해 같은 결함이 다시 나가지 않게 했습니다.

적용 방법

• 이미 설치된 PC: zip 을 받아 실행 → 「업데이트 시작」(또는 IRIS 창 설정 → 업데이트).
• 새 PC: IRIS-설치.cmd 두 번 클릭.

첨부: zip · .sha256 · .sha256.sig(공식 서명). 미러: iris-workspace.com 내려받기 단추.

sha256: adcb8c56e201c19a1ca2d4c32fd4e00a1d52576fd10ef528eed15d0f24e4895e IRIS-Setup_v2.0.34_2026-09-21.zip

IRIS 설치 패키지 2.0.33

IRIS 설치 패키지 2.0.33 (2026-09-21)

고침 — 구독 로그인이 막히던 문제

• 로그인은 이제 검은 창 없이 진행됩니다. 「로그인」을 누르면 브라우저가 열리고, 로그인·「허용」 뒤 브라우저가 저절로 돌아옵니다. 코드를 복사해 붙여넣는 일은 없습니다. (이전 판의 검은 창은 붙여넣은 코드를 화면에 보여 주지 않아 진행이 불가능했습니다.)
• 브라우저가 열리지 않았을 때 누를 링크를 화면 상자 안에 둡니다(자동 복귀 주소).
• 로그인 화면에서 구독을 다시 고를 수 있습니다(☑ Claude ☑ ChatGPT → 「바꾼 대로 적용」). 한쪽이 잘 안 되면 빼고 진행할 수 있고, 나중에 더할 수도 있습니다.
• 로그인이 실패하면 2분을 기다리지 않고 바로 「다시 로그인」을 누를 수 있습니다.
• IRIS 창(Face 2.73.0): 아직 일하고 있는 세션을 "작업이 끝났습니다"로 잘못 알리던 일을 막고, 상태 전환을 기록으로 남깁니다.

적용 방법

• 이미 설치된 PC: zip 을 받아 실행 → 「업데이트 시작」(또는 IRIS 창 설정 → 업데이트).
• 새 PC: IRIS-설치.cmd 두 번 클릭.

첨부: zip · .sha256 · .sha256.sig(공식 서명). 미러: iris-workspace.com 내려받기 단추.

sha256: 68fb5435cfc253750edea0799fac63490873e6f1631d7e35903d4526d60c38c0 IRIS-Setup_v2.0.33_2026-09-21.zip

IRIS Installer v2.0.32

IRIS 설치 패키지 2.0.32 (2026-09-20)

고침

• IRIS 창(Face 2.72.0): 대화 화면에 요청문 앞뒤로 보이던 <pasted_content id="…"> 표식을 지웠습니다.
• TeamClaude 대시보드: 구역 안 계정을 이름순으로 보입니다.
• TeamClaude 대시보드: 「+ 계정」 로그인이 끝나면 결과(추가됨 / 이미 있는 계정이라 갱신만 / 실패 이유)를 화면 알림으로 보입니다. 로그인 콘솔 창은 더 띄우지 않습니다.

적용 방법

• 이미 설치된 PC: zip 을 받아 실행 → 「업데이트 시작」(또는 IRIS 창 설정 → 업데이트).
• 새 PC: IRIS-설치.cmd 두 번 클릭.

첨부: zip · .sha256 · .sha256.sig(공식 서명). 미러: iris-workspace.com 내려받기 단추.

IRIS Installer v2.0.31

IRIS 설치 패키지 2.0.31 (2026-09-20)

재발 방지

• 업그레이드 게이트(verify/upgrade.mjs) 신설: 직전 판을 연습용 루트에 설치한 뒤 새 판을 --auto 로 얹어 부품 전부 제자리·실행 파일 문법·인수 문서를 판정합니다. 릴리스 문 앞 검사에 포함. (2.0.28→2.0.29 회귀를 재현해 잡는 것을 확인)

고침

• TeamClaude 대시보드: 계정을 추가하면 CLAUDE/CODEX 구역이 하나 더 생기던 것 → 제공자별 한 구역에 모아 보입니다.
• 전환 임계점 기본값 98% → 100%. 이미 설치된 PC 도 「업데이트」 때 0.98(기본값 그대로인 경우만)을 100% 로 올립니다.
• 검사 12·13 이 연습(오프라인) 실행에서 살아 있는 중계기를 두드리던 것을 막았습니다(설치기 자체 시험 안정화).

적용 방법

• 이미 설치된 PC: zip 을 받아 실행 → 「업데이트 시작」. 창이 다시 열리면 대시보드 구역과 임계점(100%)이 바뀌어 있습니다.
• 새 PC: IRIS-설치.cmd 두 번 클릭.

첨부: zip · .sha256 · .sha256.sig(공식 서명). 미러: iris-workspace.com 내려받기 단추.

IRIS Installer v2.0.30

IRIS Installer v2.0.30 (2026-09-20)

• 한도 화면의 ChatGPT(코덱스) 계정이 "CODEX" 대신 로그인한 이메일로 표시됩니다. 새로 설치하면 처음부터, 이미 설치된 PC 는 업데이트(또는 다음 계정 연결) 뒤 자동으로 바뀝니다.
• 홈페이지 설치 안내에 「그래도 안 되면 — 깨끗이 지우고 새로 설치」 절을 더했습니다(복사해서 쓸 수 있는 명령 포함).

이미 설치된 PC 에서

이 zip 을 받아 실행 → 「업데이트 시작」. IRIS 창의 설정 → 「업데이트」로도 됩니다. 2.0.x 어느 판에서든 삭제 없이 됩니다.

1.x 사용자

2.0 부터 설치 방식이 바뀌어 새로 설치해야 합니다. 기존 자료는 그대로 두고 설치기를 실행하면 됩니다.

IRIS Installer v2.0.29

IRIS Installer v2.0.29 (2026-09-20)

• 한도 화면에서 ChatGPT(코덱스) 계정을 추가하면 바로 나타납니다. 코덱스 로그인은 설정만 저장하고 돌아가는 중계기에 알리지 않아, 재시작 전까지 계정이 안 보였습니다(클로드는 바로 보였음). 중계기 프로그램을 고쳐 로그인 뒤 곧바로 다시 읽게 했고, 한도 화면도 로그인 창이 닫히면 한 번 더 읽습니다.
• 2.0.28 의 변경(계정 없는 공급자의 429 행 숨김)은 그대로 들어 있습니다.

이미 설치된 PC 에서

이 zip 을 받아 실행 → 「업데이트 시작」. IRIS 창의 설정 → 「업데이트」로도 됩니다. 2.0.x 어느 판에서든 삭제 없이 됩니다.

1.x 사용자

2.0 부터 설치 방식이 바뀌어 새로 설치해야 합니다. 기존 자료는 그대로 두고 설치기를 실행하면 됩니다.