Claude Code 是 Anthropic 提供的编程工具,可在终端中检查项目、辅助修改代码,也有桌面与编辑器等使用方式。下面介绍命令行版本。服务能否使用取决于支持地区、账号及产品计划,安装完成不代表已经开通服务。
一、准备工作
根据官方安装文档,Claude Code 支持 macOS 13 及以上、Windows 10 1809 及以上以及指定 Linux 发行版;建议至少准备 4 GB 内存和可用网络。Windows 用户可根据项目需要选择原生 PowerShell 或 WSL。使用前准备可用的 Claude 订阅、Claude Console 账号,或官方支持的云服务访问方式。
二、macOS、Linux 和 WSL
打开终端,运行 Anthropic 官方推荐的安装命令:curl -fsSL https://claude.ai/install.sh | bash
安装完成后打开一个新的终端窗口,运行 claude --version。如果正常输出版本号,说明命令行程序可以启动。macOS 用户也可选择 brew install --cask claude-code;Homebrew 版本需要按官方说明手动更新。
三、Windows PowerShell
打开 PowerShell,运行 irm https://claude.ai/install.ps1 | iex。安装结束后重新打开 PowerShell,运行 claude --version。官方也提供 winget install Anthropic.ClaudeCode;只需选择一种安装方式。原生 Windows 可选装 Git for Windows,以便使用 Git Bash 相关功能;WSL 中则在 WSL 终端安装和运行。
四、登录并运行
进入自己有权操作的项目目录,输入 claude。首次启动时,按界面提示在浏览器中登录。Claude 订阅、Claude Console 和第三方云服务各有不同的访问与计费方式;不要假设某个订阅自动包含所有 API 用量,也不要公开密钥。
第一次可以请求“解释项目目录,不要修改文件”。之后如需让工具改文件,先查看其权限提示,完成后检查文件差异与测试结果。涉及上传文件、运行命令或访问外部系统时,按自己的需要决定是否授权。
五、排查与更新
找不到 claude:重新打开终端并检查 PATH。安装时出现 403、网络错误或登录失败:查看错误内容和官方支持地区、账号状态及网络设置,不要把它们混为同一种故障。官方说明原生安装可自动更新;Homebrew 和 WinGet 安装需要按其各自方式更新。
本文按官方文档整理,安装命令、平台要求和可用地区可能变化,请在执行前查看原文。