2.5 基本配置选项

2.5.1 概述

Claude Code 提供了多种配置选项，允许用户根据自己的需求和偏好进行定制。这些配置选项可以通过 VS 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 常用配置命令

# 设置配置项
claude config set <key> <value>

# 获取配置项
claude config get <key>

# 列出所有配置项
claude config list

# 删除配置项
claude config unset <key>

2.5.3.2 常用配置项

• model

  • 功能：设置默认使用的模型

  • 选项：claude-4-opus、claude-4-sonnet

  • 示例：

    claude config set model claude-4-opus

• temperature

  • 功能：控制生成文本的随机性

  • 范围：0 到 1 之间

  • 示例：

    claude config set temperature 0.5

• max-tokens

  • 功能：控制单次生成的最大令牌数

  • 范围：1 到 4096 之间

  • 示例：

    claude config set max-tokens 2048

• output-format

  • 功能：设置输出格式

  • 选项：text、json

  • 示例：

    claude config set output-format json

• timeout

  • 功能：设置命令执行的超时时间（秒）

  • 范围：10 到 300 之间

  • 示例：

    claude config set timeout 60

• auto-save

  • 功能：是否自动保存生成的代码

  • 选项：true / false

  • 示例：

    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 的配置会自动同步到云端，在一个设备上的配置更改会自动同步到其他设备。

2.5.5.1 同步内容

• 模型配置
• 编辑器配置
• 对话配置
• 命令行工具配置

2.5.5.2 同步机制

配置同步使用安全的加密机制，确保配置信息安全。同步过程是自动进行的，不需要手动操作。

2.5.6 恢复默认配置

2.5.6.1 在 VS Code 中

1. 打开 VS Code 设置
2. 搜索 "Claude Code"
3. 点击每个配置项旁边的重置按钮

2.5.6.2 使用命令行工具

# 删除配置文件
sudo rm -rf ~/.claude-code/config.json

# 或重新初始化配置
claude config reset