Skip to content

claude-setup.md

Latest commit

 

History

History
75 lines (49 loc) · 2.5 KB

claude-setup.md

File metadata and controls

75 lines (49 loc) · 2.5 KB
Raw

Setting up Claude for Serokell work

A one-time setup guide for Serokell engineers. Do this before working on any project with Claude Code.

Prerequisites

Install Claude Code from the official page.

1. Connect Notion

Claude Code can read and write Notion pages when the Notion integration is enabled.

In a Claude Code session, type /mcp. From the list, choose Notion. A browser window opens. Authorize access and return to the terminal. Done.

2. Connect YouTrack

Claude uses a permanent token to create and update issues in issues.serokell.io.

In YouTrack, click your name in the bottom-left corner, then go to Profile → Account Security → Tokens. Create a permanent token with the YouTrack scope. Copy the token (it starts with perm:).

Add it to your user-level Claude environment file:

echo "YOUTRACK_TOKEN=perm:..." >> ~/.claude/.env
chmod 600 ~/.claude/.env

Claude Code loads ~/.claude/.env on startup, so the token is available in every session.

Never paste a secret into a Claude prompt. If a secret appears in the agent context, treat it as compromised and rotate it immediately. Store credentials in files, not in messages.

3. Install the Serokell plugin

The Serokell plugin bundle ships skills for everything from bootstrapping a repo to reviewing a PR. It is hosted at serokell/claude-plugins on GitHub.

Add the marketplace and enable the global plugin in ~/.claude/settings.json:

{
  "extraKnownMarketplaces": {
    "serokell": {
      "source": { "source": "github", "repo": "serokell/claude-plugins" },
      "autoUpdate": true
    }
  },
  "enabledPlugins": ["serokell-global@serokell"]
}

This gives you the workflow skills (committing-work, youtrack-issues, pull-requests, code-review) in every project.

For projects that use metatemplates, the full skill set is already wired up via the project-level .claude/settings.json.

4. Configure commit signing

Claude Code commits on your behalf. All commits at Serokell must be GPG-signed.

Make sure signing is on:

git config --global commit.gpgsign true

If GPG prompts for a passphrase via a Curses dialog (which does not work in a terminal-only session), switch to a graphical pinentry. For example on KDE:

echo "pinentry-program /usr/bin/pinentry-qt" >> ~/.gnupg/gpg-agent.conf
gpg-connect-agent reloadagent /bye