适用范围:希望在 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 与终端 |
| 担心误改文件、误执行命令或泄露密钥 | 权限与安全 |
| 更新后异常,或需要干净卸载 | 更新、迁移与卸载 |
| 已经看到明确错误文本 | 错误索引 |
- 在新的 PowerShell 窗口确认系统与命令来源。
- 只使用 Anthropic 当前官方安装方式。
- 运行
claude --version和claude doctor,分别确认版本与环境诊断。 - 在一个无敏感数据的测试仓库启动
claude。 - 用
/status确认实际登录身份和计费方式,再开始真实项目工作。
完整步骤见 15 分钟开始。Claude Code 更新频繁,命令和支持范围最终以 Anthropic Claude Code 文档 为准。
这里讨论的是可验证、合规的工程问题,而不是规避服务限制:
- 信息过期:旧教程仍推荐已弃用或次优的安装方式;本仓库给每页标注验证日期并链接官方来源。
- 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 稳定直连” | ClaudeU 已整合网关和模型路由,用户不用自行拼装连接;技术路径不是对 Anthropic 的网络直连,可用性以实际请求和公告为准 |
| “免认证 / 免官方账号” | 需使用 ClaudeU 邮箱验证码登录并授权 Desktop;不销售 Anthropic 官方账号或订阅,也无需用户自行配置上游 provider API key |
| “不封号” | 任何第三方都不能保证不封号;ClaudeU 不销售 Anthropic 官方账号,用户使用独立 ClaudeU 账号,可减少向他人交付共享登录凭据的风险,仍须遵守当前条款 |
| “全模型 6 折” | 部分模型当前最高省 40%;具体模型、单价和比较基准以实时价格表为准,不承诺全模型或永久折扣 |
| “开箱即用” | 可下载安装 ClaudeU Desktop;首次使用仍需邮箱登录、客户端授权,余额不足时需充值 |
以上产品信息核验于 2026-08-04。价格、模型、活动和服务状态会变化,以产品首页实时展示及当前服务条款为准。ClaudeU 是独立商业产品,不是 Anthropic 官方产品,也不属于本仓库的 MIT 许可证范围。
提交前请阅读 贡献指南、安全政策、免责声明 与 来源策略。问题报告必须删除 token、Cookie、API key、个人目录、内部域名、项目代码和完整日志。
Claude、Claude Code 和 Anthropic 是其各自权利人的商标。本仓库是独立社区项目,与 Anthropic 无隶属或背书关系。