Install Forge Code

Requirements

• Node.js 22 or later (node --version)
• Git, for diffs, branches and /teleport cloud
• Windows, macOS or Linux. On Windows, Forge uses PowerShell, or Git Bash when it’s installed.
• A Forge account. You can create one, free, the first time you start Forge Code.

Install

npm install -g https://forge-code-site.pages.dev/download/forge-code.tgz

Check it with forge --version.

Sign in

Start Forge Code in any project:

cd my-project
forge

The first time, Forge Code asks you to sign in:

1. Press Enter. Your browser opens the Forge console.
2. Sign in, or create an account with your email, Google or GitHub.
3. Check that the code in the browser matches the one in your terminal, then click Authorize.
4. Go back to the terminal: Forge Code has already continued, signed in.

Your login is saved on this computer. forge logout (or /logout → Forge Cloud) signs you out; forge login signs in again without starting a session, which is handy over SSH.

First steps

• Usage counts against your plan. To bill a provider directly instead, add your own key with /login. See Model providers.
• /init writes a FORGE.md with your build commands and conventions; Forge reads it at the start of every session.
• /help lists commands and keyboard shortcuts. /doctor checks your setup.

Run without the interface

forge -p "<prompt>" runs one task and prints the result, for scripts and CI:

forge -p "summarize the changes on this branch" --model sonnet

It uses the login saved on this computer. In CI, set FORGE_CLOUD_TOKEN instead (create one in the console under Tokens).