Claude Code 内置命令

/config 命令
完全指南

管理 Claude Code 的所有设置——模型选择、主题、权限、环境变量，一站式配置面板

/config
向下滚动探索 ↓
基础语法

交互式配置面板

/config 是 Claude Code 的内置配置命令，打开交互式面板管理所有设置项

/config

项目说明
语法/config — 无参数，直接打开交互式配置面板
作用管理模型选择、主题、权限、环境变量等所有 Claude Code 设置
交互方式打开后通过键盘方向键和回车选择配置项，无需记忆命令
生效范围修改后立即生效，无需重启 Claude Code
3 大使用场景

用 /config 解决配置问题

从外观主题到权限管理，/config 覆盖所有常见配置需求

🎨

切换主题

在配置面板中选择亮色或暗色主题，即时切换 Claude Code 的界面风格，保护你的眼睛

# 步骤：
/config → 选择 "Theme" → 选择 "light" 或 "dark"
外观定制
🔒

管理权限

配置哪些工具需要确认、哪些自动允许——比如允许 Bash 执行 npm 命令、允许文件读写等

# 步骤：
/config → 选择 "Permissions" → 添加/移除允许的工具
安全控制
⚙️

环境变量设置

配置 API 密钥、代理地址、自定义环境变量等，无需手动编辑配置文件

# 步骤：
/config → 选择 "Environment Variables" → 设置键值对
环境配置
实时演示

看看 /config 怎么用

点击下方标签，观看不同配置场景的交互效果

claude — theme config
claude — permissions config
claude — env config
配置层级

全局 / 项目 / 本地三层配置

Claude Code 的配置体系分为三个层级，优先级从低到高

层级文件作用范围典型用途
全局配置 ~/.claude/settings.json 所有项目生效 默认模型、全局主题、通用权限
项目配置 .claude/settings.json 当前项目团队共享 项目级权限、共享环境变量
本地配置 .claude/settings.local.json 仅个人本地 API 密钥、个人偏好、敏感信息
最佳实践

配置管理技巧

💡

安全与团队协作建议

  • 敏感信息放 settings.local.json -- API 密钥、Token 等绝不要放进 settings.json，避免被提交到 Git
  • 团队共享配置放 settings.json -- 项目通用的权限白名单、工具配置等可以提交到版本库
  • 全局配置用于个人偏好 -- 主题、默认模型等个人习惯放在全局 settings.json 中
  • 优先级：本地 > 项目 > 全局 -- 同名配置项，优先级高的会覆盖低的
  • 配合 .gitignore 使用 -- 确保 settings.local.json 已加入 .gitignore