Installing Claude Desktop on macOS (Pilot)

Claude Desktop is a point-and-click assistant that routes through Cornell's AI Gateway using your personal gateway key — no personal Claude account involved.

This is a pilot deployment run by JCB IT with AI at Cornell and IT@Cornell. Details may change as it develops.

Before you start

1. Get your gateway keyGetting Your Cornell AI Gateway Key. The installer asks for it partway through, so you cannot finish without it.

2. Deployment on your machine — requesting your key for Claude Desktop use opens a TDX ticket automatically, and someone from Client Services will reach out to coordinate the rest. That ticket is already in the queue, so there is nothing further to submit.


Step 1 — Open Self Service and install

  1. Open Self Service from your Applications folder.
  2. Find Claude Desktop Cornell Managed Configuration.
  3. Click Install.

Self Service showing the Claude Desktop Cornell Managed Configuration item with its Install button


Step 2 — Choose the gateway

Leave LiteLLM API Gateway selected and click Continue.

The installer's gateway selection screen with LiteLLM API Gateway selected

Click Continue again on the next screen.

The installer's following screen with the Continue button


Step 3 — Enter your key

Paste the key secret you generated in Getting Your Cornell AI Gateway Key, then click Save.

The installer prompting for the API Gateway Key, with the Save button

When the installation finishes, click Done.

The installer's completion screen with the Done button


Step 4 — Open Claude

  1. Open Claude from your Applications folder.
  2. Click Continue.

Claude's first-launch screen with the Continue button

You will see a message reading "Code has been disabled by your organization's administrator." This is expected — click the X to dismiss it.

The "Code has been disabled by your organization's administrator" notice with its dismiss X

You can now start using Claude.

Claude Desktop open and ready for a first prompt


How do I know it worked?

  • Claude opened without asking you to sign in to a personal account.
  • It answers your prompts.
  • The Cornell models are listed in the model picker.

If anything failed, see Claude on Cornell's Gateway — Troubleshooting.


What can it do?

Web search, Word/PowerPoint/Excel/PDF handling, and saved skills all work out of the box. See What Claude Desktop Can Do for a tour.


About the Code tab

Claude's Code tab is off by default and enabled per person on request — some people here have it and some don't, depending on what their work calls for. Not seeing it is expected and does not mean the install failed: you'll get a dismissible "Code has been disabled by your organization's administrator" message on first launch.

If you'd use it, email itrequests@business.cornell.edu and ask. Privacy — What We Turned Off and Why explains what Code does and what's worth understanding before you switch it on.

Prefer a command line? See Appendix: Claude Code (CLI) on Cornell's AI Gateway.


Coming from a personal Claude subscription?

Read Appendix: Moving from a Personal Claude Subscription before you stop using your personal account — very little transfers automatically.


Later on

Keys expire, and you may need to change your spend cap or rotate a secret you think has been exposed. See Managing, Rotating, and Renewing Your Key.


Note for IT / advanced users: the underlying gateway configuration and the installer frontends are documented in IT / MDM Reference.

Was this helpful?
0 reviews
Print Article

Related Articles (8)

For people who want a command line. Install Claude Code and point it at Cornell's gateway.
What carries over from a personal claude.ai account (very little) and what to save before you switch.
Fixes for the most common setup, key, and connection problems.
Create a key in the JCB AI key portal and generate its secret. Requires Ethernet or VPN.
Install the Claude Desktop pilot from Software Center on a Cornell-managed PC and connect it with your gateway key.
Rotate a key, renew it before it expires, change your spend cap, and what to do if it is exposed.
What you need before you begin, and the order to do it in: request access, get a key, then install Claude Desktop.
Choosing a model and what each one costs, working with documents and your workspace folder, and the difference between skills, connectors, and capabilities.