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
```