🗂️

claude.json

Globalna konfiguracijska datoteka za seje Claude Code. Hrani definicije strežnikov MCP, projektne posebne nastavitve in metapodatke sej. Osrednji register vseh zunanjih integracij.

Configuration·2 razdelkov·1 min branja

codingdevops

Install Prompt

Paste this into Claude Code to set it up:

Datoteka je na poti ~/.claude.json. Hrani globalne konfiguracije strežnikov MCP in projektne posebne nastavitve. POMEMBNO: Claude Code v to datoteko nenehno piše, zato je med tekočo sejo nikoli ne urejajte z urejevalnikom besedila. Za atomarne spremembe uporabite jq prek ukazne vrstice.

01Kaj počne

Dve vlogi v eni datoteki

Datoteka ~/.claude.json ima dvojni namen. Na najvišji ravni ključ "mcpServers" opredeljuje strežnike MCP, ki so na voljo v vsaki seji Claude Code, ne glede na to, v katerem projektu delate. To so vaše globalne integracije: GitHub, Firecrawl, Notion, Slack in vse drugo, kar uporabljate v več projektih.

Pod ključem "projects" lahko opredelite projektne posebne konfiguracije strežnikov MCP, ki se aktivirajo le, ko delate znotraj tega imenika. Tako projektno omejene integracije (na primer lokalno instanco Supabase ali projektni API) ločite od globalne postavitve. Claude Code v to datoteko med vsako sejo zapisuje tudi metrike seje, predpomnilnike in notranje stanje.

02Varno urejanje

Med sejo je nikoli ne urejajte z urejevalnikom besedila

Claude Code med sejami nenehno piše v ~/.claude.json (metrike seje, predpomnilniki, zastavice funkcij). Če jo odprete v urejevalniku besedila, jo spremenite in shranite, boste najverjetneje prepisali podatke, ki jih je Claude Code pravkar zapisal, ali pa bodo vaše spremembe čez nekaj trenutkov prepisane.

Namesto tega uporabite jq prek ukazne vrstice. Bere, spreminja in zapisuje atomarno v enem samem cevovodu:

jq '.mcpServers["server-name"] = {"type": "http", "url": "https://example.com/mcp"}' ~/.claude.json > /tmp/claude-json-tmp && mv /tmp/claude-json-tmp ~/.claude.json

Ta vzorec deluje za dodajanje, posodabljanje in odstranjevanje strežnikov MCP. Za ogled trenutne konfiguracije uporabite jq '.mcpServers' ~/.claude.json. Po vsaki spremembi znova zaženite Claude Code, da se naloži nova konfiguracija.