claude_code

Declarative Claude Code configuration. Manage your ~/.claude/settings.json from a Lua table — permissions, environment variables, hooks, and model preferences.

local claude_code = require("rootbeer.claude_code")

Example

claude_code.config({
    model = "sonnet",
    lsp = { "typescript-lsp", "pyright-lsp" },
    permissions = {
        allow = {
            "Bash(npm run *)",
            "Bash(cargo *)",
            "Edit(*)",
        },
        deny = {
            "Read(.env)",
            "Read(.env.*)",
            "Bash(curl *)",
        },
    },
    env = {
        CLAUDE_CODE_ENABLE_TELEMETRY = "0",
    },
})

claude_code.prompt([[
## Conventions

- Use TypeScript with strict mode
- Prefer functional patterns over classes
- Always run tests before committing
- Use conventional commit messages
]], { lsp = true })

LSP Support

Claude Code can use Language Server Protocol for semantic code navigation — go-to-definition, find-references, hover types, and real-time diagnostics. This is not enabled by default; it requires an env flag (ENABLE_LSP_TOOL) discovered via anthropics/claude-code#15619.

The lsp field handles all of this for you. Pass a list of plugin names and rootbeer will:

1. Set ENABLE_LSP_TOOL=1 in your settings env
2. Register each plugin as name@claude-plugins-official in enabledPlugins

You still need to install both the language server binaries and the Claude Code plugins manually — rootbeer manages the settings, not the installation:

# 1. Install the language server binary
npm i -g pyright

# 2. Update the plugin catalog and install
claude plugin marketplace update claude-plugins-official
claude plugin install pyright-lsp

Available plugins: typescript-lsp, pyright-lsp, gopls-lsp, rust-analyzer-lsp, jdtls-lsp, clangd-lsp, csharp-lsp, php-lsp, kotlin-lsp, swift-lsp, lua-lsp.

claude_code.config({
    lsp = { "typescript-lsp", "pyright-lsp", "rust-analyzer-lsp" },
})

Pass { lsp = true } to prompt() and rootbeer will automatically append a "Code Intelligence" section to your CLAUDE.md that tells Claude to prefer LSP over grep for definitions, references, and type info:

claude_code.prompt("Your instructions here", { lsp = true })

API Reference

config(cfg)

Writes Claude Code settings to cfg.path as JSON.

auto_updates_channel("latest"|"stable")optional

Release channel for auto-updates.

cleanup_period_daysnumberoptional

Session cleanup period in days.

enabled_pluginstable<string, boolean>optional

Explicitly enable or disable plugins by "name@marketplace" key.

envtable<string, string>optional

Environment variables for Claude Code sessions.

hookstable<string, any>optional

Lifecycle hook configurations.

languagestringoptional

Claude's preferred response language.

lspstring[]optional

LSP plugins to enable (e.g. {"pyright-lsp", "typescript-lsp"}). Automatically sets ENABLE_LSP_TOOL=1 in env and adds entries to enabledPlugins.

modelstringoptional

Override default model (e.g. "opus", "sonnet").

pathstringoptional

Where to write settings. Defaults to "~/.claude/settings.json".

permissions(claude_code.Permissions)optional

Tool permission rules.

prompt(content, opts)

Writes the global CLAUDE.md instructions file. This file is loaded by Claude Code at the start of every session and applies across all projects. Use it for personal coding conventions, preferred tools, and project-agnostic guidance. When opts.lsp is true, appends guidance telling Claude to prefer LSP for code navigation.

contentstring

The markdown content for the instructions file.

opts(claude_code.PromptOpts)?

claude_code.Permissions

additional_directoriesstring[]optional

Extra directories Claude can access.

allowstring[]optional

Tool patterns to auto-allow (e.g. "Bash(npm run *)").

default_mode("acceptEdits"|"askEdits"|"default"|"plan"|"viewOnly")optional

Default permission mode.

denystring[]optional

Tool patterns to deny (e.g. "Read(.env)").

claude_code.PromptOpts

lspbooleanoptional

Append LSP code navigation guidance to the prompt. Tells Claude to prefer LSP over grep for definitions, references, and type info.

pathstringoptional

Where to write the file. Defaults to "~/.claude/CLAUDE.md".