夜雨聆风学习资料网

ARTICLE · 1201565

Claude Code 安装使用教程来了

发布时间：2026-10-17 20:54:44 最近访问：2026-10-17 20:54:46
Claude Code 安装使用教程来了

Claude Code 是一款可以直接运行在终端中的 AI 编程助手。它不是那种“只能聊一聊”的工具，而是更贴近真实开发流程的协作型助手。你可以在项目目录里直接调用它，围绕代码、命令、文件和任务进行连续工作。

如果你正准备上手 Claude Code，这篇文章会带你从安装、验证、配置，到正式启动，完整走一遍流程。

使用前先确认环境

Claude Code 当前支持以下平台：

  • macOS 10.15 及以上
  • Ubuntu 20.04+ / Debian 10+
  • Windows 10 及以上

其中 Windows 环境通常需要配合：

  • WSL
  • 或 Git for Windows

此外还建议确认以下条件：

  • 内存不少于 4GB
  • Windows 安装阶段需要 Git
  • 如果使用 NPM 安装，需要 Node.js 18+
  • 网络需要满足 Anthropic 服务可访问条件

为什么优先推荐原生安装

Claude Code 有多种安装方式，但官方更推荐原生安装。原因主要有三点：

  • 它会安装成一个独立可执行文件
  • 不依赖 Node.js 环境
  • 自动更新的稳定性更好

如果你以前已经安装过 Claude Code，官方建议使用：

claude install

将现有安装迁移到原生二进制版本。

Windows 用户怎么装

1. 先安装 Git for Windows

Windows 原生安装 Claude Code 需要借助 Git Bash。下载地址：

https://git-scm.com/install/windows

安装完成后，可以执行：

git --version

确认 Git 已经可用。

2. 安装 Claude Code

随后打开 PowerShell 或 CMD，执行安装命令。

PowerShell：

irm https://claude.ai/install.ps1 | iex

CMD：

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

如果前两种方式都不顺利，也可以尝试：

winget install Anthropic.ClaudeCode

3. 把 Claude 加入 PATH

这是 Windows 用户最容易漏掉的一步。如果 PATH 没配好，PowerShell 可能会提示找不到 claude 命令。

通常需要加入的路径类似：

C:\Users\你的用户名\.local\bin

添加方式为：

  1. 打开系统属性
  2. 进入环境变量
  3. 编辑用户 PATH
  4. 新建并添加上述路径

然后重启终端，必要时重启电脑。

macOS / Linux 怎么装

如果你使用的是 macOS、Linux 或 WSL，最常见的安装方式是：

curl -fsSL https://claude.ai/install.sh | bash

如果本机安装了 Homebrew，也可以使用：

brew install --cask claude-code

另外，如果你本来就有 Node.js 18+，也可以选择 NPM 安装：

npm install -g @anthropic-ai/claude-code

安装完成后，建议在新终端执行：

claude --version

如果能够正确输出版本号，说明安装阶段已经完成。

真正决定是否能用的，是配置

很多人装完工具后，发现依然不能正常使用。问题往往不在安装本身，而在配置项没有写对。

Claude Code 这里最重要的是两项：

  • ANTHROPIC_AUTH_TOKEN
  • ANTHROPIC_BASE_URL

其中：

  • ANTHROPIC_AUTH_TOKEN 需要在 LetAiCode 的接口密钥页面创建，类型选择 claude code
  • ANTHROPIC_BASE_URL 使用 https://letaicode.cn/claude

settings.json 放在哪里

配置文件一般位于：

  • Windows：C:\Users\用户名\.claude\settings.json
  • macOS：~/.claude/settings.json
  • Linux：~/.claude/settings.json

将下面内容写入文件：

{"env": {"ANTHROPIC_AUTH_TOKEN": "sk-你的API令牌","ANTHROPIC_BASE_URL": "https://letaicode.cn/claude","ANTHROPIC_MODEL": "claude-sonnet-4-5-20250929","ANTHROPIC_SMALL_FAST_MODEL": "claude-haiku-4-5-20251001"  }}

这里要注意三点：

  1. ANTHROPIC_AUTH_TOKEN 必须替换成你自己的真实令牌
  2. 令牌通常以 sk- 开头
  3. ANTHROPIC_MODEL 可以替换成你想使用的其他模型 ID

macOS 或 Ubuntu 用户如果习惯命令行编辑，可以直接执行：

vim ~/.claude/settings.json

配好之后，怎么启动

进入你的项目目录：

cd /path/to/your/projectclaude

首次运行时，一般会经历一轮基础设置，例如：

  1. 选择主题
  2. 阅读并确认安全须知
  3. 接受默认 Terminal 配置
  4. 设置信任当前目录

走完这些流程后，就可以开始正式使用 Claude Code。

一些常见问题，提前说清楚

1. 提示 “Invalid API Key / Please run /login”

通常说明 Claude Code 没有成功读取到配置。优先检查：

  1. ANTHROPIC_AUTH_TOKEN 是否存在
  2. ANTHROPIC_BASE_URL 是否存在
  3. 令牌内容是否正确
  4. 修改配置后是否重启了终端

2. PowerShell 提示脚本执行策略报错

请用管理员权限启动 PowerShell，然后执行：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned

3. 状态显示 “offline”

Claude Code 会通过 Google 连接状态做网络判断。所以显示 offline 不一定代表服务完全不可用，它更多只是提示网络检测结果。

4. Fetch 失败、总是提示 “fetch failed”

这种情况大多和网络环境有关。可以尝试：

  1. 切换更稳定的网络环境
  2. 必要时使用代理
  3. 退出后重新运行 claude

5. 网页登录异常

建议先清除站点 Cookie，再重新登录。

写在最后

Claude Code 真正的价值，不只是“多了一个 AI 工具”，而是它把 AI 协作真正带进了终端和项目现场。一旦安装和配置跑通，你会发现很多原本分散的操作，开始可以在一个连续的工作流里完成。

所以这件事最重要的不是研究太久，而是先把它装好、配好、跑起来。先用起来，后面的效率提升才有意义。

相关学习资料