Claude Code 怎么用：安装、登录与 API 接入步骤

小猫跳舞 技术创作者 2026-11-02 321 阅读

Claude Code 是 Anthropic 推出的命令行编程工具，能读取代码库、修改文件、执行命令，并通过自然语言完成开发和 Git 工作流。截至 2026 年 9 月，国内用户真正卡住的多半不是安装，而是登录、支付、网络连接和账号可用性。下面按“官方安装—账号登录—API 配置—常见报错”拆开说明，并明确哪些路径来自官方文档，哪些属于第三方接入方案。

先准备环境，再开始安装

Claude Code 可以运行在 macOS、Linux、Windows、WSL（Windows Subsystem for Linux，Windows 的 Linux 子系统）、VS Code、JetBrains、桌面端和网页端。对初次使用者来说，直接从 Terminal CLI（终端命令行界面）开始最容易验证。

1. 准备终端和项目目录

打开系统终端，进入准备让 Claude Code 修改的项目目录：

cd your-project

这里的 your-project 不是固定命令，而是需要替换成真实路径。例如项目放在桌面时，可以先执行 cd ~/Desktop，再进入具体项目文件夹。

2. 选择安装方式

官方当前推荐 Native Install，也就是由安装脚本直接安装 Claude Code。macOS、Linux 和 WSL 使用：

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

Windows PowerShell 使用：

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

Windows CMD 使用：

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

如果 macOS 已经安装 Homebrew，也可以使用：

brew install --cask claude-code

Windows 用户还可以使用 WinGet：

winget install Anthropic.ClaudeCode

官方仓库明确把 npm 安装标记为 deprecated（已弃用），因此新安装时优先使用脚本、Homebrew 或 WinGet，而不是：

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

这条命令仍可能出现在旧教程中，但不适合作为当前首选安装方案。

安装完成后，重新打开一个终端窗口，执行：

claude --version

只要终端打印出版本号，就说明安装成功。

官方订阅登录：账号和支付如何衔接

大多数 Claude Code 使用入口都需要 Claude 订阅或 Anthropic Console 账号。终端版第一次启动时会提示登录：

claude

随后按照终端提示完成账号登录。也可以在 VS Code 中安装 Claude Code 扩展：打开扩展面板，搜索“Claude Code”，安装后打开命令面板，输入 Claude Code，选择 Open in New Tab。

桌面端则从官方 Claude Code 文档中的 Desktop app 入口下载，安装后启动 Claude 并登录。官方账号体系在终端、VS Code、JetBrains 和桌面端之间保持一致；因此，不需要为不同客户端重复创建不同账号。

支付方面需要区分两种官方路径：

使用方式 需要的账号或凭证 适合用户
Claude 订阅 Claude 账号及对应订阅 已经在 Claude 账号体系中、希望直接使用官方功能的用户
Anthropic Console API Console 账号、API Key 和按量计费 需要程序化调用、希望按 API 用量付费的用户

国内用户常见的障碍是支付工具、账单地址和账号地区不匹配。第三方文章提到“没有海外信用卡就用不了 Claude Code”其实把支付、网络和服务条款混在了一起，但这不能简单理解成“换一张卡就全部解决”。支付工具能完成付款，不代表账号一定不会触发风控；网络能连通，也不代表服务条款允许在当前地区使用。

如果使用官方订阅，建议先确认：

  1. 当前账号和付款工具符合 Anthropic 的官方条款与地区要求。
  2. 登录域名和 API 请求域名在你的网络中都能正常访问。
  3. 不使用来路不明的共享账号、共享 API Key 或代登录服务。

官方文档的快速开始页和开发者平台分别是后续注册、登录与 API 配置的正式入口：

API Key 方式：不想订阅时怎么配置

终端版支持使用 ANTHROPIC_API_KEY 环境变量登录。设置后，第一次运行 claude 时，Claude Code 会询问是否使用这把 Key；确认后可以不显示常规账号登录提示。

Linux、macOS 和 WSL 的基本配置形式是：

export ANTHROPIC_API_KEY="你的 API Key"

