What you will learn Two prerequisites and how to install and verify each. Get stuck here and you cannot move on.
If Node.js or the terminal are new to you, start with Programs and languages and The terminal and commands.
| Prerequisite | Why it is needed |
|---|---|
| One agent CLI | what HyperTeams directs |
| Node.js | what HyperTeams runs on |
HyperTeams drives the three below. One of them is enough.
| Agent | Command | Sign-in |
|---|---|---|
| Claude Code | claude | Claude subscription or API key |
| ChatGPT Codex | codex | ChatGPT subscription |
| Antigravity | agy | Google account |
Install more than one and you can pick per job, with a default engine per folder. Starting out, install the one whose subscription you already pay for.
The install command (next chapter) only fetches Claude Code for you. For the other two it prints a one-line install instead: how they are distributed varies by machine, and a one-line instruction beats an install that half succeeds.
After installing, run it once and log in.
It installs through npm, so Node.js has to come first (section 2 below).
codex login opens a browser and asks for your ChatGPT account.
Run it once and sign in with your Google account.
HyperTeams uses this login directly. Log in here and you will never need to enter a key into HyperTeams.
A version number from whichever one you installed means you are ready.
If you get
command not found, the terminal that was already open when you installed has not picked up the change. Open a new terminal window and try again.
Get the LTS version from nodejs.org. LTS means "long term support" and is the stable line.
Run the installer and accept the defaults.
One agent plus Node.js; if both print a version you can move on.
On Codex or Antigravity, swap the first command for codex --version or
agy --version.
Nine times out of ten, opening a new terminal fixes it. The installer changes your path settings, and an already-open terminal does not know about the change.
If that does not work, restart the computer.
PowerShell's security settings. Open PowerShell as administrator and try again, or if it is a work machine, ask your IT team.
You will need help from IT. When asking, explain it like this:
"I need Node.js LTS and one AI agent CLI — Claude Code, ChatGPT Codex or Antigravity. All are development tools, distributed officially from nodejs.org, claude.ai, npm and antigravity.google."
That is unrelated to HyperTeams. You have to resolve that agent's own login first.
1. Why do you not need to enter an API key into HyperTeams?
Because it uses the agent's login directly. That is why running claude (or
codex login, or agy) once after installing, to log in, is an important step.
2. Do you have to install all three agents?
No — one is enough. Installing several lets you pick per job and set a default engine per folder, but getting started takes only one.
3. What command confirms you can move on?
claude --version && node --version — one agent and Node.js both printing a
version means you are ready. On Codex or Antigravity, swap the first for
codex --version or agy --version.
With that ready, installing is one line → Installing
# macOS / Linuxcurl -fsSL https://claude.ai/install.sh | bash# Windows PowerShellirm https://claude.ai/install.ps1 | iexclaudenpm i -g @openai/codexcodex login# macOS / Linuxcurl -fsSL https://antigravity.google/cli/install.sh | bash# Windows PowerShellirm https://antigravity.google/cli/install.ps1 | iexagyclaude --version # orcodex --version # oragy --version✓ prints a version → good✗ command not found → not installed, or you need a fresh terminalnode --version✓ v20.x.x or higher → good✗ command not found → open a new terminal after installingclaude --version && node --version