基础配置选项
Claude Code 基本配置选项详解，帮助你根据需求进行定制
概述
Claude Code 提供了多种配置选项，允许用户根据自己的需求和偏好进行定制。配置可以通过以下方式进行：
- VS Code 设置界面
- 命令行工具
- 直接编辑配置文件
本节将详细介绍各种配置选项及其用法。
VS Code 插件配置
在 VS Code 中，通过 文件 → 首选项 → 设置（快捷键 Ctrl+, / Cmd+,）打开设置界面，搜索 "Claude Code" 即可查看所有配置选项。
模型配置
Model
| 属性 | 说明 |
|---|---|
| 功能 | 选择要使用的 Claude 模型 |
| 选项 | claude-4-opus（最强大，适合复杂任务）claude-4-sonnet（平衡性能和成本） |
| 默认值 | claude-4-sonnet |
Temperature
| 属性 | 说明 |
|---|---|
| 功能 | 控制生成文本的随机性 |
| 范围 | 0 ~ 1 |
| 默认值 | 0.7 |
建议：精确任务设置 0.2-0.4，创意任务设置 0.6-0.9。
Max Tokens
| 属性 | 说明 |
|---|---|
| 功能 | 控制单次生成的最大令牌数 |
| 范围 | 1 ~ 4096 |
| 默认值 | 1024 |
编辑器配置
| 配置项 | 功能 | 默认值 | 建议 |
|---|---|---|---|
| Auto-save | 自动保存生成的代码 | false | 按个人习惯选择 |
| Show Welcome Page | 显示欢迎页面 | true | 新手保持开启 |
| Show Line Numbers | 显示行号 | false | 按个人习惯选择 |
对话配置
| 配置项 | 功能 | 默认值 | 建议 |
|---|---|---|---|
| Show Timestamps | 显示时间戳 | false | 需要记录时间时开启 |
| Clear Conversation on New File | 打开新文件时清除对话历史 | false | 按个人习惯选择 |
| Conversation History Limit | 限制对话历史数量 | 20 | 较多历史可提供更多上下文 |
命令行工具配置
使用 claude config 命令管理配置。
常用配置命令
# 设置配置项
claude config set <key> <value>
# 获取配置项
claude config get <key>
# 列出所有配置项
claude config list
# 删除配置项
claude config unset <key>常用配置项示例
model
设置默认使用的模型：
claude config set model claude-4-opustemperature
控制生成文本的随机性（0 ~ 1）：
claude config set temperature 0.5max-tokens
控制单次生成的最大令牌数（1 ~ 4096）：
claude config set max-tokens 2048output-format
设置输出格式（text 或 json）：
claude config set output-format jsontimeout
设置命令执行的超时时间（10 ~ 300 秒）：
claude config set timeout 60auto-save
是否自动保存生成的代码：
claude config set auto-save true配置文件位置
Claude Code 的配置文件存储位置：
| 操作系统 | 路径 |
|---|---|
| Windows | %USERPROFILE%\.claude-code\config.json |
| macOS / Linux | ~/.claude-code/config.json |
配置文件采用 JSON 格式。建议使用 VS Code 设置界面或命令行工具进行配置，避免手动编辑时出现格式错误。
配置同步
Claude Code 的配置会自动同步到云端，确保在不同设备上使用时具有一致的体验。
同步内容
- 模型配置
- 编辑器配置
- 对话配置
- 命令行工具配置
同步机制
配置同步使用安全的加密机制，同步过程自动进行，无需手动操作。
恢复默认配置
在 VS Code 中
- 打开 VS Code 设置
- 搜索 "Claude Code"
- 点击每个配置项旁边的重置按钮
使用命令行工具
# 删除配置文件
rm ~/.claude-code/config.json
# 或重新初始化配置
claude config reset