全面了解 Claude Code 的设置与配置,让你的工作流更加高效。
配置系统概述
Claude Code 的配置分布在几个位置:
- CLAUDE.md — 项目级指令文件(会话开始时加载)
- .claude/settings.json — 本地设置文件
- 交互式命令 — 会话中通过命令动态调整
模型配置
切换模型
在会话中运行 /model 可以切换不同模型:
- Claude Sonnet:适合日常编码任务,速度快、效果好
- Claude Opus:适合复杂的架构决策和推理,但速度较慢
启动时指定模型:
claude --model sonnet
claude --model opus
如何选择模型
| 场景 | 推荐模型 |
|---|---|
| 日常编码、Bug 修复 | Sonnet |
| 架构设计、复杂重构 | Opus |
| 代码审查 | Opus(更强的分析能力) |
| 简单的文件操作 | Sonnet |
权限管理
权限模式
按 Shift+Tab 循环切换四种权限模式:
- 默认:Claude 在编辑文件和运行命令前询问你
- 自动接受编辑:Claude 可以不经询问编辑文件和运行常用命令(如
mkdir、mv) - 计划模式:Claude 只使用只读工具,创建计划等你批准
- 自动模式:Claude 通过后台安全检查评估所有操作(研究预览版)
允许特定命令
在 .claude/settings.json 中可以配置不需要询问的命令:
{
"permissions": {
"allowedCommands": ["npm test", "git status", "pytest"]
}
}
自定义指令
CLAUDE.md
最强大的自定义方式。在项目根目录创建 CLAUDE.md,Claude 每次会话开始时都会读取。详见记忆系统。
启动提示
启动 Claude Code 时可以直接给出任务:
claude -p "给这个项目的 API 端点写单元测试"
claude --print "审查 main 分支和当前分支的 diff"
常用命令
| 命令 | 功能 |
|---|---|
/help | 显示所有可用命令 |
/model | 切换 AI 模型 |
/context | 查看上下文窗口使用情况 |
/init | 引导创建 CLAUDE.md |
/doctor | 诊断安装问题 |
/clear | 清除当前会话历史 |
/resume | 继续之前的会话 |
沙箱与安全
Claude Code 提供了沙箱功能来限制其操作范围。详见沙箱安全和安全指南。