SEI Robotics
Internal Staff Guide

AI-powered coding, right in your terminal.

Claude Code is Anthropic's official CLI that brings intelligent coding assistance directly into your development workflow. Connected through OpenRouter, it understands your codebase, writes code, runs commands, and helps you ship faster.

Get StartedPlugins & SkillsBest PracticesESAFENET Guide

What is Claude Code?

Claude Code is a command-line tool that connects you to Claude, Anthropic's AI assistant, directly inside your terminal. It can read and understand your entire codebase, write and edit files, run shell commands, search the web, and help you build features from start to finish.

>

Terminal Native

Works where you already work — no browser tabs, no context switching. Just open your terminal and start coding with AI.

{}

Codebase Aware

Reads your project files, understands architecture, follows your conventions, and writes code that fits your existing patterns.

+

Plugin Ecosystem

Extend capabilities with plugins for documentation lookup, browser testing, code review, web research, and more.

Getting Started

~

Internet

Required for installation and API calls.
>

Terminal

macOS Terminal, Linux shell, or Windows PowerShell / CMD.
*

OpenRouter Account

Free sign-up at openrouter.ai.
#

Git (Windows only)

Install Git for Windows before proceeding.
1

Go to openrouter.ai and click Sign Up.

You can sign up with Google, GitHub, or email.

2

Navigate to Settings → Keys.

3

Click "Create Key".

Give it a descriptive name, e.g., claude-code-work.

4

Copy your API key immediately.

It starts with sk-or-v1- and is only shown once. Store it in a password manager.

5

(Optional) Add credits at openrouter.ai/credits.

Credits are required to make API calls. Usage is pay-as-you-go.

Security reminder: Treat your API key like a password. Never share it, commit it to git, or paste it in Slack/Teams/email.
1

Option A — Native Install Recommended

Auto-updates in the background. Open Terminal and run:

curl -fsSL https://claude.ai/install.sh | bash
2

Option B — Homebrew

Does not auto-update — run brew upgrade claude-code periodically.

brew install --cask claude-code

Tell Claude Code to route requests through OpenRouter by setting these environment variables.

1

Step 1: Open your shell profile in a text editor.

Zsh (default on macOS)

nano ~/.zshrc

Bash (default on most Linux)

nano ~/.bashrc
2

Step 2: Add these lines at the bottom of the file. Replace the placeholder with your actual key.

Replace sk-or-v1-YOUR_KEY_HERE with your actual API key.

# Claude Code — OpenRouter Configuration
export OPENROUTER_API_KEY="sk-or-v1-YOUR_KEY_HERE"
export ANTHROPIC_BASE_URL="https://openrouter.ai/api"
export ANTHROPIC_AUTH_TOKEN="$OPENROUTER_API_KEY"
export ANTHROPIC_API_KEY=""
3

Step 3: Save the file (in nano: Ctrl+O → Enter → Ctrl+X).

4

Step 4: Reload your profile:

source ~/.zshrc    # or: source ~/.bashrc
Important: Do not put these variables in a .env file in your project. The native Claude Code installer does not read .env files. They must be in your shell profile or set as system-level environment variables.
1

Open a new terminal window

Old windows won't have the new environment variables.

2

Navigate to any project folder and launch Claude Code:

cd your-project-folder
claude
3

If you were previously logged in to Anthropic, log out first:

This clears cached Anthropic credentials so OpenRouter takes over.

/logout
4

Verify the connection:

You should see confirmation that your connection is active and routed through OpenRouter.

/status
5

Try a test prompt:

If Claude responds with a file listing — you're all set!

What files are in this directory?
Success! Claude Code is now connected through OpenRouter. You can start using it for coding tasks.

Plugins & Skills

Plugins extend Claude Code with specialized capabilities. Install them once and they're available in every session. Skills are built-in workflows within plugins that guide Claude through complex multi-step tasks.

$Install via the Claude Code CLI: claude plugin add <plugin-name>
★
Or browse and install all recommended plugins at once from the official marketplace:/install-plugin marketplace add anthropics/claude-code
{ }

Feature Dev

feature-dev
Development

Guided feature development with deep codebase analysis. Explores architecture, designs components, and implements with review checkpoints.

{ }

Frontend Design

frontend-design
Development

Creates distinctive, production-grade frontend interfaces with exceptional design quality. Avoids generic AI aesthetics.

{ }

Playground

playground
Development

Generates interactive HTML playgrounds — self-contained single-file explorers with live previews and controls.

✓

Code Review

code-review
Code Quality

Reviews pull requests for bugs, logic errors, security vulnerabilities, and adherence to project conventions.

✓

PR Review Toolkit

pr-review-toolkit
Code Quality

