Claude Code 安装使用教程

Claude Code 是 Anthropic 提供的终端代码智能体。本教程说明如何安装它，并通过 NexusAPI 进行配置和验证。

系统要求

支持的操作系统：macOS 13+、Ubuntu 20.04+、Debian 10+、Alpine Linux 3.19+ 或 Windows 10 1809+
硬件：4 GB 以上内存，x64 或 ARM64 处理器
Windows 可选安装 Git for Windows，以便使用 Git Bash
网络：可正常访问 NexusAPI 服务的网络连接

1. 安装 Claude Code

优先使用 Claude Code 官方提供的原生安装方式。原生安装不要求预先安装 Node.js。

macOS、Linux 或 WSL

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

Windows PowerShell

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

不需要以管理员身份运行 PowerShell。Windows 也可以通过 WinGet 安装：

winget install Anthropic.ClaudeCode

macOS Homebrew

brew install --cask claude-code

安装后运行以下命令进行只读检查：

claude --version
claude doctor

2. 配置 API 令牌

步骤 1：获取 API 令牌

名称：令牌名称

额度：按项目用途设置合理上限

分组：选择模型广场中可调用 Claude Code 所需模型的分组

其他选项：保持默认设置

步骤 2：打开配置文件目录

Claude Code 的用户级配置目录通常位于：

Windows: C:\\Users\\用户名文件夹\\.claude
macOS: ~/.claude
Linux: ~/.claude

macOS 可在访达中按 Command + Shift + G，输入 ~/.claude 后打开该目录。如果目录不存在，可运行以下命令创建配置文件（适用 macOS / Linux / WSL / Git Bash）：

mkdir -p ~/.claude
touch ~/.claude/settings.json

Windows 可以先创建配置目录，再用记事本打开配置文件：

New-Item -ItemType Directory -Force "$env:USERPROFILE\.claude"
notepad "$env:USERPROFILE\.claude\settings.json"

如果文件已经存在，请把下面的 env 字段合并进去，不要覆盖原有的 MCP、权限或其他配置。

步骤 3：修改配置文件

在配置目录下新建或修改 settings.json，将 ANTHROPIC_AUTH_TOKEN 替换为自己的 API Key：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-您的 API 令牌",
    "ANTHROPIC_BASE_URL": "https://nexusapi.link"
  }
}

ANTHROPIC_AUTH_TOKEN 会以 Authorization: Bearer ... 方式发送给网关，适合 NexusAPI 的 API Key。不要把 Key 写入项目内的 .claude/settings.json，该文件可能被提交到仓库；请使用用户目录下的 ~/.claude/settings.json。

仅在兼容错误时关闭实验字段如果错误原文提示 context_management、Extra inputs are not permitted 等不支持字段，可在 env 中额外设置 CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1 后重试。它会关闭部分预发布字段，仅在这类兼容错误出现时使用即可。

3. 启动 Claude Code

配置修改完成后重启终端，然后进入到工程项目目录：

cd your-project-folder

在您的项目目录下输入 claude 即可启动并运行 Claude Code：

claude

启动后输入 /status，确认其中显示的 Anthropic base URL 是 https://nexusapi.link，并确认认证来源为 ANTHROPIC_AUTH_TOKEN。完成后即可开始使用 Claude Code。

无法连接到 Anthropic 服务

运行 claude 后如果出现以下错误：

Unable to connect to Anthropic services
Failed to connect to api.anthropic.com: ERR BAD REQUEST
Please check your internet connection and network settings.
Note: Claude Code might not be available in your country.

先运行 claude doctor，然后确认 ~/.claude/settings.json 中的 ANTHROPIC_AUTH_TOKEN 和 ANTHROPIC_BASE_URL 已保存且 JSON 格式正确。修改配置后关闭并重新打开终端，再运行 claude。不要通过脚本强行改写 .claude.json 中的内部状态字段。这些字段可能随版本变化，直接覆盖文件也可能丢失原有配置。问题仍然存在时，请保留 claude --version、claude doctor 输出和错误原文后联系支持。

常见问题解答

A: 这通常表示 Claude Code 未检测到环境变量。请检查：

是否正确设置了 ANTHROPIC_AUTH_TOKEN 和 ANTHROPIC_BASE_URL
环境变量值是否正确（令牌以 sk- 开头）
如果使用了永久配置，是否重启了终端

