> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stardex.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Advanced: Claude Code

> Download the Claude Code starter and use read-only workflows to analyze compensation and candidate profiles.

Couple things to flag upfront:

* Claude Code can have unintended consequences if you can't understand the code it writes, so I'm keeping the session focused on **read-only reporting** use cases.
* If you want to follow along, install the Claude Code desktop app beforehand.
* This is an advanced workflow: I'd only suggest joining if you've already run into limits with the MCP server. For most customers, the MCP connector is the easier and more secure way to automate with Stardex, and we always recommend starting there.

## What you’ll get

* A spreadsheet of all actual compensation records across your database (name, title, job, total comp)
* Grouped averages by job title with a visual chart
* (Optional) AI-scored segments per candidate: seniority level, market tier, and profile grade

***

## Step 1 — Download the starter folder

1. Download and unzip the **Stardex + Claude Code starter** folder.

<a download="stardex-demo.zip" href="data:application/octet-stream;base64,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">Download stardex-demo.zip</a>

2. Open the `.env` file inside it in any text editor.

> **Can’t see `.env` on Mac?** In Finder, press **Cmd + Shift + .** (period) to show hidden files.

3. Get your Stardex API key:
   * Go to **Settings → Email & other integrations → API access & Webhooks** in Stardex (direct link: [stardex.com/settings?tab=email-calendar\&section=api-access](https://stardex.com/settings?tab=email-calendar\&section=api-access))
   * Create a new key and copy it
   * Paste it into `.env` replacing `paste_your_key_here`:

```
STARDEX_API_KEY=paste_your_key_here
```

Save the file.

> Only admin users can create API keys. If you don’t see **API access & Webhooks**, ask your Stardex admin.

***

## Step 2 — Open Claude Code

1. Open **Claude Code** (desktop app or `claude` in terminal).
2. Click **Open folder** and select the starter folder you just unzipped.

That’s it. Claude now has access to your Stardex account.

***

## Step 3 — Pull your compensation data

Type this into Claude Code:

> **“Pull all actual compensation data across my database. For each record include the person’s name, current job title, job name if it’s linked to a job posting, and total comp.”**

Claude will:

* Page through your entire database
* Filter to `compensation_type = actual` only
* Save a `compensation_data.tsv` file you can drag straight into Google Sheets

***

## Step 4 — Segment by job title

Once you have the data, pick a title group you want to analyze. Type:

> **“Group all \[VP of Sales] titles together — normalize the variants — and show me the average, min, and max comp. Make a chart.”**

Replace `VP of Sales` with whatever title you’re focused on (e.g. `CRO`, `Head of Sales`, `Account Executive`).

Claude will:

* Collapse title variants like *“Vice President of Sales”*, *“VP, Sales”*, *“VP of Sales - West”* into one group
* Return a table with count, average, min, and max
* Generate a distribution chart saved as a `.png`

***

## Step 5 — AI profile evaluation (optional)

Want Claude to score and segment each candidate? Add your Anthropic API key to `.env`:

```
STARDEX_API_KEY=your_stardex_key_here
ANTHROPIC_API_KEY=your_anthropic_key_here
```

Get your Anthropic key at: `console.anthropic.com/settings/api-keys`

Then type:

> **“Evaluate each \[VP of Sales] profile and segment them by seniority, location, and current industry. Export to a CSV.”**

Claude will call its own API to score each profile across three dimensions:

| Dimension | Options |
| - | - |
| **Seniority** | Rising VP · Established VP · Senior VP |
| **Location Tier** | Tier 1 (SF/NY/LA/Seattle/Boston/Chicago) · Tier 2 · Remote / Other |
| Current Industry | e.g. SaaS · FinTech · Healthcare · Cybersecurity · Media · etc. |

Output: `vp_sales_segments.csv` with a direct Stardex profile link for every candidate.

***

## Example output

All names, companies, compensation figures, and profile attributes below are fictional and are provided only to illustrate the output format.

```
Name               Company          Comp      Seniority      Tier    Industry
Candidate A        Example Co. A    $200,000  Rising VP      Tier 1  SaaS
Candidate B        Example Co. B    $250,000  Rising VP      Tier 1  FinTech / Payments
Candidate C        Example Co. C    $300,000  Rising VP      Tier 1  Data / Analytics
```

***

## Tips

* **Re-run anytime** — just type the same prompts again to get fresh data as your database grows
* **Change the title group** — swap in any title at step 4/5 to analyze a different role
* **Read-only by default** — Claude will never modify your Stardex data unless you explicitly confirm it


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.