Claude 代码
Claude Code 入门指南
了解如何安装、认证和开始使用 Claude Code。
检查系统要求
- 操作系统: macOS 10.15+、Ubuntu 20.04+/Debian 10+ 或通过 WSL 使用 Windows
- 硬件: 最低 4GB 内存
- 软件:
- 网络: 需要互联网连接用于认证和 AI 处理
- 地区: 仅在支持的国家可用
WSL 安装故障排除
目前,Claude Code 不能直接在 Windows 上运行,需要使用 WSL。如果您在 WSL 中遇到问题:
-
操作系统/平台检测问题: 如果在安装过程中收到错误,WSL 可能在使用 Windows 的
npm
。请尝试:- 在安装前运行
npm config set os linux
- 使用
npm install -g @anthropic-ai/claude-code --force --no-os-check
进行安装(不要使用sudo
)
- 在安装前运行
-
找不到 Node 错误: 如果运行
claude
时看到exec: node: not found
,您的 WSL 环境可能在使用 Windows 版本的 Node.js。您可以通过which npm
和which node
确认,这些命令应该指向以/usr/
开头的 Linux 路径,而不是/mnt/c/
。要解决这个问题,请尝试通过 Linux 发行版的包管理器或通过nvm
安装 Node。
安装和认证
1
安装 Claude Code
Install NodeJS 18+, then run:
Do NOT use sudo npm install -g
as this can lead to permission issues and
security risks. If you encounter permission errors, see configure Claude
Code for recommended solutions.
2
导航到您的项目
3
启动 Claude Code
4
完成认证
Claude Code 提供多种认证选项:
- Anthropic Console: 默认选项。通过 Anthropic Console 连接并完成 OAuth 流程。需要在 console.anthropic.com 上有活跃的计费。
- Claude App(带 Max 计划): 订阅 Claude 的 Max 计划,一个订阅同时包含 Claude Code 和网页界面。以相同的价格获得更多价值,同时在一处管理您的账户。使用您的 Claude.ai 账户登录。在启动时,选择与您的订阅类型相匹配的选项。
- 企业平台: 配置 Claude Code 以使用 Amazon Bedrock 或 Google Vertex AI 进行企业部署,使用您现有的云基础设施。
初始化您的项目
对于首次使用的用户,我们建议:
1
启动 Claude Code
2
运行一个简单的命令
3
生成 CLAUDE.md 项目指南
4
提交生成的 CLAUDE.md 文件
请求 Claude 将生成的 CLAUDE.md 文件提交到您的代码库。