环境要求#

• Node.js >= 20
• 支持的操作系统：Linux、macOS、Windows

安装步骤#

1. 安装 Claude Code

   1
   npm install -g @anthropic-ai/claude-code
   

2. 初始化配置

   1
   claude
   

   首次运行会引导你完成基本设置。

配置文件位置#

• Linux/macOS: ~/.claude/settings.json
• Windows: %USERPROFILE%\.claude\settings.json

完整配置示例#

1
{
2
  "env": {
3
    "ANTHROPIC_AUTH_TOKEN": "你的API密钥",
4
    "ANTHROPIC_BASE_URL": "http://localhost:8000",
5
    "API_TIMEOUT_MS": "3000000",
6
    "ANTHROPIC_MODEL": "glm-5",
7
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
8
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1",
9
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "glm-5",
10
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-5",
11
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-5"
12
  }
13
}

配置项详解#

高级配置说明#

1
"ANTHROPIC_BASE_URL": "http://localhost:8000"

配置文件位置#

你的项目目录/.claude/settings.local.json

权限配置示例#

1
{
2
  "permissions": {
3
    "allow": [
4
      "Bash(*)",
5
      "Read(*)",
6
      "Write(*)",
7
      "Edit(*)",
8
      "MultiEdit(*)",
9
      "NotebookEdit(*)",
10
      "WebSearch(*)"
11
    ]
12
  }
13
}

为什么要配置权限？#

配置项目级权限可以：

• 减少确认提示：不需要频繁按回车确认
• 提高工作效率：特别是夜间编程或长时间任务
• 自定义项目需求：不同项目可以有不同的权限设置

权限说明#

💡 提示：对于个人项目，可以放开所有权限以提高效率。对于重要的生产环境项目，建议谨慎配置。

关键配置项#

1
{
2
  "hasCompletedOnboarding": true
3
}

主要用途#

• 跳过新手引导：将 hasCompletedOnboarding 设置为 true 可以跳过首次使用时的引导流程
• 存储账户信息：保存你的登录状态和偏好设置
• 同步用户数据：在不同设备间保持设置一致

1. 分层配置策略#

1
全局配置 (~/.claude/settings.json)
2
    ↓ 基础设置和 API 配置
3
项目配置 (project/.claude/settings.local.json)
4
    ↓ 项目特定权限和规则
5
用户设置 (~/.claude.json)
6
    ↓ 个人偏好和账户信息

2. 安全建议#

• ✅ 使用环境变量：敏感信息（如 API Key）可以通过环境变量设置
• ✅ 权限最小化：只授予必要的权限
• ✅ 定期检查配置：定期审查和更新配置文件
• ❌ 不要提交到版本控制：将 .claude/ 目录添加到 .gitignore

3. 性能优化#

1
{
2
  "env": {
3
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
4
    "API_TIMEOUT_MS": "3000000"
5
  }
6
}

• 启用流量节省可以减少不必要的网络请求
• 适当设置超时时间避免任务中断

4. 团队协作#

在团队项目中，可以创建共享的配置模板：

1
# 项目根目录创建模板文件
2
.claude/settings.local.json.template

团队成员可以根据模板创建自己的配置：

1
cp .claude/settings.local.json.template .claude/settings.local.json

Q1: 找不到配置文件怎么办？#

配置文件会在首次运行 Claude Code 时自动创建。如果不存在，可以手动创建：

1
mkdir -p ~/.claude
2
touch ~/.claude/settings.json

Q2: API 调用失败怎么办？#

1. 检查 API 密钥是否正确
2. 确认网络连接正常
3. 如果使用代理，检查 ANTHROPIC_BASE_URL 设置
4. 查看错误日志获取详细信息

Q3: 如何恢复默认配置？#

删除配置文件后重新运行 Claude Code：

1
rm ~/.claude/settings.json
2
claude

Q4: 项目权限不生效？#

确保配置文件位置正确：

• 必须是 项目根目录/.claude/settings.local.json
• 文件名必须是 settings.local.json（不是 settings.json）