Claude Code：手动配置

Claude Code 可以通过配置文件或系统环境变量手动接入 HCAI。

接入信息

项目	内容
接入地址	https://ai.hctopup.com
密钥变量	ANTHROPIC_AUTH_TOKEN
Base URL 变量	ANTHROPIC_BASE_URL

配置文件方式

Claude Code 支持通过 settings.json 的 env 字段写入环境变量。配置文件位置：

平台	配置文件
Windows	%USERPROFILE%\.claude\settings.json
macOS / Linux	~/.claude/settings.json

如果文件或目录不存在，请手动创建。写入以下内容：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "替换为您的 HCAI Key",
    "ANTHROPIC_BASE_URL": "https://ai.hctopup.com",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5-20251001",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME": "claude-haiku-4-5-20251001",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-8[1M]",
    "ANTHROPIC_DEFAULT_OPUS_MODEL_NAME": "claude-opus-4-8",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-6",
    "ANTHROPIC_DEFAULT_SONNET_MODEL_NAME": "claude-sonnet-4-6",
    "ANTHROPIC_MODEL": "claude-opus-4-8"
  },
  "model": "opus[1m]",
  "hasCompletedOnboarding": true
}

保存后重新打开 Claude Code：

claude

Windows PowerShell 环境变量

如果不想编辑配置文件，也可以通过系统环境变量配置：

[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "替换为您的 HCAI Key", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://ai.hctopup.com", "User")

设置完成后，关闭并重新打开终端：

claude

macOS / Linux 环境变量

如果不想编辑配置文件，也可以写入当前 shell 的环境变量：

Bash：

echo 'export ANTHROPIC_AUTH_TOKEN="替换为您的 HCAI Key"' >> ~/.bashrc
echo 'export ANTHROPIC_BASE_URL="https://ai.hctopup.com"' >> ~/.bashrc
source ~/.bashrc

Zsh：

echo 'export ANTHROPIC_AUTH_TOKEN="替换为您的 HCAI Key"' >> ~/.zshrc
echo 'export ANTHROPIC_BASE_URL="https://ai.hctopup.com"' >> ~/.zshrc
source ~/.zshrc

启动 Claude Code：

claude

下一步

• Codex CLI：手动配置
• Claude Code：使用 CC-Switch 快速配置