Skip to content

installation.md

Latest commit

 

History

History
94 lines (62 loc) · 2.23 KB

installation.md

File metadata and controls

94 lines (62 loc) · 2.23 KB

Install opencode-claude-auth

These instructions are designed for AI coding agents.

Prerequisites

Before installing, verify you have OpenCode and Claude Code installed and authenticated.

Check OpenCode version

opencode --version

You should see a version number (e.g., 1.2.28).

Check Claude Code credentials (macOS)

security find-generic-password -s "Claude Code-credentials" -w

If this returns credentials, you're authenticated. If it fails or returns nothing, try the fallback:

Check Claude Code credentials (fallback for all platforms)

cat ~/.claude/.credentials.json

If this file exists and contains valid JSON, you're authenticated.

If credentials don't exist

Run Claude Code to authenticate:

claude

This will prompt you to log in and store credentials in Keychain (macOS) or ~/.claude/.credentials.json (other platforms).

Installation

Step 1: Install the package

npm install -g opencode-claude-auth

Step 2: Add to OpenCode configuration

Run this command to automatically add the plugin to your opencode.json:

node -e "
const fs = require('fs'), p = require('path').join(require('os').homedir(), '.config/opencode/opencode.json');
const c = fs.existsSync(p) ? JSON.parse(fs.readFileSync(p,'utf8')) : {};
c.plugin = [...new Set([...(Array.isArray(c.plugin) ? c.plugin : []), 'opencode-claude-auth'])];
fs.mkdirSync(require('path').dirname(p), {recursive:true});
fs.writeFileSync(p, JSON.stringify(c, null, 2));
console.log('Added opencode-claude-auth to', p);
"

This command:

  • Reads your existing opencode.json (or creates a new one)
  • Adds opencode-claude-auth to the plugin array
  • Deduplicates plugins using a Set
  • Writes the updated config back

Verification

Verify the plugin was added:

cat ~/.config/opencode/opencode.json

You should see opencode-claude-auth in the plugin array:

{
  "plugin": ["opencode-claude-auth"]
}

Done

The plugin is now installed and configured. When you run OpenCode, it will automatically use your Claude Code credentials — no separate login needed.

Troubleshooting

If you encounter issues, see the main README troubleshooting section.