Skip to content

Commit 9c834cc

Browse files
committed
update claude code setting
1 parent 67ac3e3 commit 9c834cc

2 files changed

Lines changed: 28 additions & 1 deletion

File tree

docs/posts/2025/2025-08-31-ai-coding.md

Lines changed: 26 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -67,7 +67,18 @@ We can save the [Claude instructions](https://www.anthropic.com/engineering/clau
6767
| `~/git/CLAUDE.md` | Parent directory (monorepos) | Instructions for entire monorepo, automatically pulled when working in subdirectories. |
6868
| `~/git/repo/sub_project/CLAUDE.md` | Child directory | Specific instructions for `sub_project`, pulled on demand when working with files in that directory. |
6969

70-
### Claude settings.local.json file
70+
### Claude settings.json settings.local.json files
71+
72+
[Available settings](https://code.claude.com/docs/en/settings#available-settings).
73+
74+
| Location | Description | Use Case |
75+
| ---------------------------------- | ------------------------------- | ----------------------------------------------------------------------------------------- |
76+
| `~/.claude/settings.json` | User settings (global) | Global settings applied to all Claude Code projects. |
77+
| `.claude/settings.json` | Project settings (shared) | Project-specific settings checked into source control and shared with team. |
78+
| `.claude/settings.local.json` | Project settings (local only) | Personal preferences and experimentation not checked in. Claude Code will configure git to ignore. |
79+
80+
!!! warning "Settings merging behavior: Array replacement"
81+
Arrays are typically replaced entirely, not merged element-wise. If project settings define a list of allow, deny, or other array-based configurations, they will **completely override the corresponding user-level arrays rather than merging with them**.
7182

7283
### Claude Code rules
7384

@@ -113,3 +124,17 @@ ln -s ~/.github/CLAUDE.md CLAUDE.md
113124
echo ".github/**/*.md" >> .gitignore
114125
echo "CLAUDE.md" >> .gitignore
115126
```
127+
128+
## VSCode settings
129+
130+
### Disable experimentalGpuAcceleration
131+
132+
`"editor.experimentalGpuAcceleration": "on"` enables GPU-based text rendering (WebGPU/WebGL).
133+
When multiple AI extensions (like Codex, Claude, Copilot, etc.) use their own WebView or GPU contexts, [they conflict with VSCode's GPU renderer](https://github.com/microsoft/vscode/issues?q=is%3Aissue%20state%3Aopen%20label%3Aeditor-gpu), especially under WSL, Wayland, or remote environments.
134+
135+
Default value is off, which is not shown in settings.json, if you see `on` in your settings, turn it off by removing the line from your `settings.json` from another editor (as your current VScode might not display it) or from terminal:
136+
137+
```json title="delete from settings.json"
138+
// remove before line
139+
"editor.experimentalGpuAcceleration": "on",
140+
```

mkdocs.yml

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -101,13 +101,15 @@ plugins:
101101
- encoding
102102
- file
103103
- flask
104+
- frontend
104105
- git
105106
- github
106107
- gitlab
107108
- jekyll
108109
- linter
109110
- linux
110111
- markdown
112+
- mcp
111113
- messaging
112114
- migration
113115
- mkdocs

0 commit comments

Comments
 (0)