Claude Code 安装与配置

环境准备

系统要求：macOS 13.0+、Windows 10 1809+、Ubuntu 20.04+、Debian 10+ 或 Alpine Linux 3.19+，内存 4 GB 以上
Node.js：使用官方安装脚本、Homebrew 或 WinGet 安装时不需要
Git for Windows：可选。安装后 Claude Code 使用 Git Bash 执行命令，否则使用 PowerShell

安装

macOS
Windows
Linux

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

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

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

brew install --cask claude-code

方法一：官方安装脚本（推荐）在 PowerShell 中运行：

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

在 CMD 中运行：

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

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

方法二：WinGet

winget install Anthropic.ClaudeCode

官方安装脚本（推荐）

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

也可以通过 apt、dnf、apk 安装，参考官方文档。

安装完成后，打开一个新的终端窗口，确认安装成功：

claude --version

创建 API Key

在 API 密钥页面新建一个 Key，分组选择包含 Claude 模型的分组。详见快速开始。

配置

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

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

settings.json

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://www.jiji.cc",
    "ANTHROPIC_AUTH_TOKEN": "your-api-key-here",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}

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

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

如果 settings.json 中已有其他配置，只需把这三项合并进 env，不要覆盖整个文件。

验证

在终端运行 claude，进入对话界面后输入 /status：

claude

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

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

在 VS Code 中使用

Claude Code 的 VS Code 扩展在登录检查时不读取 ~/.claude/settings.json，需要在 VS Code 用户设置中单独配置。

打开用户设置

按 Cmd+Shift+P（Windows/Linux 为 Ctrl+Shift+P），运行 Preferences: Open User Settings (JSON)。

添加配置

settings.json

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

重启 VS Code

重启后打开 Claude Code 面板即可使用。

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

遇到问题

Claude Code 常见问题

安装、配置与错误排查

快速开始

账户与计费

Claude Code

Claude Desktop

Codex

Gemini CLI

更多客户端

帮助中心

Claude Code 安装与配置

环境准备

安装

创建 API Key

配置

验证

在 VS Code 中使用

遇到问题

Claude Code 常见问题

​环境准备

​安装

​创建 API Key

​配置

​验证

​在 VS Code 中使用

​遇到问题

Claude Code 常见问题

环境准备

安装

创建 API Key

配置

验证

在 VS Code 中使用

遇到问题