Install and set up REDagent
There are three things to do: get an API key from Anthropic, put REDagent in the game, and go through its first start. Allow about twenty minutes.
| On this page | |
|---|---|
| 1. Get an Anthropic API key | The key that lets REDagent use Claude |
| 2. Install REDnode and REDagent | With a mod manager or by hand |
| 3. First start | The download, the permission, the key |
| Updating, Removing | And where REDagent keeps things |
1. Get an Anthropic API key
An API key is a long password that lets a program use Claude on your account. REDagent comes with no key of its own: it uses yours, and Anthropic bills you for what it uses. A Claude.ai plan can’t be used instead.
- Go to console.anthropic.com and make an account, or sign in.
- Buy some credit, under Billing. A few dollars is plenty to start: in REDagent’s tests, a small mod cost well under a dollar. See what it costs.
- Under API keys, create a key. Give it a name you’ll recognise, such as “REDagent”.
- Copy the key at once and keep it somewhere safe until the first start. Anthropic shows it only this one time. It starts with
sk-ant-.
Treat the key like a password: anyone who has it can spend your credit.
2. Install REDnode and REDagent
REDagent runs inside REDnode, so REDnode goes in first.
- Install REDnode 0.50.2 or later, and check it worked.
- Download REDagent from Nexus Mods or GitHub. The file is
REDagent-<version>.zip. - With the game closed, install it one of these ways:
| With | Do this |
|---|---|
| EDGEdeck or Vortex | Add the zip as you would any mod, and deploy |
| By hand | Extract the zip into your Cyberpunk 2077 folder |
Either way, REDagent ends up in red4ext\plugins\REDnode\apps\redagent in the game folder. That apps folder is where REDnode keeps every mod it runs, and where REDagent will put the mods it writes for you.
3. First start
Start the game, load a save and press F10. A mouse cursor appears, and REDagent’s window is on the right of the screen.
REDnode calls this interactive mode: its windows show, and they take your mouse and keyboard. Press Esc to go back to playing. REDagent’s window hides while you play, and comes back with F10. Careful with F9, the key beside F10: it is the game’s Quick Load. More in F10 and the three modes.
Get the Agent SDK
Press Get the Agent SDK in REDagent’s window and wait. This downloads the Claude Agent SDK, Anthropic’s software that REDagent runs on: about 140 MB, from Anthropic’s own packages. It happens once. REDagent checks the download before using it, and throws away one that is incomplete or doesn’t match.
Allow REDnode’s tools
REDagent needs your permission to see the game:
- Click the REDNODE tab to open the launcher, and switch on Mod Manager, the first entry.
- Select REDagent in its table.
- Under its permissions, switch Allowed on for “REDnode’s tools for AI agents”.
Without this, REDagent can chat and read your mods’ files, but it can’t see the mod log, the game or any window, so it can’t check its own work.
While you’re there, Pin to launcher gives REDagent its own entry in the launcher, so you can show and hide its window in one click. It’s optional.
Give it your key
Press Set up the key in REDagent. REDnode’s Key request window opens. Copy your key, click the box in that window, press Ctrl+V, then Allow.
REDnode now keeps the key, encrypted for your Windows account, and shares it with the EDGE tools you allow. If REDnode already has an Anthropic key, from its Settings or from another EDGE tool, REDagent only asks you to allow it.
Check it worked
The chat appears. Type a short question and press Enter:
What’s in my mod log?
| You should see | |
|---|---|
| WORKING… as the last line of the chat | REDagent is thinking, or reading the log |
| An answer, usually within a minute | A summary of what REDnode’s mods have printed |
| The answer’s cost under it, in dim text | What that answer cost you |
If something else happens, see Troubleshooting. Otherwise you’re set up. Next: your first mod.
Updating
Install the new zip the same way, with the game closed. Your chats, backups and key stay: they are kept outside the game folder.
Check the release’s notes for the REDnode version it needs. REDagent 0.4.1 needs REDnode 0.50.2 or later.
Coming from REDagent 0.3? That version kept your key itself. At your first question, the new version offers to move it into REDnode’s shared keys, so other EDGE tools can use it too, and then deletes its own copy. If you say no, REDagent keeps using its own copy.
Removing
- With the game closed, remove REDagent in EDGEdeck or Vortex, or delete the folder
red4ext\plugins\REDnode\apps\redagent. - To remove its data too, delete
%APPDATA%\@rednode\overlay\packages\redagent. That folder holds your chats, the backups for Undo and the Agent SDK. - Your API key stays in REDnode. Remove it in REDnode’s Settings, under Keys.
The mods REDagent wrote for you are separate folders in the apps folder. They keep working without it.
Where REDagent keeps things
| What | Where |
|---|---|
| REDagent itself | red4ext\plugins\REDnode\apps\redagent in the game folder |
| The mods it writes | Their own folders beside it, in red4ext\plugins\REDnode\apps |
| Chats | %APPDATA%\@rednode\overlay\packages\redagent\chats |
| Backups, for Undo | %APPDATA%\@rednode\overlay\packages\redagent\backups |
| The Agent SDK | %APPDATA%\@rednode\overlay\packages\redagent\sdk |
| Your API key | In REDnode’s shared keys, encrypted for your Windows account |