Windows PowerShell：

$env:ANTHROPIC_API_KEY="你的 API Key"

上面的命令只对当前终端会话有效。若要长期保存，应把变量写入系统环境变量，而不是把真实 Key 提交到 Git 仓库。执行以下命令时，也要避免把完整 Key 粘贴到公开日志、截图或聊天记录：

claude

官方仓库还说明，Claude Code 会收集反馈、使用数据（例如代码接受或拒绝情况）、相关对话数据和用户反馈；如果这些内容不应进入官方数据处理流程，应先阅读其数据使用政策和隐私政策。

第三方接入不是官方 Claude 订阅

国内社区常见另一条路径，是把 Claude Code 指向第三方模型服务或 API 中转。此类方案通常通过修改 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN 等环境变量完成，模型可能来自国产厂商，也可能是 Claude 模型的中转服务。

这里必须分清三件事：

  • 官方订阅：使用 Claude 官方账号、官方入口和官方支持的订阅方式。
  • Anthropic API：使用自己的 API Key，由 Anthropic Console 按量计费。
  • 第三方接入：请求地址或模型由第三方提供，兼容性、数据处理和稳定性取决于服务商。

因此，第三方路径可以解决部分网络或支付问题，但不能自动等同于“官方 Claude Code 已开通”。选择第三方服务前，应核对它是否明确支持 Claude Code、使用什么模型、是否记录代码和提示词、日志保存多久，以及按什么方式计费。不要把生产项目的私钥、数据库密码和完整业务代码直接交给来源不明的服务。

安装和登录的常见卡点

1. 提示 claude isn’t found

官方文档给出的原因通常是安装目录还没有加入 PATH（系统用于查找可执行程序的环境变量路径）。执行：

claude --version

如果仍然找不到命令，重新打开终端；仍无效时，按官方文档中的 Fix your PATH 指引检查安装目录和 shell 启动文件。

2. PowerShell 中出现 The token '&&' is not a valid statement separator

官方说明这通常表示你在 PowerShell 中使用了 CMD 语法。Windows PowerShell 应使用 irm ... | iex；CMD 才使用 install.cmd 那条命令。

3. CMD 中出现 'irm' is not recognized as an internal or external command

这表示你在 CMD 里执行了 PowerShell 命令。退出当前 CMD，重新打开 PowerShell，再执行官方提供的 irm https://claude.ai/install.ps1 | iex。

4. 安装时出现 syntax error near unexpected token '<' 或 403

官方文档把这类安装失败归入安装排障范围，提示读者根据错误匹配修复方案或改用其他安装方式。最稳妥的替代方案是改用 Homebrew 或 WinGet，而不是反复修改同一条脚本命令：

brew install --cask claude-code

或：

winget install Anthropic.ClaudeCode

5. 安装成功但登录失败

先区分“程序找不到”和“账号不可用”：

claude --version

能显示版本号，说明本地安装正常；随后再处理账号、支付、网络或服务条款问题。官方安装页没有提供“国内专用登录地址”或绕过地区限制的操作，第三方文章中的代理地址也不应被写成官方方案。

如何确认已经跑通

成功不只看终端窗口打开，而要观察三个结果：

  1. claude --version 能打印版本号。
  2. 在项目目录运行 claude 后，能进入交互界面，并按提示完成登录或选择使用 API Key。
  3. 给出一个明确任务，例如“读取当前目录的 README.md，并概括安装步骤”，Claude Code 能返回结果或提出需要确认的文件修改。

如果使用 API Key，还要确认请求确实发往你配置的官方或第三方地址。若要排查官方接入，可先查看 Anthropic Console 的用量与账单页面；若使用第三方，则应向服务商确认其日志和模型配置。

延伸阅读可优先查看：

这套顺序的重点是：先用 claude --version 排除安装问题，再用 claude 区分账号、网络和支付问题，最后根据实际需求选择官方订阅、Anthropic API，或明确承担第三方接入风险的方案。

参考来源

# AI# 知识

评论区

0 条评论

登录后可评论。

小猫跳舞 321 阅读