配置指南
约 8 分钟

设置与配置

自定义 Claude Code 以适应你的工作流程，提升开发效率。

配置概述

Claude Code 可以通过多种方式进行配置，从全局设置到项目级配置。 了解如何自定义这些设置可以让 Claude Code 更好地适应你的开发流程。

基本设置

自动更新

固定

Claude Code 会自动保持最新版本

默认:启用

会话超时

可配置

空闲会话自动关闭的时间

默认:30 分钟

最大上下文

可配置

保留的对话历史大小

默认:自动管理

账户与认证

默认账户

可配置

使用的 Claude 账户类型

默认:Claude Pro/Max

API 密钥

可配置

Claude Console API 密钥

默认:无

工作区

可配置

用于成本追踪的工作区

默认:Claude Code

编辑器行为

编辑确认

可配置

修改文件前请求确认

默认:启用

自动保存

可配置

编辑后自动保存文件

默认:启用

备份文件

可配置

编辑前创建备份

默认:禁用

外观设置

颜色主题

可配置

终端界面颜色方案

默认:系统默认

代码高亮

可配置

代码块语法高亮

默认:启用

配置文件

.claude/config.json

全局配置文件，包含账户、默认设置等

.claudeignore

指定 Claude Code 应忽略的文件和目录

CLAUDE.md

项目级配置，为 Claude 提供项目上下文

.claude/commands/

自定义命令目录

配置示例

.claudeignore 示例

排除敏感文件和不必要的目录：

# 敏感配置
.env
.env.local
*.key
credentials.json

# 依赖和构建
node_modules/
dist/
build/
.next/

# 缓存
.cache/
*.log

# 其他
.git/
.DS_Store

CLAUDE.md 示例

项目级配置，为 Claude 提供上下文：

# 项目说明

这是一个 Next.js 16 + React 19 的课程网站项目。

## 技术栈

- 框架: Next.js 16 (App Router)
- UI: shadcn/ui + Tailwind CSS v4
- 状态: React Hooks

## 常用命令

```bash
pnpm dev      # 启动开发服务器
pnpm build    # 生产构建
pnpm lint     # ESLint 检查
```

## 项目结构

- app/           # Next.js App Router
- components/    # React 组件
- lib/           # 工具函数

## 注意事项

- 使用 pnpm 作为包管理器
- 所有组件使用 "use client" 指令
- 遵循现有的命名约定

自定义命令示例

创建 .claude/commands/fix-lint.md：

请运行 pnpm lint 并修复所有报告的问题。
对于每个错误，分析原因并应用正确的修复。
修复后再次运行 lint 确保所有问题都已解决。

使用方式：claude fix-lint

配置技巧

优化性能

定期清理对话历史，使用 `/clear` 或 `/compact`

保护敏感信息

使用 `.claudeignore` 排除密钥、密码等文件

自定义工作流

创建自定义命令来封装常用提示词

项目特定配置

在 CLAUDE.md 中记录项目特有的规则和命令

课程完成！

你已经完成了所有 Claude Code 课程。现在你掌握了从基础到高级的所有知识， 可以开始在实际项目中充分发挥 AI 辅助编程的强大能力。