FEHM with Claude Code

Install FEHM's entry skill for Claude Code, retrieve source evidence and configure optional local MCP tools with the correct client settings.

Install FEHM 1.0.0 from PyPI using the installation guide. npm publication is pending. The assistant needs access to the installed CLI and your checkout in its own execution environment.

Personal skill

Terminal
fehm install --platform claude --dry-run
fehm install --platform claude
fehm integrations --platform claude

Personal path: ~/.claude/skills/fehm/SKILL.md.

Project skill

Terminal
fehm install --platform claude --project
fehm integrations --platform claude --project

Run at your project root. Expected path: .claude/skills/fehm/SKILL.md. Installation protects customized files and does not modify MCP settings or permission lists.

Scan and retrieve

Terminal
fehm scan .
fehm doctor
fehm context "authentication flow" --budget 4000

Reload the assistant and inspect its skill list for Fehm. Ask: “Use FEHM to explain the authentication flow. Identify entry points, trace supported caller/callee relationships, cite source files and lines, and distinguish observed evidence from inference.” Skill discovery and model behavior must be checked in your client; filesystem tests alone do not prove either.

Optional MCP

Terminal
fehm mcp-config --platform claude --root /absolute/path/to/project

This prints exact configuration without writing settings. Review and merge only the FEHM entry into .mcp.json (project). Below is the client-specific shape; replace placeholder paths or use the generated values.

JSON
{
  "mcpServers": {
    "fehm": {
      "command": "/absolute/path/to/bin/fehm",
      "args": [
        "mcp",
        "--root",
        "/absolute/path/to/project"
      ]
    }
  }
}

Approve the server through your client's trust controls. Confirm the connection and the fehm_context and fehm_practices tools, then query a known symbol. See MCP setup and limits.

Update and remove

After installing a replacement wheel, refresh the same scope:

Terminal
fehm install --platform claude --project
fehm integrations --platform claude --project
# To remove the project skill:
fehm uninstall --platform claude --project

Omit --project for personal scope. --force creates a backup before replacing a customized skill. Unrelated files and project graphs remain. Remove only the FEHM MCP entry using the client's own settings. Optional catalog skills retain their separate installation lifecycle.

Compatibility and troubleshooting

Installer paths and configuration shapes are automatically tested. Claude Code 2.1.283 connected to the installed wheel in an isolated configuration on macOS ARM64. An authenticated assistant response and skill discovery remain unverified. If discovery fails, check the client version, trust policy, selected scope and runtime PATH. Remote hosts need their own installation. See troubleshooting.