AI 연결 도움말
AI 연결하기
이음오피스의 AI는 지금 쓰고 있는 Claude나 ChatGPT 구독으로 돌아갑니다. 구독이 없으면 무료 AI를 연결하면 됩니다. 아래에서 나에게 맞는 것을 고르면, 어디를 누르는지 마우스가 직접 움직이며 보여 드립니다.
지금 쓰고 있는 AI가 있나요?
연결 화면은 세 곳에 있습니다. 처음 실행할 때 나오는 안내의 AI 연결 단계, 아무 AI도 연결되지 않은 AI 창, 그리고 홈 왼쪽 아래의 설정 → AI입니다. 어디서 시작해도 순서는 같습니다.
Claude 구독
Claude 구독으로 연결하기
Claude Pro나 Max 요금제가 있어야 합니다. 무료 Claude 계정으로는 연결되지 않습니다. 이음오피스는 PC에 설치한 Claude Code 프로그램을 통해 답을 받아 오므로, 처음 한 번 그 프로그램을 설치하고 로그인합니다. API 키는 필요 없습니다.
- AI 창에 "지금 쓰고 있는 AI가 있나요?"가 보이면 Claude 유료 구독이 있어요를 누릅니다.
- 카드에 "설치되지 않음"이 보이면 설치를 누릅니다. 새 창이 열리고 Anthropic의 공식 설치가 저절로 진행됩니다.
- 창의 글이 멈추면 설치가 끝난 것입니다. 창을 닫고 이음오피스로 돌아오면 카드가 "로그인 필요"로 바뀝니다.
- 로그인을 누르면 브라우저가 열립니다. 구독 중인 Claude 계정으로 로그인하고 허용을 누릅니다.
- 이음오피스로 돌아오면 연결 안내가 사라지고 글을 적는 칸이 나옵니다. 아래에 자동 · Claude가 보이면 끝입니다.
이미 Claude Code를 설치해 쓰고 있다면 1단계 다음에 바로 "로그인 필요"나 "연결됨"이 보입니다. 브라우저가 열리지 않으면 "로그인하는 중…"에서 멈춰요를 보세요.
화면은 설명을 위해 간단히 다시 그린 것입니다. 브라우저의 로그인 화면은 언어 설정에 따라 단추 이름이 허용, 승인, Authorize 가운데 하나로 보입니다.
ChatGPT
ChatGPT 요금제로 연결하기
ChatGPT는 프로그램을 설치하지 않고 이음오피스에서 바로 연결합니다. 브라우저에 열리는 ChatGPT 로그인 화면에서 로그인하고, 이 앱이 요금제를 쓰도록 허용하면 끝납니다. 무료 요금제도 연결은 되지만 쓸 수 있는 양이 적어서 금방 멈춥니다. 이음오피스 0.12.8부터 됩니다.
- AI 창에 "지금 쓰고 있는 AI가 있나요?"가 보이면 ChatGPT를 써요를 누릅니다.
- 카드에 "로그인 필요"가 보이면 ChatGPT로 계속을 누릅니다. 브라우저에 ChatGPT 로그인 화면이 열립니다.
- 쓰고 있는 ChatGPT 계정으로 로그인하고, 이 앱이 ChatGPT 요금제를 쓰도록 허용합니다. 브라우저에 연결됨이 나오면 그 탭을 닫습니다.
- 이음오피스로 돌아오면 연결 안내가 사라지고 글을 적는 칸이 나옵니다. 칸 아래에 자동과 쓰는 모델 이름이 보이면 끝입니다.
연결한 뒤에는 설정 → AI의 ChatGPT 카드에 사용량 관리가 생깁니다. 누르면 ChatGPT 설정의 사용량 화면이 열려, 이 앱이 쓴 양을 보거나 이 앱만 쓸 수 있는 한도를 정할 수 있습니다. 연결을 끊으려면 같은 카드의 로그아웃을 누릅니다. 이 앱의 연결만 끊기고, 이 PC의 다른 프로그램은 그대로입니다.
화면은 설명을 위해 간단히 다시 그린 것입니다. 브라우저의 로그인 화면은 OpenAI의 것이라 실제 모양과 단추 이름이 다를 수 있습니다. 에이전트 모드와 터미널 명령어는 바로 연결한 ChatGPT를 쓰지 않습니다. 그쪽에서도 ChatGPT 요금제를 쓰려면 아래처럼 Codex 프로그램으로 연결하세요.
ChatGPT · Codex
Codex 프로그램으로 연결하기
이 PC에서 OpenAI의 Codex 프로그램을 이미 쓰고 있다면 Codex로 연결해도 됩니다. 아직 없다면 처음 한 번 설치하고 ChatGPT 계정으로 로그인합니다. 이음오피스 0.12.7까지는 ChatGPT를 써요를 누르면 바로 이 Codex 카드가 나옵니다.
- AI 창에 "지금 쓰고 있는 AI가 있나요?"가 보이면 ChatGPT를 써요를 누릅니다.
- ChatGPT 카드 아래의 이 PC에서 Codex 프로그램을 이미 쓰고 있나요? Codex로 연결을 누르면 Codex 카드로 바뀝니다.
- 카드에 "설치되지 않음"이 보이면 설치를 누릅니다. 새 창이 열리고 OpenAI의 공식 설치가 진행됩니다.
- 창의 글이 멈추면 설치가 끝난 것입니다. 창을 닫고 이음오피스로 돌아오면 카드가 "로그인 필요"로 바뀝니다.
- 로그인을 누르면 브라우저가 열립니다. 쓰고 있는 ChatGPT 계정으로 로그인하고 안내대로 계속 누릅니다.
- 브라우저에 로그인이 끝났다는 화면이 나오면 이음오피스로 돌아옵니다. 글을 적는 칸 아래에 자동과 쓰는 모델 이름이 보이면 끝입니다.
Codex가 이미 연결되어 있으면 처음부터 Codex 카드가 보입니다. 설치 창에 [Y] Yes [N] No처럼 묻는
줄이 나오면 키보드로 Y를 누르고 Enter를 누릅니다. Windows가 처음 프로그램을 받을 때 약관 동의를
묻는 것입니다. 마음이 바뀌면 Codex 카드 아래의 Codex 없이 앱에서 바로 연결을 눌러
바로 연결하는 길로 돌아갑니다.
화면은 설명을 위해 간단히 다시 그린 것입니다. 이음오피스에서 Codex를 고를 수 있는 곳에는 "앱에서 Codex 구독을 쓰는 것은 OpenAI가 공식 권장하는 방식이 아닙니다"라는 안내가 함께 보입니다. 이 점을 알고 고르세요.
무료 AI
구독이 없으면 무료 AI로
구독이 없어도 OpenRouter나 Google Gemini의 무료 AI를 연결해 바로 쓸 수 있습니다. 구독 모델보다 약하고 하루에 보낼 수 있는 요청 수에 한도가 있습니다. 가장 간단한 것은 버튼 한 번으로 끝나는 OpenRouter입니다.
- AI 창에 "지금 쓰고 있는 AI가 있나요?"가 보이면 아직 없어요를 누릅니다.
- 무료 AI 연결하기를 누르면 설정의 "무료로 쓰기"가 열립니다.
- OpenRouter 카드의 브라우저로 연결을 누릅니다. 브라우저에서 OpenRouter에 가입하거나 로그인한 뒤 허용을 누릅니다.
- 브라우저에 연결됐다는 화면이 나오면 그 탭을 닫고 돌아옵니다. 카드에 연결됨 · 사용 중과 오늘 남은 무료 요청 수가 보입니다.
처음 실행할 때 나오는 안내에서 아직 없어요를 고르면 2단계 없이 이 카드들이 그 자리에 바로 펼쳐집니다.
Google Gemini로 연결할 때
- Gemini 카드의 키 만들기를 누르면 Google AI Studio가 열립니다. Google 계정으로 로그인해 키를 만들고 복사합니다.
- 이음오피스로 돌아와 "Gemini 키를 붙여넣으세요" 칸에 붙여 넣고 연결을 누릅니다.
18세 이상만 쓸 수 있습니다. 결제가 연결된 Google 프로젝트에서 만든 키는 요금이 나갈 수 있으니, 결제를 연결하지 않은 프로젝트에서 만드세요.
무료로 쓰는 동안 보낸 내용은 그 회사의 AI 개선에 쓰일 수 있습니다. 개인정보가 담긴 문서는 주의하세요. 오늘 쓸 수 있는 양을 다 쓰면 AI 창이 그 사실과 다시 쓸 수 있는 시각을 알려 줍니다.
막혔을 때
연결하다 막혔을 때
카드에 보이는 말을 찾아 펼쳐 보세요.
"로그인하는 중…"에서 멈춰요
브라우저에 로그인 화면이 떠 있다면 거기서 로그인하고 허용을 누르면 됩니다. 시간이 걸려도 괜찮습니다. 이때는 카드 아래의 링크나 로그인 창 열기 단추를 누르지 마세요. 누르면 하던 로그인이 멈추고 처음부터 다시 시작합니다.
브라우저가 아예 열리지 않았다면 이렇게 합니다.
- 카드 아래의 링크나, 25초가 지나면 나오는 로그인 창 열기 단추를 누릅니다. 검은 창이 하나 열립니다. 이때 브라우저가 열리면 거기서 로그인하고 허용을 누르세요. 창이 저절로 닫히고 연결됩니다.
- 브라우저가 그래도 열리지 않으면, 검은 창에 나온 https://로 시작하는 주소를 마우스로 끌어 선택하고 마우스 오른쪽 단추를 눌러 복사합니다. 브라우저 주소 칸에 붙여 넣으면 로그인 화면이 열립니다.
- 로그인하고 허용을 누르면 브라우저에 코드가 나옵니다. 코드 전체를 복사합니다. 복사 단추가 있으면 그것을 누르세요.
- 검은 창 안에서 마우스 오른쪽 단추를 한 번 눌러 붙여 넣고 Enter를 누릅니다. 붙여 넣은 코드가 창에 보이지 않아도 정상입니다.
- 창이 닫히고 카드가 "연결됨"으로 바뀌면 끝입니다.
창에 Invalid code가 나오면 코드가 덜 복사된 것입니다. 코드 가운데에 #이 있는데, 그 앞뒤가
모두 들어가야 합니다. 창을 닫지 말고 코드를 다시 복사해 같은 창에 붙여 넣으세요.
처음부터 다시 하려면 카드의 로그인 취소를 누르고 로그인을 다시 누릅니다.
ChatGPT 카드(바로 연결)에는 검은 로그인 창이 없습니다. 브라우저에서 로그인하고 허용까지 마치세요. 브라우저가 열리지 않았거나 다시 하고 싶으면 로그인 취소를 누른 뒤 ChatGPT로 계속을 다시 누릅니다.
"로그인이 끝나지 않았습니다"가 나와요
브라우저가 로그인을 마치지 않고 코드만 보여 준 채 멈추면 이 안내가 나옵니다. 그 코드는 앱이 아니라 로그인 창에 붙여 넣어야 합니다. 이미 나온 코드는 다시 쓸 수 없으니 처음부터 다시 로그인합니다.
- 카드의 로그인 창 열기 단추를 누릅니다. 검은 로그인 창이 열립니다. 창 대신 브라우저로 다시 해 보려면 브라우저에서 다시 로그인을 누릅니다.
- 위 "로그인하는 중…"에서 멈춰요의 2~5번처럼 브라우저에서 로그인한 뒤, 나온 코드를 그 창에 붙여 넣습니다.
아직 로그인하지 않은 카드에도 브라우저에 코드가 나왔나요? 링크가 있어서, 처음부터 이 창으로 로그인할 수 있습니다. 이 로그인 창은 Windows에서만 쓸 수 있습니다(이음오피스 0.12.7부터).
ChatGPT 카드에서 "로그인이 끝나지 않았습니다"가 나오면, 이 앱이 ChatGPT 요금제를 쓰도록 허용하지 않았거나 10분 안에 로그인을 마치지 못한 것입니다. 로그인 창은 필요 없고, ChatGPT로 계속을 다시 누르면 처음부터 시작합니다.
"프로그램 버전이 낮습니다"가 나와요
PC에 있는 Claude Code나 Codex가 오래된 버전입니다. 카드의 업데이트를 누르면 그 회사의 공식 업데이트가 새 창에서 실행됩니다. 창에서 업데이트가 끝나면 이음오피스로 돌아오세요. 앱이 저절로 다시 확인합니다.
카드에 "이 앱이 실행하는 파일"이 함께 나오면, 바로 그 파일을 업데이트해야 합니다. WSL(Ubuntu)이나 다른 폴더에 설치된 사본을 업데이트해도 이 파일은 바뀌지 않습니다. 업데이트 단추가 없다면 Windows PowerShell에서 카드에 적힌 명령을 실행합니다.
"구독이 아닌 방식으로 로그인됨"이 보여요
프로그램이 구독 계정이 아니라 API 키나 쓴 만큼 요금을 내는 계정으로 로그인되어 있습니다. 이때 그래도 사용을 누르면 요청할 때마다 그 계정에 요금이 나갑니다. 누르기 전에는 이음오피스가 그 연결을 쓰지 않습니다.
구독으로 쓰려면 설정 → AI의 카드에서 다른 계정으로 로그인을 누르고, 구독 중인 계정으로 다시 로그인한 뒤 다시 확인을 누릅니다.
"연결을 확인하지 못했습니다"가 나와요
프로그램이 제때 답하지 않았거나 확인하는 중에 문제가 생긴 경우입니다. 잠시 뒤 다시 확인을 누릅니다.
회사나 학교처럼 프록시를 거쳐 인터넷에 나가는 PC라면, PowerShell에서 claude나
codex가 되는지 먼저 확인해 보세요. 거기서 안 되면 이음오피스에서도 안 됩니다.
Claude 무료 계정밖에 없어요
Claude는 Pro나 Max 요금제여야 연결됩니다. 무료 계정으로 로그인하면 연결되지 않습니다. 구독할 생각이 없다면 무료 AI를 연결하세요. 카드의 다른 방법 고르기를 누르면 처음 질문으로 돌아갑니다.
Mac에서 연결할 때 베타
Mac에서는 카드에 설치 단추 대신 공식 설치 안내가 나옵니다. 누르면 그 회사의 설치 설명이 열리니, 거기 적힌 대로 터미널에서 Claude Code나 Codex를 설치합니다. 설치한 뒤 이음오피스로 돌아오면 카드가 "로그인 필요"로 바뀌고, 그다음은 Windows와 같습니다. 로그인을 누르고 브라우저에서 로그인하면 됩니다.
오래된 버전이라고 나오면 터미널에서 카드에 적힌 업데이트 명령을 실행합니다.
ChatGPT를 바로 연결할 때는 설치할 프로그램이 없어서 Mac에서도 Windows와 순서가 같습니다.
그래도 안 되면 연결 화면 아래쪽의 도움 요청용 정보 복사를 누른 뒤, 의견 보내기에 붙여 넣어 보내 주세요. 연결 상태와 프로그램 버전만 복사되고, 계정과 파일 경로는 들어가지 않습니다.
이음오피스는 Claude Code나 Codex의 로그인 정보를 읽거나 저장하지 않습니다. 로그인은 그 회사의 프로그램과 웹 페이지에서만 하고, ChatGPT 비밀번호도 이음오피스가 보지 않습니다. ChatGPT를 바로 연결하면 OpenAI가 이 앱에 내준 로그인 하나만 이 PC에 두고(Windows에서는 암호화해 둡니다), 연결을 끊으면 OpenAI에 연결 종료를 요청한 뒤 지웁니다. 구독 한도를 다 쓰면 요청을 멈추고 알릴 뿐, 요금이 나가는 연결로 저절로 바꾸지 않습니다.