Claude Code integration

1. Have these ready

• A current version of Claude Code, plus Node.js 18 or later with npx, and Git.
• An Octopus account. Open Settings → API Tokens and create an organization API token for the organization you want to use.
• Network access from Claude's environment to GitHub, the npm registry, and Octopus Cloud. The MCP server runs in that environment.

The plugin does not require the Octopus CLI. Reviews send code or diffs to Octopus and its configured AI services and use your organization's credits or provider budget. Keep your token out of chat messages and Git.

2. Install from the publisher marketplace

Run these commands in your terminal:

claude plugin marketplace add octopusreview/octopus-plugin
claude plugin install octopus-review@octopus-review

/plugin marketplace add octopusreview/octopus-plugin
/plugin install octopus-review@octopus-review

This is Octopus's own marketplace. You do not need to find it in Anthropic's official catalog.

3. Add your token and reconnect

Inside Claude Code, open the plugin's configuration and enter your token in the sensitive api_token field:

/plugin configure octopus-review@octopus-review

Restart Claude Code after setup. Open /mcp and check that the octopus server connects. Then ask:

Use octopus_status to check my Octopus connection and tell me which organization it uses. Do not start a review.

Confirm the organization before sending code. Installing the plugin alone does not authenticate it or confirm that a review has completed.

4. Request a review

Open your Git repository in Claude Code. For tracked changes in the working tree and staging area, ask:

Use Octopus to review my current tracked changes in this repository. Show the findings before making any edits.

The plugin reads git diff HEAD; untracked files are not included. This sends the diff for review and returns a brief findings summary in Claude Code. For structured findings, use the CLI and skill guide below. For a connected repository's pull request, ask:

Use Octopus to request a review of PR 42 in this repository.

Replace 42 with your PR number. A successful request queues the PR review; follow its progress in Review Logs and check the resulting comments on the PR. It is not a completed review at submission time.

To find the plugin's slash command, type /octopus-review: and select its review command. The old unqualified /review is not the command documented by this plugin.

If setup does not work

Plugin not found

Add the publisher marketplace in step 2, then use the full octopus-review@octopus-review name.

Token missing or unauthorized

Reopen the plugin configuration, check the organization token, then restart Claude Code and run the connection check again.

MCP server cannot start

Check node --version, npx --version, Git, and outbound network access in the environment running Claude. Open /mcp for its error details.

No changes or diff too large

The plugin reviews tracked diffs and is limited by the Octopus API to 500 KiB. Use a smaller change set or request a server-side PR review for a connected repository.

Prefer the CLI, or use another coding agent?

The AI coding agents guide provides a CLI and skill setup for Claude Code, Codex, OpenCode, Hermes Agent, OpenClaw, and Cursor. Use that path for the native octp workflow or your configured self-hosted Octopus server.

The legacy claude-plugin repository installs after adding its separate marketplace, but its review instructions still call the old octopus executable. Use the current plugin above or the CLI guide instead.