AI Agent / 系统课时

准备运行环境

准备运行环境

安装 Claude Code 前,先确认操作系统、终端、网络、Git 和工作目录是否满足要求。提前完成这些检查,可以把后续问题快速区分为环境、安装、认证或项目本身的问题,而不是在多个变量之间反复猜测。

学习目标

  • 检查受支持的系统、硬件和终端
  • 验证网络、Git 与项目目录
  • 建立安装前的最小诊断记录

前置条件

当前官方要求覆盖 macOS 13 及以上、Windows 10 1809 及以上或 Windows Server 2019 及以上、Ubuntu 20.04 及以上、Debian 10 及以上,以及 Alpine Linux 3.19 及以上。硬件建议至少 4 GB 内存,并使用 x64 或 ARM64 处理器。

Claude Code 需要联网访问服务和下载资源。终端可以使用 Bash、Zsh、PowerShell 或 CMD。Linux 和 macOS 用户通常直接使用系统终端;Windows 用户应提前决定使用原生环境还是 WSL,避免安装位置和项目路径混用。

执行基础检查

在 macOS、Linux 或 WSL 中运行以下命令:

bash
uname -srm
printf 'shell=%s\n' "$SHELL"
git --version
curl --version | head -n 1
pwd
git rev-parse --show-toplevel 2>/dev/null || echo "当前目录不是 Git 仓库"

预期输出示例中的版本、架构和路径会因机器而异。

text
<OS> <KERNEL> <ARCH>
shell=<SHELL_PATH>
git version <VERSION>
curl <VERSION> ...
<PATH>
<REPOSITORY_PATH> 或 当前目录不是 Git 仓库

在 Windows PowerShell 中可使用:

powershell
[System.Environment]::OSVersion.Version
$PSVersionTable.PSVersion
git --version
curl.exe --version | Select-Object -First 1
Get-Location

预期输出应包含 Windows 版本、PowerShell 版本、Git 与 curl 版本,以及当前路径。具体值以本机为准。

检查项目目录

建议从目标仓库根目录启动 Claude Code。先确认 git status 可正常执行,并检查仓库中是否存在大型构建目录、密钥文件或不应被读取的本地数据。

项目在 WSL 中开发时,优先放在 WSL 的 Linux 文件系统,例如 ~/projects/app,而不是频繁跨越 /mnt/c。这能减少文件权限、大小写和搜索性能差异。原生 Windows 工具链项目则应留在 Windows 路径中,并从原生终端启动。

网络与账号准备

安装脚本、认证页面和模型请求都需要网络。企业代理环境应先确认 HTTPS 代理、证书和域名策略,不要通过关闭 TLS 校验来绕过问题。

账号方面,需要具备 Claude Code 访问资格的 Claude 订阅、Anthropic Console 账号,或组织配置的受支持云服务认证。安装成功与账号可用是两个独立条件,应分别验证。

典型失败处理

出现 git: command not found 时先安装 Git;出现 curl: command not found 时安装 curl;命令能下载但认证失败,则转到账号和网络策略检查。

若当前目录不是 Git 仓库,Claude Code 仍可启动,但无法可靠使用提交历史和差异信息。新项目可先初始化 Git,现有项目应进入正确仓库后再启动。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

准备运行环境

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通