Comprehensive PR review pipeline with specialized agents for silent failures, comment analysis, test coverage, and type design.

✓

Code Simplifier

code-simplifier
Code Quality

Simplifies and refines code for clarity, consistency, and maintainability while preserving all functionality.

◎

Context7

context7
Research & Docs

Retrieves up-to-date documentation and code examples for any library directly from official sources. Never work with outdated docs.

◎

Firecrawl

firecrawl
Research & Docs

Handles all web operations — search, scrape, research, and extract content from any URL. Returns clean markdown optimized for AI context.

◎

CLAUDE.md Management

claude-md-management
Research & Docs

Audits, improves, and manages CLAUDE.md project memory files. Keeps your project context fresh and well-structured.

⑂

Commit Commands

commit-commands
Git & GitHub

Streamlined git workflow: create commits, push branches, open pull requests, and clean up merged branches — all from Claude Code.

⑂

GitHub

github
Git & GitHub

GitHub integration for working with issues, pull requests, checks, and releases directly through Claude Code.

▶

Playwright

playwright
Testing & Debugging

Browser automation and testing. Navigate pages, fill forms, take screenshots, inspect elements, and run end-to-end tests.

◈

Superpowers

superpowers
Planning & Workflow

Collection of structured workflows: brainstorming, TDD, systematic debugging, plan writing, code review, and more.

Ts

TypeScript LSP

typescript-lsp
Language Support

Real-time TypeScript diagnostics and type checking integrated into Claude Code for catching type errors as you code.

Ts

Pyright LSP

pyright-lsp
Language Support

Python type checking via Pyright, integrated into Claude Code for catching type errors in Python projects.

Best Practice Setups

Recommended plugin combinations for common development workflows. Each setup is a proven combination that works well together.

01

Full-Stack Feature Dev

Build features from idea to implementation with guided exploration, architecture design, and quality gates.

Superpowers (brainstorming) → Feature Dev → Frontend Design → Superpowers (TDD) → Code Review

Building new features from scratch
02

PR & Code Quality Pipeline

Ensure every pull request meets quality standards with automated review, simplification, and structured commits.

Commit Commands → PR Review Toolkit → Code Simplifier → Code Review

Shipping clean, reviewed code
03

Research & Prototype

Quickly research APIs and libraries, then prototype interactive demos to validate ideas before building.

Firecrawl + Context7 → Playground → Frontend Design

Exploring new technologies and creating proof-of-concepts
04

Bug Investigation

Systematically identify root causes, reproduce issues in the browser, and verify fixes with automated testing.

Superpowers (debugging) → Playwright → Code Review

Finding and fixing bugs efficiently
05

Project Bootstrap

Start new projects with proper structure, documentation, and context files so Claude understands your project from day one.

CLAUDE.md Management + Context7 + Superpowers (brainstorming) → Superpowers (plans)

Setting up new projects with best practices
06

Documentation & Learning

Access up-to-date docs, research topics on the web, and maintain living project documentation.

Firecrawl + Context7 + CLAUDE.md Management

Staying current and keeping docs accurate
04

Department CLI Tools

Curated command-line tools for each SEI Robotics department. Click any command to copy it.

repo

Initialize and sync Android source tree

repo init -u <manifest-url> && repo sync -j8

adb

List connected Android devices

adb devices

fastboot

Flash system partition via fastboot

fastboot flash system system.img

make/lunch

Set up Android build environment

source build/envsetup.sh && lunch <target>

ccache

Enable compiler cache (speeds up rebuilds)

export USE_CCACHE=1 && ccache -M 50G

git

View recent commit history

git log --oneline -20

ninja

Parallel build with Ninja build system

ninja -j$(nproc)

JDK

Check Java Development Kit version

java -version

simg2img

Convert sparse image to raw image

simg2img system.img system.raw.img

logcat

Stream device logs (warnings+)

adb logcat -v time *:W
05

Getting Started Scenarios

Three common workflows for setting up a project with Claude Code and a CLAUDE.md file. Pick the scenario that matches your situation.

1

Create your project directory

mkdir my-project && cd my-project
2

Initialize a git repository

git init
3

Launch Claude Code

claude
4

Paste the prompting framework into Claude Code

Copy the structured brief below, fill in your details, and paste it as your first message to Claude.

5

Ask Claude to generate a CLAUDE.md file

Claude will create a CLAUDE.md based on your project context.

6

Review and refine CLAUDE.md

Check the generated file, then ask Claude to adjust anything that's missing or incorrect.

7

Create a GitLab repo and push

Replace gitlab.company.com with your actual self-hosted GitLab hostname.

