【新手向】Claude Code 零基础上手指南（Windows/Mac/Linux全覆盖）

常威正在打来福
0 阅读4分钟

Claude Code 是 Anthropic 官方推出的命令行编程助手，小白也能 3 分钟上手，支持自定义模型配置！

📌 Claude Code 是什么？

Claude Code 是 Anthropic（Claude 的开发商）推出的命令行编程助手。说人话就是：你在终端里跟它说话，它就能帮你写代码、改 bug、解释代码、帮你做项目。

它支持配置自定义模型，你可以用 Claude、GPT、Gemini 等各种 AI 模型来驱动它，非常灵活。

📦 安装前准备

Claude Code 需要用 Node.js 来安装，所以在安装 Claude Code 之前，你需要先装好 Node.js（就像安装游戏前要先装好操作系统一样 😄）。

Node.js 安装方法

  • Windows： 去 nodejs.org 下载「LTS」版本，安装包一路点下一步即可
  • Mac： 去 nodejs.org 下载，或者打开终端输入：brew install node
  • Linux： 打开终端输入：sudo apt install nodejs npm

💡 装好后，打开终端（Windows 按 Win+R 输入 cmd 或 PowerShell），输入 node -v 和 npm -v，看到版本号就说明装好了！

💻 方法一：npm 安装（Windows / Mac / Linux 通用）

打开你的终端，输入以下命令：

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

💡 npm 是 Node.js 自带的包管理器，装好 Node.js 后就能用这个命令了。

✅ 装好后，输入 claude --version 看到版本号就说明安装成功！

🍎 方法二：Homebrew 安装（Mac / Linux 推荐）

如果你用 Mac 或 Linux，而且装了 Homebrew（一个包管理神器），可以用这个命令安装：

brew install claude-code

💡 没有 Homebrew？Mac 打开终端，粘贴下面这行命令安装：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

🪟 方法三：直接下载（不需要安装 Node.js）

不想装 Node.js？也可以直接下载 Claude Code 的可执行文件：

  1. 打开浏览器，访问：github.com/anthropics/claude-code/releases
  2. 找到对应你系统的版本（Windows 选 .exe 或 .zip，Mac 选 .pkg 或 .tar.gz）
  3. 下载后解压，在解压的文件夹里找到可执行文件运行即可

🔑 获取 API Key

Claude Code 需要一个 API Key 才能连接 AI 模型，就像登录账号需要密码一样。

  1. 打开浏览器访问：console.anthropic.com
  2. 注册账号并登录（可以用 Google 账号）
  3. 左边菜单找到「API Keys」→「Create Key」
  4. 复制生成的 Key（一串很长的字母和数字）

拿到 Key 后，把它复制到剪贴板，然后根据你的系统粘贴到对应位置：

# Mac / Linux - 终端输入：
export ANTHROPIC_API_KEY=这里粘贴你的Key

# Windows PowerShell - 输入：
$env:ANTHROPIC_API_KEY = "这里粘贴你的Key"

⚠️ 注意：关闭终端窗口后 Key 就失效了，每次新开窗口需要重新输入。或者把上面的命令加到配置文件中自动加载（进阶操作，可自行搜索）。

🧠 怎么配置自定义模型？

Claude Code 默认用 Anthropic 官方的 Claude 模型。如果你想用其他模型（比如 OpenAI 的 GPT、或者更便宜的第三方模型），可以配置自定义模型。

第一步：创建配置文件

在你电脑的用户目录创建一个配置文件：

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

💡 ~ 代表你的用户主目录。Mac/Linux 打开终端输入 echo ~ 就能看到路径。

第二步：写入配置内容

用任意文本编辑器（Windows 用记事本，Mac 用 TextEdit，Linux 用 gedit 或 nano）打开或新建这个文件，写入以下内容（以 OpenRouter 为例）：

{
  "models": [
    {
      "name": "anthropic/claude-3.5-sonnet",
      "displayName": "Claude 3.5 Sonnet (OpenRouter)",
      "apiKey": "你的OpenRouter Key",
      "baseURL": "https://openrouter.ai/api/v1",
      "extraHeaders": {
        "HTTP-Referer": "https://your-site.com",
        "X-Title": "Claude Code"
      }
    }
  ],
  "defaultModel": "anthropic/claude-3.5-sonnet"
}

💡 OpenRouter 是一个聚合了各种 AI 模型的平台，注册后可以获取 Key，支持 Claude、GPT、Gemini 等多种模型。

🚀 第一次怎么用？

现在一切准备就绪，来试试 Claude Code 吧！

方式一：交互模式（推荐新手）

打开终端，进入你想操作的项目目录，然后输入：

claude

Claude Code 会启动，你可以像跟人聊天一样跟它说话，比如：

  • 「帮我写一个计算器程序」
  • 「这段代码什么意思？帮我解释一下」
  • 「有 5 个 bug，帮我一个一个修」

方式二：一次性任务

不用进入交互模式，直接一行命令搞定：

claude "帮我写一个 Python 快速排序"

# 指定项目目录
claude --dir ./my-project "解释这个文件夹里的代码"

# 指定用哪个模型
claude --model "openrouter/anthropic/claude-3.5-sonnet" "帮我重构这个函数"

💡 --dir 参数告诉 Claude Code 要操作哪个项目目录。

💡 实用技巧

  • Ctrl+L：上传文件或文件夹给 Claude Code 分析
  • Ctrl+C：退出当前对话
  • claude --help：查看所有可用命令
  • 允许执行命令：默认 Claude Code 只帮你写代码不会乱动你的文件。如果你想让它直接帮你执行命令（写文件、运行脚本等），加上参数：--dangerously-permit-unsafe-actions

📌 常见问题

Q：提示「command not found」或找不到 claude 命令？

A：npm 安装时加了 -g 全局安装，macOS/Linux 需要确认 PATH 里包含了 npm 的全局目录。可以运行 npm bin -g 查看路径。

Q：API Key 报 401 错误？

A：Key 过期或无效。去 console.anthropic.com 重新生成一个，确保复制时没有多余的空格。

Q：Windows 上终端推荐用哪个？

A：推荐用 PowerShell 或 Windows Terminal（微软商店可免费下载），比 CMD 功能更强。

好了，以上就是 Claude Code 的完整上手教程！从安装到配置到使用，小白也能轻松搞定。如果觉得有用，欢迎点赞收藏转发给需要的朋友 👇

👨‍💻 H先生出品 | 专注 AI 工具与效率提升

avatar
文章
阅读
粉丝