Q: PowerShell 无法安装脚本，遇到执行策略报错问题？

A: 可以先改用 Windows CMD 或官方 WinGet 安装方式。确实需要调整 PowerShell 策略时，只修改当前用户范围：

Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned

执行前请确认这是本机策略导致的问题；只修改当前用户范围即可。

Q: 为什么显示 “offline” 状态？

A: Claude Code 的部分辅助功能会单独检查官方或第三方服务连通性，可能不会经过 NexusAPI。先用 /status 确认网关地址，再发一条简短消息验证实际模型调用；“offline” 本身不一定表示 NexusAPI 不可用。

Q: 为什么浏览网页的 Fetch 会失败？

A: WebFetch 可能包含独立的域名安全检查或外部网络访问，不等同于模型接口调用。请先确认普通对话能否成功；若只有网页访问失败，请按 Claude Code 的错误原文和官方说明排查，NexusAPI Base URL 无需因此修改。

Q: 请求总是显示 “fetch failed”？

A: 先区分是模型调用失败，还是 Claude Code 的网页访问功能失败：

在 Claude Code 中发送一句最短文本；若能正常回复，说明 NexusAPI 的模型调用本身正常，WebFetch 等独立网络功能应按 Claude Code 的原始错误和网络环境排查。
若所有模型请求都出现 fetch failed，运行 claude doctor，再用 /status 确认 Anthropic base URL 仍是 https://nexusapi.link。
检查本机网络、公司防火墙、DNS 或代理是否阻断了 nexusapi.link；只在确有需要时使用受信任的系统或公司代理。
完全关闭并重新打开终端后，用新会话再测试一次。持续失败时，保存 claude --version、claude doctor 输出、错误原文和 Request ID，再按问题自查提交。

Q: API 报错如何处理？

A: 可能是网络连接或服务暂时不可用，建议：

退出 Claude Code（Ctrl+C）
重新运行 claude 命令
如果问题持续，请保存 Request ID 并参考问题自查

开始接入

模型与账单

客户端工具

故障排查

开发者接入

Claude Code 安装使用教程

系统要求

1. 安装 Claude Code

macOS、Linux 或 WSL

Windows PowerShell

macOS Homebrew

2. 配置 API 令牌

步骤 1：获取 API 令牌

步骤 2：打开配置文件目录

步骤 3：修改配置文件

3. 启动 Claude Code

无法连接到 Anthropic 服务

常见问题解答

Q: PowerShell 无法安装脚本，遇到执行策略报错问题？

Q: 为什么显示 “offline” 状态？

Q: 为什么浏览网页的 Fetch 会失败？

Q: 请求总是显示 “fetch failed”？

Q: API 报错如何处理？

相关链接

​系统要求

​1. 安装 Claude Code

​macOS、Linux 或 WSL

​Windows PowerShell

​macOS Homebrew

​2. 配置 API 令牌

​步骤 1：获取 API 令牌

​步骤 2：打开配置文件目录

​步骤 3：修改配置文件

​3. 启动 Claude Code

​无法连接到 Anthropic 服务

​常见问题解答

​Q: 遇到 “Invalid API Key · Please run /login” 错误？

​Q: PowerShell 无法安装脚本，遇到执行策略报错问题？

​Q: 为什么显示 “offline” 状态？

​Q: 为什么浏览网页的 Fetch 会失败？

​Q: 请求总是显示 “fetch failed”？

​Q: API 报错如何处理？

​相关链接

系统要求

1. 安装 Claude Code

macOS、Linux 或 WSL

Windows PowerShell

macOS Homebrew

2. 配置 API 令牌

步骤 1：获取 API 令牌

步骤 2：打开配置文件目录

步骤 3：修改配置文件

3. 启动 Claude Code

无法连接到 Anthropic 服务

常见问题解答

Q: 遇到 “Invalid API Key · Please run /login” 错误？

Q: PowerShell 无法安装脚本，遇到执行策略报错问题？

Q: 为什么显示 “offline” 状态？

Q: 为什么浏览网页的 Fetch 会失败？

Q: 请求总是显示 “fetch failed”？

Q: API 报错如何处理？

相关链接