接入 Claude Code

为 Claude Code 配置 AIGCDesk API 地址和 API Key

本页用于说明如何在 Claude Code 中配置 AIGCDesk API 的基础地址与 API Key，并完成启动验证。

准备事项

• AIGCDesk API Key请先在 AIGCDesk API 控制台的 API 令牌 / Token 页面创建一枚新的 API Key。建议为 Claude Code 单独分配，避免与服务端应用共用。
• 基础地址基础地址使用 https://api.aigcdesk.com，无需额外拼接子路径。
• 本地配置文件安装完成后，请在用户目录下的 settings.json 中写入 API 地址、API Key，以及必填项 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1。

推荐配置

最小配置

如需先验证 Claude Code 能否通过 AIGCDesk 发起请求，建议先使用这份最小配置。将其写入对应系统的 settings.json 后，再替换为你的 API Key；其中 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 需要保留为 1。

settings.json

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.aigcdesk.com",
    "ANTHROPIC_AUTH_TOKEN": "你的 AIGCDesk API Key",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}

什么时候改用 apiKeyHelper？

如果你的团队会定期轮换密钥，或者希望通过 1Password、Keychain、Vault 这类工具动态读取密钥， 可以将静态的 ANTHROPIC_AUTH_TOKEN 改为 apiKeyHelper。首次验证时，优先使用静态 API Key 会更直接。 即使改用 apiKeyHelper，也仍需保留 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 为 1。

settings.json（进阶示例）

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.aigcdesk.com",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  },
  "apiKeyHelper": "echo 'YOUR_AIGCDESK_API_KEY'"
}

按操作系统配置

macOSWindowsLinux

macOS

适用于 macOS 13+。优先使用原生安装或 Homebrew；如终端首次找不到 claude 命令，请关闭并重新打开当前终端。

步骤 1：安装 Claude Code

推荐使用 Homebrew；如当前环境未使用 Homebrew，再执行官方安装脚本。

brew install --cask claude-code

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

步骤 2：准备配置文件目录

配置文件路径为 ~/.claude/settings.json。如目录不存在，请先创建。

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

步骤 3：写入上面的配置模板

将本页“推荐配置”中的 JSON 内容写入 ~/.claude/settings.json。

步骤 4：启动验证

重新打开终端后，先检查版本，再启动 Claude Code。

claude --version
claude

Windows

适用于 Windows 10 1809+ 与 Windows 11。建议先安装 Git for Windows，再使用 WinGet 或官方 PowerShell 安装脚本。

步骤 1：安装 Claude Code

优先使用 WinGet；如当前环境未启用 WinGet，再执行官方安装脚本。

winget install Anthropic.ClaudeCode

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

步骤 2：准备配置文件目录

配置文件位于当前用户目录下的 .claude/settings.json。以下命令会创建目录并打开记事本。

New-Item -ItemType Directory -Force "$HOME/.claude" | Out-Null
notepad "$HOME/.claude/settings.json"

步骤 3：写入上面的配置模板

将本页“推荐配置”中的 JSON 内容粘贴并保存。

步骤 4：启动验证

重新打开 PowerShell 或 Windows Terminal，然后执行：

claude --version
claude

Linux

适用于 Ubuntu 20.04+、Debian 10+ 等主流 glibc 发行版。服务器或远程开发环境可参考同样流程。

步骤 1：安装 Claude Code

Linux 环境建议直接使用官方安装脚本。

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

步骤 2：准备配置文件目录

配置文件路径为 ~/.claude/settings.json。

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

步骤 3：写入上面的配置模板

将本页“推荐配置”中的 JSON 内容写入 ~/.claude/settings.json。

步骤 4：启动验证

如果安装后当前 shell 仍找不到命令，请先重新登录 shell，再执行：

claude --version
claude

验收项

• 对应 Token 仍然可用如果对应 Token 已停用、过期、额度耗尽，或被模型限制拦住，Claude Code 虽可启动，但请求仍会在调用阶段失败。
• 基础地址没有写错请直接使用 https://api.aigcdesk.com，无需额外拼接子路径。
• 先确认基本配置，再补更多设置首次验证成功后，再根据团队要求补充权限、模型和密钥托管配置。

常见问题

为什么我不再推荐 npm install -g @anthropic-ai/claude-code？

Anthropic 已将 npm 全局安装列为 deprecated 安装方式。除非企业环境只能使用 Node.js 全局包，否则建议优先使用原生安装、Homebrew 或 WinGet。

命令安装成功了，但终端里提示 claude: command not found 怎么办？

请先完全关闭并重新打开终端。如果问题仍然存在，请回到当前系统的安装步骤重新执行，并确认安装器已将可执行文件加入当前用户的 PATH。

启动后提示鉴权失败，优先检查什么？

请优先检查以下三项：

• ANTHROPIC_BASE_URL 是否写成了 https://api.aigcdesk.com
• ANTHROPIC_AUTH_TOKEN 是否使用了正确的 AIGCDesk API Key
• CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 是否写成了 1
• 对应 Token 是否仍可用，是否还有额度，以及是否允许当前模型

如果你之前使用过 OpenRouter 一类服务，可以将这次接入理解为：将 Claude Code 的基础地址切换为 AIGCDesk。完成配置后，请求会经由 AIGCDesk 发出。