IeumOffice
English
Download

AI connection help

Connect an AI

The AI in IeumOffice runs on the Claude or ChatGPT subscription you already use. Without a subscription, you can connect a free AI. Pick what fits you below, and a pointer moves across the screen to show you where to click.

Which AI do you already use?

The connection screen is in three places: the Connect an AI step of the guide shown at first launch, the AI panel while no AI is connected, and Settings → AI at the bottom left of Home. Wherever you start, the steps are the same.

Claude subscription

Connect with a Claude subscription

You need a Claude Pro or Max plan. A free Claude account cannot connect. IeumOffice gets its answers through the Claude Code program installed on your PC, so the first time you install that program and sign in. No API key is needed.

  1. When the AI panel shows "Which AI do you already use?", click I pay for Claude.
  2. If the card says "Not installed", click Install. A new window opens and Anthropic's official installation runs by itself.
  3. When the text in that window stops moving, the installation is done. Close the window and come back to IeumOffice; the card changes to "Not signed in".
  4. Click Sign in and a browser opens. Sign in with the Claude account that has the subscription and click Authorize.
  5. Back in IeumOffice, the connection guide disappears and a box for typing appears. When you see Automatic · Claude below it, you are done.

If Claude Code is already installed and in use, you see "Not signed in" or "Connected" right after step 1. If the browser does not open, see Stuck at "Signing in…".

The screens are simplified redrawings for illustration. Depending on its language setting, the browser's sign-in page shows the button as Authorize, Allow or Approve.

ChatGPT

Connect with a ChatGPT plan

ChatGPT connects directly in IeumOffice, with no program to install. Sign in on the ChatGPT sign-in page that opens in your browser and allow this app to use your plan, and that's it. The free plan connects too, but it allows only a little use, so it stops soon. This works from IeumOffice 0.12.8.

  1. When the AI panel shows "Which AI do you already use?", click I use ChatGPT.
  2. If the card says "Not signed in", click Continue with ChatGPT. A ChatGPT sign-in page opens in your browser.
  3. Sign in with the ChatGPT account you use, and allow this app to use your ChatGPT plan. When the browser shows Connected, close that tab.
  4. Back in IeumOffice, the connection guide disappears and a box for typing appears. When you see Automatic and the name of the model in use below the box, you are done.

Once connected, the ChatGPT card in Settings → AI gets a Manage usage button. It opens the usage page in ChatGPT's settings, where you can see how much this app has used or set a limit for this app alone. To disconnect, click Sign out on the same card. Only this app's connection ends; other programs on this PC stay as they are.

The screens are simplified redrawings for illustration. The browser's sign-in page belongs to OpenAI, so its real look and button names may differ. Agent mode and the terminal command don't use the directly connected ChatGPT. To use your ChatGPT plan there too, connect through the Codex program as shown below.

ChatGPT · Codex

Connect through the Codex program

If you already use OpenAI's Codex program on this PC, you can connect through Codex. If you don't have it yet, install it the first time and sign in with your ChatGPT account. Up to IeumOffice 0.12.7, clicking I use ChatGPT goes straight to this Codex card.

  1. When the AI panel shows "Which AI do you already use?", click I use ChatGPT.
  2. Below the ChatGPT card, click Already use the Codex program on this PC? Connect with Codex, and it changes to the Codex card.
  3. If the card says "Not installed", click Install. A new window opens and OpenAI's official installation runs.
  4. When the text in that window stops moving, the installation is done. Close the window and come back to IeumOffice; the card changes to "Not signed in".
  5. Click Sign in and a browser opens. Sign in with the ChatGPT account you use and keep clicking through as the pages guide you.
  6. When the browser says the sign-in is complete, come back to IeumOffice. When you see Automatic and the name of the model in use below the box for typing, you are done.

If Codex is already connected, you see the Codex card from the start. If the install window asks a question with a line like [Y] Yes [N] No, press Y on the keyboard and then Enter. That is Windows asking you to accept the terms the first time it downloads a program. If you change your mind, click Connect directly in the app, without Codex below the Codex card to go back to the direct way.

The screens are simplified redrawings for illustration. Wherever you can choose Codex in IeumOffice, a notice says "Using a Codex subscription inside an app is not a method officially recommended by OpenAI." Keep that in mind when you choose it.

Free AI

No subscription? Use a free AI

Even without a subscription, you can connect a free AI from OpenRouter or Google Gemini and use it right away. It is weaker than the subscription models, and the number of requests you can send per day is limited. The simplest is OpenRouter, which takes one button.

  1. When the AI panel shows "Which AI do you already use?", click Neither yet.
  2. Click Connect a free AI, and "Use for free" opens in Settings.
  3. On the OpenRouter card, click Connect in browser. In the browser, sign up or sign in to OpenRouter and click Allow.
  4. When the browser says you are connected, close that tab and come back. The card shows Connected · in use and how many free requests are left today.

If you choose Neither yet in the guide shown at first launch, these cards open right there, without step 2.

