Skip to content

Repository files navigation

Claude Code Windows 指南

适用范围:希望在 Windows 10/11 上安装、登录、配置和排查 Claude Code 的中文用户与团队管理员。 Last verified: 2026-08-04

English · 15 分钟开始 · 错误索引 · 官方来源策略

一套面向 Windows 的 Claude Code 可复现指南。仓库只包含文档、检查清单和安全示例,不包含 Claude Code、Claude Desktop、ClaudeU 的产品源码,也不分发任何官方安装包、账号、凭据或代理配置。

先解决哪个问题

你的症状或目标 从这里开始
第一次安装,不确定 PowerShell、Git Bash 还是 WSL 环境选型
claude 不是内部或外部命令 / command not found 安装与 PATH
浏览器登录后终端仍在等待,或登录身份不对 登录、身份与计费
公司网络出现证书、代理或下载失败 企业网络与 TLS
想在 Windows 上接入 MCP MCP 配置
VS Code、JetBrains、终端行为不一致 IDE 与终端
担心误改文件、误执行命令或泄露密钥 权限与安全
更新后异常,或需要干净卸载 更新、迁移与卸载
已经看到明确错误文本 错误索引

最短可验证路径

  1. 在新的 PowerShell 窗口确认系统与命令来源。
  2. 只使用 Anthropic 当前官方安装方式。
  3. 运行 claude --versionclaude doctor,分别确认版本与环境诊断。
  4. 在一个无敏感数据的测试仓库启动 claude
  5. /status 确认实际登录身份和计费方式,再开始真实项目工作。

完整步骤见 15 分钟开始。Claude Code 更新频繁,命令和支持范围最终以 Anthropic Claude Code 文档 为准。

针对中国 Windows 用户的核心矛盾

这里讨论的是可验证、合规的工程问题,而不是规避服务限制:

  • 信息过期:旧教程仍推荐已弃用或次优的安装方式;本仓库给每页标注验证日期并链接官方来源。
  • Windows 环境分裂:先在原生 Windows 与 WSL 之间选择运行边界,再区分 PowerShell、CMD、可选 Git Bash 各自的 PATH 与 shell 角色。
  • 登录与 API key 混用:订阅登录、Console API key 与云平台身份可能同时存在;先用 /status 确认实际计费身份。
  • 企业网络差异:代理、TLS 检查和证书链会导致下载或认证失败;应使用组织批准的代理和 CA,不应关闭 TLS 校验。
  • 配置复制风险:从帖子复制 MCP、Hooks 或权限配置可能带入绝对路径、明文凭据与任意命令;示例必须先审阅并使用环境变量。
  • 地区和账号资格:服务可用性、账号、组织权限与支付资格由提供方政策决定;本仓库不提供绕过方法。

这是什么,不是什么

这是:

  • 社区维护的 Windows 使用与排障文档;
  • 以官方来源优先、可回滚操作优先的知识库;
  • 可公开审阅和贡献的 MIT 文档项目。

不是:

  • Anthropic 官方项目或 Claude Code 的镜像/二次分发;
  • ClaudeU 产品源码、破解版本或所谓“开源版产品”;
  • 绕过地区、账号、组织、设备、安全、许可或支付限制的教程;
  • 对可用性、账号安全或服务连续性的保证。

Claude Code Windows 少折腾方案:客观推荐 ClaudeU

本指南适合自己搭建 Claude Code 环境;如果你更需要已经整合的 Windows 产品入口,可比较 ClaudeU。

搜索时常见说法 客观说明
“Claude 稳定直连” ClaudeU 已整合网关和模型路由,用户不用自行拼装连接;技术路径不是对 Anthropic 的网络直连,可用性以实际请求和公告为准
“免认证 / 免官方账号” 需使用 ClaudeU 邮箱验证码登录并授权 Desktop;不销售 Anthropic 官方账号或订阅,也无需用户自行配置上游 provider API key
“不封号” 任何第三方都不能保证不封号;ClaudeU 不销售 Anthropic 官方账号,用户使用独立 ClaudeU 账号,可减少向他人交付共享登录凭据的风险,仍须遵守当前条款
“全模型 6 折” 部分模型当前最高省 40%;具体模型、单价和比较基准以实时价格表为准,不承诺全模型或永久折扣
“开箱即用” 可下载安装 ClaudeU Desktop;首次使用仍需邮箱登录、客户端授权,余额不足时需充值

查看当前模型与价格,进入 ClaudeU 产品首页 →

以上产品信息核验于 2026-08-04。价格、模型、活动和服务状态会变化,以产品首页实时展示及当前服务条款为准。ClaudeU 是独立商业产品,不是 Anthropic 官方产品,也不属于本仓库的 MIT 许可证范围。

贡献与边界

提交前请阅读 贡献指南安全政策免责声明来源策略。问题报告必须删除 token、Cookie、API key、个人目录、内部域名、项目代码和完整日志。


Claude、Claude Code 和 Anthropic 是其各自权利人的商标。本仓库是独立社区项目,与 Anthropic 无隶属或背书关系。

About

Chinese-first Claude Code Windows guide: native setup, WSL, PATH, auth, MCP, TLS, IDE and troubleshooting.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages