开发者社区

文档建议反馈控制台

文章/答案/技术大牛

发布

社区首页 >专栏 >最新Claude Code 安装与使用指南：面向中国开发者的 Windows / macOS / Linux 实战教程

最新Claude Code 安装与使用指南：面向中国开发者的 Windows / macOS / Linux 实战教程

用户12545022

发布于 2026-06-08 13:27:01

发布于 2026-06-08 13:27:01

2.2K0

举报

概述

这篇文章会从零开始，完整讲清楚 Claude Code 的安装、配置、使用、排错和高级工作流。覆盖 Windows、macOS、Linux 三个环境，也会说明如果无法开通官方账号，可以如何通过中转方案解决接入问题。

文章被收录于专栏：claude codeclaude code

原创声明：本文系作者授权腾讯云开发者社区发表，未经许可，不得转载。

如有侵权，请联系 cloudcommunity@tencent.com 删除。

原创声明：本文系作者授权腾讯云开发者社区发表，未经许可，不得转载。

如有侵权，请联系 cloudcommunity@tencent.com 删除。

评论

登录后参与评论

0 条评论

热度

最新

目录

一、Claude Code 是什么？

二、安装前的环境准备
- 1. 系统要求
- 2. Node.js 要求
- 3. npm 要求
- 4. 网络环境说明

三、Windows 安装 Claude Code
- 1. Windows 方式一：使用 WSL 安装
- 2. Windows 方式二：使用 Git Bash 安装
- 3. Windows 常见问题
  - 问题 1：claude 不是内部或外部命令
  - 问题 2：PowerShell 执行脚本被禁止
  - 问题 3：中文乱码
  - 问题 4：WSL 下搜索很慢

四、macOS 安装 Claude Code
- 1. 安装 Node.js
- 2. 安装 Claude Code
- 3. 验证安装
- 4. macOS 常见问题
  - 问题 1：command not found: claude
  - 问题 2：权限错误 EACCES
  - 问题 3：zsh 配置没有生效

五、Linux 安装 Claude Code
- 1. Ubuntu / Debian 安装 Node.js
- 2. Fedora 安装 Node.js
- 3. Linux 常见问题
  - 问题 1：Node 版本太低
  - 问题 2：npm 全局安装权限错误
  - 问题 3：缺少 ripgrep 导致搜索问题

六、获取 Claude API Key 或登录 Claude Code
- 1. 官方账号方式
- 2. API Key 临时配置和永久配置
- 3. API Key 和订阅登录的优先级问题

七、中国开发者无法开通官方账号怎么办？
- 方案一：使用官方账号 + 合规网络环境
- 方案二：使用云平台接入
- 方案三：使用中转服务

八、Claude Code 配置方式
- 1. 环境变量配置
- 2. 配置文件目录
- 3. 配置文件示例
- 4. 排除敏感文件

九、使用 CC Switch 一键切换配置

十、初次使用 Claude Code
- 1. 推荐的第一次任务
- 2. Claude Code 正确工作流

十一、Claude Code 常用命令
- 1. 启动 Claude Code
- 2. 查看版本
- 3. 健康检查
- 4. 查看当前状态
- 5. 清理上下文
- 6. 压缩上下文
- 7. 恢复会话

十二、常见 Bug 与排查方法
- 1. npm 安装失败
- 2. claude: command not found
- 3. 权限错误 EACCES
- 4. API Key 无效
- 5. 403 Forbidden
- 6. 请求超时或中断
- 7. 中文输出乱码
- 8. Claude Code 卡住不动
- 9. 大项目响应很慢

十三、Claude Code 高级使用技巧
- 1. 给项目写 CLAUDE.md
- 2. 多项目管理
- 3. 多 Key 管理
- 4. 和 Codex / Gemini CLI 共存
- 5. 让 Claude Code 更稳定的提示词

十四、适合中国开发者的最短上手路径
- Windows 用户
- macOS 用户
- Linux 用户

十五、常见错误速查表
- 安装后找不到 claude
- npm 安装失败
- EACCES 权限错误
- API Key 无效
- 403
- 请求超时
- 中文乱码
- 大项目卡顿

十六、使用 Claude Code 的安全建议

十七、推荐的 Claude Code 开发流程

十八、总结