Connecting Google Gemini
  1. Click Get a key on the Gemini card, and Google AI Studio opens. Sign in with your Google account, create a key, and copy it.
  2. Come back to IeumOffice, paste it into the "Paste your Gemini key" box, and click Connect.

Only people aged 18 or older can use it. A key made in a Google project with billing turned on can be charged, so make the key in a project without billing.

While you use it for free, what you send may be used to improve that company's AI. Take care with documents that hold personal information. When today's allowance is used up, the AI panel tells you so, and when you can use it again.

If you get stuck

When connecting gets stuck

Find the words you see on the card and open that item.

Stuck at "Signing in…"

If a sign-in page is open in your browser, sign in there and allow access. It's fine if it takes a while. In that case, don't click the link below the card or the Open the sign-in window button. Doing so stops the sign-in in progress and starts over.

If no browser opened at all, do this.

  1. Click the link below the card, or the Open the sign-in window button that appears after 25 seconds. A black window opens. If a browser opens now, sign in there and allow access. The window closes by itself and you are connected.
  2. If the browser still doesn't open, drag over the address in the black window that starts with https:// to select it, and right-click to copy it. Paste it into the browser's address bar, and the sign-in page opens.
  3. After you sign in and allow access, the browser shows a code. Copy the whole code. If there is a copy button, use it.
  4. Right-click once inside the black window to paste, and press Enter. It's normal that the pasted code doesn't show in the window.
  5. When the window closes and the card changes to "Connected", you are done.

If the window says Invalid code, the code was not copied in full. There is a # in the middle of the code, and both the part before and after it must be included. Don't close the window; copy the code again and paste it into the same window.

To start over, click Cancel sign-in on the card and then click Sign in again.

The ChatGPT card (direct connection) has no black sign-in window. Finish signing in and allowing access in the browser. If no browser opened, or you want to try again, click Cancel sign-in and then Continue with ChatGPT again.

"The sign-in did not finish" appears

This notice appears when the browser stops after showing only a code, without finishing the sign-in. That code has to be pasted into the sign-in window, not into the app. A code already shown cannot be used again, so sign in again from the start.

  1. Click the Open the sign-in window button on the card. A black sign-in window opens. To try with the browser again instead of the window, click Sign in in the browser instead.
  2. Sign in in the browser as in steps 2 to 5 of Stuck at "Signing in…" above, then paste the code you get into that window.

A card that is not signed in yet also has a Browser showed a code? link, so you can sign in through this window from the start. This sign-in window works on Windows only (from IeumOffice 0.12.7).

If the ChatGPT card says "The sign-in did not finish", you either did not allow this app to use your ChatGPT plan, or did not finish signing in within 10 minutes. No sign-in window is needed: click Continue with ChatGPT again to start over.

"The program is too old" appears

The Claude Code or Codex on your PC is an old version. Click Update on the card, and that company's official update runs in a new window. When the update has finished in that window, come back to IeumOffice. The app checks again by itself.

If the card also shows "The file this app runs", that exact file is the one to update. Updating a copy installed in WSL (Ubuntu) or in another folder does not change this file. If there is no Update button, run the command written on the card in Windows PowerShell.

"Signed in, but not with a subscription" appears

The program is signed in not with a subscription account but with an API key or a pay-as-you-go account. If you click Use anyway, that account is charged for every request. Until you click it, IeumOffice does not use that connection.

To use your subscription, click Sign in with another account on the card in Settings → AI, sign in again with the account that has the subscription, and click Check again.

"The connection could not be checked" appears

The program did not answer in time, or something went wrong during the check. Wait a moment and click Check again. On a PC that reaches the internet through a proxy, as at many companies and schools, first check in PowerShell whether claude or codex works. If it doesn't work there, it won't work in IeumOffice either.

I only have a free Claude account

Claude connects only with a Pro or Max plan. Signing in with a free account doesn't connect. If you don't plan to subscribe, connect a free AI. Click Choose another way on the card to go back to the first question.

Connecting on a Mac Beta

On a Mac, the card shows Official install guide instead of an Install button. Click it to open that company's installation instructions, and install Claude Code or Codex in Terminal as written there. After installing, come back to IeumOffice; the card changes to "Not signed in", and from there it is the same as on Windows. Click Sign in and sign in in the browser.

If it says the version is too old, run the update command written on the card in Terminal.

When you connect ChatGPT directly, there is no program to install, so the steps on a Mac are the same as on Windows.

If it still doesn't work, click Copy details for help near the bottom of the connection screen, then paste it into Send feedback and send it. Only the connection status and program versions are copied; no account and no file paths.

IeumOffice does not read or store the sign-in data of Claude Code or Codex. You sign in only in that company's program and web pages, and IeumOffice never sees your ChatGPT password either. If you connect ChatGPT directly, it keeps on this PC only the one sign-in OpenAI issued to this app (encrypted on Windows), and when you disconnect, it asks OpenAI to end the connection and then deletes it. When the subscription limit is used up, it only stops and tells you; it never switches to a paid connection by itself.