Claude Code配置卡死问题解决及settings.json配置分享

背景

在 Windows 11 环境下，通过 npm 全局安装 Claude Code（简称 CC）时，部分用户在使用第三方代理路由服务（如 anyrouter.top）调用 Anthropic 的 Claude 模型时，常遇到软件“卡住”或无法响应的问题。这通常与 settings.json 配置文件中的环境变量设置、模型路由指向以及代理配置不当有关。

本文分享了一位用户在经历多次配置调整后，成功解决 Claude Code 卡住问题的完整 settings.json 配置方案。该方案综合了多位社区用户的经验，旨在为遇到类似问题的用户提供一份可直接参考的配置模板，确保在通过代理访问 Anthropic API 时，对话及简单的电脑操作能稳定运行。

核心内容

该解决方案的核心在于对 Claude Code 的 settings.json 文件进行精细化配置，主要涉及 API 认证、模型路由、代理设置以及功能开关四个维度。

1. 环境变量配置 (env)

这是解决连接问题的关键部分，主要包含以下设置：

• API 认证与基础 URL：
  • ANTHROPIC_AUTH_TOKEN：设置为用户的 API Key（示例中为 sk-xxx）。
  • ANTHROPIC_BASE_URL：指向第三方路由服务 https://anyrouter.top，用于解决直连困难或加速访问。
• 模型路由映射：
  • 为了实现模型复用或特定路由，配置中将 Haiku、Opus、Sonnet 三个默认模型均指向了 claude-opus-4-8[1m] 这一具体模型版本。
  • 同时，ANTHROPIC_MODEL 也被显式设置为 claude-opus-4-8[1m]，确保默认调用该高性能模型。
  • 注意：ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME 等字段仅定义了名称，实际模型由上述 ANTHROPIC_DEFAULT_HAIKU_MODEL 等字段指定。
• 代理设置：
  • HTTP_PROXY 和 HTTPS_PROXY 均设置为 http://127.0.0.1:50000。这表明用户本地运行了一个代理服务（可能是 Clash、Surge 或其他代理工具），Claude Code 通过本地端口 50000 进行网络请求，从而绕过网络限制。
• 功能开关与行为控制：
  • CLAUDE_CODE_ATTRIBUTION_HEADER: 设为 "0"，可能用于关闭或调整输出中的归属声明。
  • CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS: 设为 "1"，禁用实验性 Beta 功能，以提高稳定性。
  • CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC: 设为 "1"，禁用非必要的后台流量，减少潜在的网络干扰。
  • CLAUDE_CODE_EFFORT_LEVEL: 设为 "max"，将努力级别调至最大，可能影响模型处理任务的深度或资源分配。
  • ENABLE_TOOL_SEARCH: 设为 "true"，启用工具搜索功能，增强代码理解和执行能力。

2. 全局设置

• 默认模型："model": "opus[1m]"，指定全局默认模型为 Opus 系列（带 1m 后缀，可能指代特定版本或参数）。
• 状态行命令："statusLine" 配置了一个自定义命令 ~/.claude/ccline/ccline，用于在状态栏显示信息，padding 设为 0。
• 更新与权限：
  • "autoUpdatesChannel": "latest"：自动更新通道设为最新。
  • "skipDangerousModePermissionPrompt": true：跳过危险模式的权限提示，简化操作流程。
• 主题："theme": "dark"，使用深色主题。

关键要点

• 代理配置至关重要：在 Windows 环境下，通过设置 HTTP_PROXY 和 HTTPS_PROXY 指向本地代理端口（如 127.0.0.1:50000），是解决网络连通性和稳定性的关键步骤。
• 模型路由需明确：通过 ANTHROPIC_BASE_URL 指定路由服务，并显式设置 ANTHROPIC_MODEL 及各类默认模型变量，确保请求被正确转发至目标模型（如 claude-opus-4-8）。
• 禁用非必要功能提升稳定性：设置 CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS 和 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 为 "1"，有助于减少因实验性功能或后台通信导致的卡顿。
• 配置冗余与兼容性：虽然配置中部分字段可能看似冗余（如同时设置 Haiku/Opus/Sonnet 指向同一模型），但这种显式覆盖确保了在不同调用场景下模型的一致性。用户可根据自身需求精简。
• 环境依赖：该配置依赖于本地代理服务的正常运行（端口 50000）以及有效的 Anthropic API Key。

意义与影响

此配置方案为 Windows 用户在使用 Claude Code 时提供了具体的故障排除参考，特别是针对通过第三方路由和代理访问 Anthropic API 的场景。它展示了如何通过精细的环境变量控制来优化模型调用稳定性和功能体验。对于其他遇到类似卡住问题的用户，该 settings.json 模板可作为起点，帮助快速定位和解决网络或配置层面的问题，促进 Claude Code 在更广泛环境下的稳定使用。