2.5 基本配置选项
2.5.1 概述
Claude Code提供了多种配置选项，允许用户根据自己的需求和偏好进行定制。这些配置选项可以通过VS Code的设置界面或命令行工具进行配置。本节将介绍Claude Code的基本配置选项，帮助你根据自己的需求进行定制。
2.5.2 VS Code插件配置
在VS Code中，可以通过文件 首选项 设置 （或使用快捷键 Ctrl+, / Cmd+,）来配置Claude Code插件。在设置搜索框中输入 "Claude Code" 即可查看所有配置选项。
2.5.2.1 模型配置
- Model
* **功能** ：选择要使用的Claude模型
* **选项** ：
* `claude-4-opus`：Claude 4 Opus，最强大的模型，适合复杂任务
* `claude-4-sonnet`：Claude 4 Sonnet，平衡性能和成本的模型
* **默认值** ：`claude-4-sonnet`
* **建议** ：根据任务复杂度选择合适的模型
* **Temperature**
* **功能** ：控制生成文本的随机性
* **范围** ：0到1之间
* **默认值** ：0.7
* **建议** ：
* 对于需要精确结果的任务，设置较低值（如0.2-0.4）
* 对于需要创意结果的任务，设置较高值（如0.6-0.9）
* **Max Tokens**
* **功能** ：控制单次生成的最大令牌数
* **范围** ：1到4096之间
* **默认值** ：1024
* **建议** ：根据任务需要设置，复杂任务可以设置较高值
### 2.5.2.2 编辑器配置
* **Auto-save**
* **功能** ：是否自动保存生成的代码
* **选项** ：`true` / `false`
* **默认值** ：`false`
* **建议** ：根据个人习惯选择，自动保存可以减少手动操作
* **Show Welcome Page**
* **功能** ：是否显示欢迎页面
* **选项** ：`true` / `false`
* **默认值** ：`true`
* **建议** ：新手可以保持开启，熟悉后可以关闭
* **Show Line Numbers**
* **功能** ：在生成的代码中是否显示行号
* **选项** ：`true` / `false`
* **默认值** ：`false`
* **建议** ：根据个人习惯选择
### 2.5.2.3 对话配置
* **Show Timestamps**
* **功能** ：在对话历史中是否显示时间戳
* **选项** ：`true` / `false`
* **默认值** ：`false`
* **建议** ：需要记录对话时间时可以开启
* **Clear Conversation on New File**
* **功能** ：打开新文件时是否清除对话历史
* **选项** ：`true` / `false`
* **默认值** ：`false`
* **建议** ：根据个人习惯选择，保持开启可以保持对话上下文
* **Conversation History Limit**
* **功能** ：限制对话历史的数量
* **范围** ：1到100之间
* **默认值** ：20
* **建议** ：根据需要设置，较多的历史记录可以提供更多上下文，但可能影响性能
## 2.5.3 命令行工具配置
在命令行工具中，可以使用 `claude config` 命令来配置Claude Code。
### 2.5.3.1 常用配置命令
* **设置配置项**
```bash
claude config set <key> <value>
```
* **获取配置项**
```bash
claude config get <key>
```
* **列出所有配置项**
```bash
claude config list
```
* **删除配置项**
```bash
claude config unset <key>
### 2.5.3.2 常用配置项
* **model*** **功能** ：设置默认使用的模型
* **选项** ：`claude-4-opus`、`claude-4-sonnet`
* **示例** ：
```bash
claude config set model claude-4-opus
```
temperature
功能 ：控制生成文本的随机性
范围 ：0到1之间
示例 ：
```bash claude config set temperature 0.5 ```
max-tokens
功能 ：控制单次生成的最大令牌数
范围 ：1到4096之间
示例 ：
```bash claude config set max-tokens 2048 ```
output-format
功能 ：设置输出格式
选项 ：
text、json示例 ：
```bash claude config set output-format json ```
timeout
功能 ：设置命令执行的超时时间（秒）
范围 ：10到300之间
示例 ：
```bash claude config set timeout 60 ```
auto-save
功能 ：是否自动保存生成的代码
选项 ：
true/false示例 ：
```bash claude config set auto-save true
2.5.4 配置文件位置
Claude Code的配置文件存储在以下位置：
- Windows ：
%USERPROFILE%\.claude-code\config.json - macOS/Linux ：
~/.claude-code/config.json
配置文件采用JSON格式，可以直接编辑，但建议使用VS Code设置界面或命令行工具进行配置，以避免格式错误。
2.5.5 配置同步
Claude Code的配置会自动同步到云端，这意味着你在一个设备上的配置更改会自动同步到其他设备上。这种同步机制确保了在不同设备上使用Claude Code时具有一致的体验。
2.5.5.1 同步内容
- 模型配置
- 编辑器配置
- 对话配置
- 命令行工具配置
2.5.5.2 同步机制
配置同步使用安全的加密机制，确保你的配置信息安全。同步过程是自动进行的，不需要手动操作。
2.5.6 恢复默认配置
如果你需要恢复Claude Code的默认配置，可以通过以下方式：
2.5.6.1 在VS Code中
- 打开VS Code设置
- 搜索 "Claude Code"
- 点击每个配置项旁边的重置按钮
### 2.5.6.2 使用命令行工具
```bash
# 删除配置文件sudo rm -rf ~/.claude-code/config.json
# 或重新初始化配置
claude config reset
```