青蛙小白
目录

Claude Code

概述

安装

Skills

Subagents

官方文档

Agent teams

配置

官方文档

配置文件层级(优先级从低到高):

文件位置范围说明
~/.claude/settings.json用户全局应用于所有项目
.claude/settings.json项目共享可提交到版本控制,与团队共享
.claude/settings.local.json项目本地不提交,用于个人偏好
~/.claude.json用户配置主题、通知、OAuth、MCP 服务器等
.mcp.json项目级项目级 MCP 服务器配置

配置示例 (~/.claude/settings.json):

{                                                                                                                             
  "$schema": "https://json.schemastore.org/claude-code-settings.json",                                                        
  "env": {                                                                                                                    
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1                                                                             
  },                                                                                                                          
  "cleanupPeriodDays": 30,                                                                                                    
  "includeCoAuthoredBy": false,                                                                                               
  "permissions": {                                                                                                            
    "allow": [],                                                                                                              
    "deny": []                                                                                                                
  },                                                                                                                        
  "feedbackSurveyState": {                                                                                                    
    "lastShownTime": 1754037902963                                                                                            
  },                                                                                                                          
  "additionalDirectories": []                                                                                                 
}                                                                                                                             
配置项说明
$schemaJSON Schema 地址,提供编辑器智能提示和校验
env环境变量配置,可设置如 {"FOO": "bar"}
cleanupPeriodDays会话历史自动清理周期(天数),默认 30 天。设为 0 禁用自动清理
includeCoAuthoredByGit 提交时是否包含 Co-authored-by: Claude 署名
permissions.allow允许自动执行的工具/命令,如 ["Bash(npm run lint)"]
permissions.deny禁止执行的工具/命令,如 ["Read(./.env)"]
additionalDirectories允许 Claude 访问的额外目录路径

环境变量说明:

环境变量作用
DISABLE_AUTOUPDATER禁用自动更新。设为 1 后,Claude Code 不会自动更新到新版本
DISABLE_BUG_COMMAND禁用 /bug 命令。设为 1 后,用户无法在会话中使用 /bug 命令报告问题
DISABLE_ERROR_REPORTING禁用错误报告。设为 1 后,不向 Sentry 发送崩溃/错误遥测数据
DISABLE_TELEMETRY禁用遥测。设为 1 后,不向 Statsig 发送遥测数据。注:Statsig 事件不包含用户数据(如代码、文件路径或 bash 命令)
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC便捷变量,设为 1 时等同于同时设置以上四个变量

会话历史存储:

Claude Code 的所有会话历史(transcripts)保存在 ~/.claude/projects 目录中。每个项目会创建对应的子目录,包含会话记录、上下文和相关元数据。可通过 cleanupPeriodDays 配置自动清理旧会话。

状态栏 (Statusline)

快捷键

  • ctrl + v 粘贴截图。Mac上使用cmd + shift + 4进行截图,再使用ctrl + v将截图粘贴到Claude Code的聊天框中。
  • shift - tab 按一次 进入accept edits on,再按一次进入Plan mode。

Archives

评论