Claude Code 安装与配置

Claude Code 安装与配置教程

本页介绍如何安装 Claude Code，并将其配置为使用跨界AI 服务

环境准备

[!NOTE]

系统要求：macOS 13.0+、Windows 10 1809+、Ubuntu 20.04+、Debian 10+ 或 Alpine Linux 3.19+，内存 4 GB 以上

Node.js：使用官方安装脚本、Homebrew 或 WinGet 安装时不需要 Node.js

Git for Windows：可选，安装后 Claude Code 可使用 Git Bash 执行命令；未安装时会改用 PowerShell

安装

macOS 方法一：官方安装脚本（推荐）

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

官方脚本安装的版本会在后台自动更新 方法二：Homebrew

brew install --cask claude-code

[!NOTE] claude-code 跟随稳定版通道，通常比最新版晚一周左右；想第一时间获取新版本可安装 claude-code@latest。Homebrew 安装的版本不会自动更新，需要手动运行 brew upgrade claude-code

Windows 方法一：官方安装脚本（推荐） PowerShell：

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

CMD：

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

[!TIP] 提示符以 PS C:\ 开头的是 PowerShell，没有 PS 的是 CMD。不需要以管理员身份运行

方法二：WinGet

winget install Anthropic.ClaudeCode

WinGet 安装的版本不会自动更新，需要定期运行 winget upgrade Anthropic.ClaudeCode 在 WSL 中使用 打开 WSL 终端，按 Linux 方式安装，并在 WSL 终端中启动 claude Linux 方法一：官方安装脚本（推荐）

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

方法二：系统包管理器 Debian、Ubuntu、Fedora、RHEL、Alpine 也可以通过 apt、dnf、apk 安装，参考官方文档安装完成后，打开一个新的终端窗口，运行以下命令确认安装成功

claude --version

能输出版本号（如 2.1.287 (Claude Code)）即表示安装成功。提示命令未找到时，参考常见问题

创建 API Key

在控制台创建 API Key 时，「厂商」选择「Anthropic」

配置

编辑配置文件，文件不存在时新建：

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

settings.json

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "your-api-key-here",
    "ANTHROPIC_BASE_URL": "https://api.kuajieaigc.com",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}

[!WARNING] 将 your-api-key-here 替换为你的 API Key。请求地址不要加 /v1

配置项	说明
`ANTHROPIC_AUTH_TOKEN`	你的 API Key
`ANTHROPIC_BASE_URL`	跨界AI 请求地址
`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`	关闭遥测、错误上报等非必要请求，减少国内网络下的连接报错。同时会关闭自动更新，需要定期手动运行 `claude update`

[!NOTE] 如果 settings.json 中已有其他配置，只需把上面的三项合并到 env 中，不要整体覆盖文件

验证

在终端运行 claude，看到对话界面后，输入 /status 查看当前配置

claude

Anthropic base URL 一行显示 https://api.kuajieaigc.com，说明请求地址已生效
Auth token 一行显示 ANTHROPIC_AUTH_TOKEN，说明 API Key 已生效

关闭 /status 后发送任意消息，能正常回复即表示配置完成

在 VS Code 中使用

Claude Code VS Code 扩展的登录检查不读取 ~/.claude/settings.json，需要在 VS Code 的用户设置中单独配置 1. 打开用户设置 在 VS Code 中按 Cmd+Shift+P（Windows/Linux 为 Ctrl+Shift+P），运行 Preferences: Open User Settings (JSON) 2. 添加配置 在设置中加入以下内容

settings.json

{
  "claudeCode.disableLoginPrompt": true,
  "claudeCode.environmentVariables": [
    { "name": "ANTHROPIC_BASE_URL", "value": "https://api.kuajieaigc.com" },
    { "name": "ANTHROPIC_AUTH_TOKEN", "value": "your-api-key-here" }
  ]
}

3. 重启 VS Code 重启后打开 Claude Code 面板即可使用

[!WARNING] 不要把 API Key 写进项目目录下的 .claude/settings.json，该文件通常会提交到代码仓库

遇到问题

Claude Code 常见问题 查看 Claude Code 配置相关的常见问题

开始使用

API 与代码

Codex

Claude

Gemini

客户端

帮助

环境准备

安装

创建 API Key

配置

验证

在 VS Code 中使用

遇到问题

​环境准备

​安装

​创建 API Key

​配置

​验证

​在 VS Code 中使用

​遇到问题

环境准备

安装

创建 API Key

配置

验证

在 VS Code 中使用

遇到问题