git add -A
git commit -m "Initial project setup with CLAUDE.md"
git remote add origin https://gitlab.company.com/your-group/project-name.git
git push -u origin main

Prompting Framework for New Projects

Copy this template, fill in the bracketed fields, and paste it as your first message to Claude Code:

I'm starting a new project. Here's the context:

Project: [name]
Department: [Android Source / APK Tools / Embedded Linux / Smart Devices / Cloud Engineering]
Purpose: [one sentence — what does this project do?]
Platform: [Android TV / Set-top box / Linux SBC / Cloud service / etc.]
Languages: [Java / Kotlin / C / C++ / Python / Go / TypeScript / etc.]
Framework: [AOSP / Buildroot / Spring Boot / FastAPI / React / etc.]
Build system: [Gradle / Make / CMake / Bazel / npm / etc.]
Key dependencies: [list main libraries or services]
Team conventions: [e.g., comments in Chinese, commit messages in English, etc.]

Please:
1. Set up the initial project structure
2. Create a CLAUDE.md file that captures all of the above
3. Include build/run/test commands in CLAUDE.md
SEI CLAUDE.md Template▶

Use this as a starting point when creating your CLAUDE.md file:

# Project Name

## Overview
Brief description of what this project does and which SEI Robotics department owns it.

## Tech Stack
- **Language**:
- **Framework**:
- **Build System**:
- **Target Platform**:

## Getting Started
### Prerequisites
### Build
### Run
### Test

## Project Structure
Key directories and what they contain.

## Code Conventions
- Comment language: [Chinese / English / both]
- Naming: [camelCase / snake_case / etc.]
- Commit messages: [language, format]
- Branch naming: [feature/xxx, bugfix/xxx]

## Key Dependencies
| Package | Version | Purpose |
|---------|---------|---------|

## Deployment
How and where this project is deployed.

## Team
- Department:
- GitLab group:
- Maintainers:

## Claude Code Notes
Special instructions for Claude Code when working on this project.
- Preferred models/tools
- Files to never modify
- Testing requirements before commits
06

AI Tool Recommendations

Ask our AI assistant for personalized CLI tool recommendations based on your role and workflow.

Hello! I'm your SEI Robotics AI assistant. Tell me your department and what you're working on, and I'll recommend the best CLI tools for your workflow.

07

Quick Reference

WhatCommand / Link
Install (macOS / Linux)curl -fsSL https://claude.ai/install.sh | bash
Install (Windows PS)irm https://claude.ai/install.ps1 | iex
Install (Homebrew)brew install --cask claude-code
Install (WinGet)winget install Anthropic.ClaudeCode
Launchclaude
Check status/status
Log out/logout
OpenRouter keysopenrouter.ai/settings/keys
OpenRouter creditsopenrouter.ai/credits
Usage dashboardopenrouter.ai/activity
*

Tips & Best Practices

$

Monitor Costs

Check openrouter.ai/activity regularly. Set spending limits in your account settings.
^

Stay Updated

Native installs auto-update. Homebrew/WinGet users: upgrade manually.
~

Provider Failover

OpenRouter routes between multiple Anthropic providers for high availability.
#

Never Commit Keys

Keep your API key out of code, git repos, and shared documents. Use env vars only.
08

Troubleshooting

"Authentication failed" or "Invalid API key"▶
  • Double-check your OPENROUTER_API_KEY starts with sk-or-v1-.
  • Make sure you opened a new terminal window after setting variables.
  • Run /logout inside Claude Code to clear old Anthropic credentials.
  • Ensure ANTHROPIC_API_KEY is set to an empty string (""), not left unset.
"Insufficient credits" or rate limit errors▶
  • Add credits at openrouter.ai/credits.
  • Check your usage at openrouter.ai/activity.
"claude" command not found▶
  • Close and reopen your terminal after installation.
  • Check that ~/.claude/local/bin is in your PATH.
  • Try running the install command again.
Environment variables not being picked up▶
  • Verify with: echo $OPENROUTER_API_KEY (Unix) or echo %OPENROUTER_API_KEY% (Windows).
  • Make sure you edited the correct shell profile (.zshrc vs .bashrc).
  • On Windows, ensure you reopened your terminal after setting variables.
Behind a corporate proxy▶
  • Set HTTPS_PROXY and HTTP_PROXY environment variables.
  • Ask IT for the proxy address and port.
  • Some proxies may require NO_PROXY exceptions for openrouter.ai.
ESAFENET (亿赛通) encryption blocking Claude Code▶

ESAFENET CDG uses kernel-level transparent encryption that blocks node.exe and git.exe from reading encrypted source files. IT admins need to whitelist Claude Code processes.

View full ESAFENET Compatibility Guide
Claude Code Setup Guide — SEI Robotics