@opencode/console

Connects Claude Code, Pi, Codex and DeepSeek Harness to an OpenCode Console workspace. They then use the workspace's models, MCP servers, skills and instructions, and their tool calls follow the workspace's policies. OpenCode connects to Console on its own, so OpenCode users don't need this package.

Set up Claude Code

npx @opencode/console setup claude-code

Setup opens your browser to sign in and pick a workspace, then writes Claude Code's user settings. It needs Node.js 22 or later. To update, run npx @opencode/console@latest setup claude-code.

Set up Pi

npx @opencode/console setup pi

The package is also a Pi package, so pi install npm:@opencode/console works too; run npx @opencode/console login once after it.

Set up Codex

npx @opencode/console setup codex

Setup writes Codex's ~/.codex/config.toml and hooks.json (or those in CODEX_HOME) and approves its policy hooks, so Codex runs them without asking in /hooks.

Keep your own Claude or ChatGPT sign-in

npx @opencode/console setup claude-code --keep-provider
npx @opencode/console setup codex --keep-provider

Claude Code or Codex keeps your own sign-in and models, and still gets the workspace's MCP servers, skills, instructions and policies. If the workspace counts usage from members' own subscriptions, they then send it token counts and model names, and never prompts or code. Codex reports them from a hook after each model response; it needs Codex 0.164.0 or later. An OpenTelemetry endpoint you already set for Claude Code stays yours, and Claude Code sends nothing then. npx @opencode/console status shows which applies. Run setup without --keep-provider to use the workspace's models again.

Set up DeepSeek Harness

npx @opencode/console setup deepseek-harness

Setup adds a plugin to DeepSeek Harness's ~/.dsh/cordis.patch.yml (or the one in DSH_HOME), so dsh web, dsh headless and every other profile use the workspace. While it's set up, the workspace's models replace the model providers you added to DeepSeek Harness, and new sessions start on the workspace's default model. Restart a running dsh after setup.

Other commands

npx @opencode/console status                       # Show the sign-in, workspace and config
npx @opencode/console setup claude-code --remove   # Undo the Claude Code setup and keep the sign-in
npx @opencode/console setup pi --remove            # Undo the Pi setup and keep the sign-in
npx @opencode/console setup codex --remove         # Undo the Codex setup and keep the sign-in
npx @opencode/console setup deepseek-harness --remove  # Undo the DeepSeek Harness setup and keep the sign-in
npx @opencode/console logout                       # Sign out

To use a personal or service account key instead of signing in, for example in CI, set OPENCODE_API_KEY. npx @opencode/console help lists every command.

The Claude Code guide explains what setup changes and how workspace policies apply to Claude Code.