Claude Code 配置

Claude Code 可以通过环境变量和 ~/.claude/settings.json 接入 custom。推荐在控制台左侧点击“API 密钥”，找到支持 Claude 模型的密钥，点击这一行的“使用密钥”。在弹窗中选择 Claude Code → 当前操作系统 → 下载一键配置，运行下载的文件后重新打开终端。

弹窗里的系统选项为“Windows PowerShell”“Windows CMD”和“macOS / Linux”。Windows 用户选择自己使用的终端类型；截图以 macOS / Linux 为例。

1安装 Claude Code

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

如果命令提示找不到 npm，请先安装 Node.js LTS，然后重新打开终端。

2创建 API 密钥

API 密钥（API Key）是客户端访问服务时使用的凭证。打开控制台左侧的“API 密钥”，找到准备使用的密钥；还没有时，先点击右上角“创建密钥”并完成创建。

确认密钥所属分组支持 Claude Code 使用的模型。截图中的密钥名称和分组仅为示例。

打开 API 密钥页面

3下载并运行一键配置

在目标密钥这一行的“操作”列点击使用密钥，打开“使用 API 密钥”弹窗。

点击弹窗中的“Claude Code”选项卡。再选择当前操作系统，然后点击下载一键配置脚本。

Windows 用户按自己使用的终端选择“Windows PowerShell”或“Windows CMD”；macOS 和 Linux 用户选择“macOS / Linux”。终端是输入并执行命令的窗口。

下载后打开终端（输入并执行命令的窗口），输入 sh 和一个空格，把下载的 .sh 文件拖入终端，然后按回车。等待脚本执行完成，再进行下一步。

看图操作

Claude Code 配置流程图

按照新版控制台截图，在“API 密钥”页点击“使用密钥”，选择 Claude Code 和当前操作系统，下载并运行一键配置脚本，最后重启客户端验证。

截图中的供应商名称是示例，仅用于定位操作入口。实际供应商名称或 ID 统一填写 custom；地址、密钥和模型请使用本页复制区的值。

界面可能随版本变化

1
第 1 步
在“API 密钥”页点击“使用密钥”
1. 1
  在目标密钥这一行的“操作”列点击“使用密钥”。
点击控制台左侧“API 密钥”，找到支持 Claude Code 模型的密钥，在这一行的“操作”列点击“使用密钥”。还没有密钥时，先点击右上角“创建密钥”并完成创建。截图中的名称和分组仅为示例，缩略密钥不能用于配置。
自行采集用户提供的控制台界面（版本未标注）核验于 2026-10-21
2
第 2 步
选择 Claude Code 并下载一键配置脚本
1. 1
  点击顶部的 Claude Code 选项卡。
2. 2
  选择自己的操作系统后，点击“下载一键配置脚本”，按本页说明运行下载的文件。
点击顶部“Claude Code”选项卡，再选择自己的操作系统。Windows 用户按使用的终端选择“Windows PowerShell”或“Windows CMD”；截图选中的是“macOS / Linux”。点击“下载一键配置脚本”，下载后打开终端，输入 sh 和一个空格，将下载的 .sh 文件拖入终端并按回车。等待脚本执行完成，再重新打开终端并运行 claude。
自行采集用户提供的控制台界面（macOS / Linux，版本未标注）核验于 2026-10-21
3
第 3 步
重新打开 Claude Code 并发送测试任务
1. 1
  这里显示刚提交的任务和执行状态。
2. 2
  在输入区继续发送一句测试消息。
此图从官方演示中截取并裁去示例用户路径。看到任务状态和输入区，表示客户端已经正常启动。
官方仓库Claude Code 官方演示当前界面核验于 2026-08-26查看来源 ↗

看不清时：点击图片可放大；配置值请复制页面中的文字，不要照着截图手工输入密钥或地址。

4重启并验证

关闭原来的客户端和终端窗口，重新打开终端后再启动客户端。

claude

能够正常返回内容，就表示配置成功。

一键配置文件包含你的 API 密钥。配置完成后请妥善保管或删除下载文件。

一键配置不可用时，查看手动配置

配置文件是客户端启动时读取设置的文本文件。打开下面路径对应的文件，复制本页配置，将 sk-your-api-key 替换为自己的完整 API Key，然后保存。已有配置时先备份，并合并需要的字段，避免覆盖其他设置。

~/.claude/settings.json

{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "env": {
    "ANTHROPIC_BASE_URL": "",
    "ANTHROPIC_AUTH_TOKEN": "sk-your-api-key",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "CLAUDE_CODE_ATTRIBUTION_HEADER": "0"
  }
}

如何确认配置成功

重新打开终端，运行 claude 并发送一条简单消息。能够直接进入对话且正常返回内容，即表示配置成功。

如果客户端仍显示官方登录流程，通常是旧终端没有加载新环境变量。关闭所有 Claude Code 和终端窗口后重新打开，再运行 claude。

手动配置

如果不能运行一键配置，展开上方“一键配置不可用时，查看手动配置”，使用本页动态生成的 settings.json 内容。macOS / Linux 路径为 ~/.claude/settings.json，Windows 路径为 %USERPROFILE%\.claude\settings.json。已有文件时先备份，再合并 env 字段并保存。

ANTHROPIC_BASE_URL 是 Claude Code 连接 API 服务的地址，使用复制区提供的值，不要重复添加 /v1；ANTHROPIC_AUTH_TOKEN 填写自己的完整 API Key。保存后重新打开终端，再运行 claude。

使用注意

不要同时在多个位置设置不同的 ANTHROPIC_BASE_URL。
项目目录内的 Claude 配置可能覆盖用户目录配置。
切换 API Key 后需要重新运行一键配置。
一键配置文件和 settings.json 都包含 API Key，请勿分享或提交到 Git 仓库。
401：检查 API Key 是否复制完整、已被删除或失效。
模型不存在：确认密钥所属分组支持所选模型，并使用当前可用的模型名称。
连接失败：检查 API 地址是否重复添加了 /v1，以及运行 Claude Code 的电脑或容器能否访问该地址。

更多错误处理方法见常见问题。

Claude Code 配置 ​

1安装 Claude Code

2创建 API 密钥

3下载并运行一键配置

在“API 密钥”页点击“使用密钥”

选择 Claude Code 并下载一键配置脚本

重新打开 Claude Code 并发送测试任务

4重启并验证

如何确认配置成功 ​

手动配置 ​

使用注意 ​

Claude Code 配置

如何确认配置成功

手动配置

使用注意