Initial Setup

After you install Codex, launch the desktop app from your applications menu or desktop shortcut. The first launch may take longer than later launches because Codex checks for required extensions and installs any missing core extensions from Open VSX.

First Launch Checklist

1. Open Codex.
2. Approve operating-system prompts, such as opening an unsigned app or allowing microphone access for audio workflows.
3. Wait for the startup screen to finish loading.
4. If Codex asks to reload after extension setup, allow the reload.
5. Sign in or create an account.

Codex includes built-in app components that install and manage the translation extensions. If a team project requires specific extension versions, Codex may switch into a pinned profile and reload before the project opens.

Create an Account

1. On the startup screen, choose the option to create a new account.
2. Enter a username, email address, and password.
3. Click Register.
4. After registration, Codex signs you in automatically.

Username

• Usernames must be unique.
• Usernames are case-sensitive.
• You can also use your email address when logging in.
• Usernames cannot be changed after account creation.

Email Address

Use an email address you can access. Password resets are sent by email, so fake or inaccessible addresses can lock you out of your account.

Password

Passwords must:

• Be at least 15 characters long.
• Avoid using parts of your username or email address.

Sign In Later

When you need to sign in manually:

1. Open Codex.
2. Enter your username or email address.
3. Enter your password.
4. Click Login.

Your session normally persists across app restarts. You may be asked to sign in again after a token expires, after clearing app data, or when opening a project that needs cloud access.

What To Do Next

1. Create a project if you are starting new work.
2. Open or download a project if your team has already shared one.
3. Import source files when your project is ready.