---
id: 44cba732-76a1-4111-b1c4-7f463a53e6cc
type: fix
title: "CLAUDE.md SSH section updated to mandate aliases from ~/.ssh/config"
tags: [claude-code, ssh, configuration, claude-config]
importance: 0.7
confidence: 0.8
created: "2026-02-20T04:22:42.061605+00:00"
updated: "2026-02-20T04:22:42.061605+00:00"
---

## Problem
Claude Code sessions were constructing manual `ssh -i ~/.ssh/homelab_rsa cal@<host>` commands instead of using the SSH aliases defined in `~/.ssh/config`. This happened because the CLAUDE.md SSH section only described generic key-based rules, not the aliases.

## Fix
Updated `~/.claude/CLAUDE.md` SSH section to:
- **Mandate** using aliases: `ssh <alias>` (e.g. `ssh sba-db`, `ssh proxmox`, `ssh manticore`)
- **Never** construct manual `ssh -i` commands
- If unsure of an alias, read `~/.ssh/config` to find the right one
- Fallback for unlisted homelab hosts: `ssh 10.10.0.x` (wildcard rule handles key/user)

## Also in same sync
- Fixed Gitea `tea` CLI instructions to always pass `--repo owner/name` flag
- Added cal/major-domo-v2 to common repos list

## Commit
`42d180e` pushed to cal/claude-configs on Gitea.