💻 Claude Code - AI 终端编程助手¶

本页介绍如何将 Anthropic Claude Code CLI 配置为通过 agtcloud 网关 访问模型，包括：

在控制台创建专用令牌
安装 Claude Code 工具
配置环境变量，让 Claude Code 走 https://api-cs-al.naci-tech.com/ 网关

1️⃣ 在控制台创建 Claude Code 专用令牌¶

打开控制台令牌页面：
https://api-cs-al.naci-tech.com/console/token
点击「创建令牌」。
在 分组/标签 选项中，选择或创建分组：claude code。
建议单独使用该分组，便于统计与权限管理。

2️⃣ 安装 Claude Code¶

Claude Code 是 Anthropic 官方提供的终端编程助手，支持 macOS / Linux / Windows（含 PowerShell / WSL）。
你可以根据系统选择一种安装方式。

macOS / Linux / WSL（推荐：官方安装脚本）¶

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

安装完成后，重新打开终端，然后执行：

claude --version

若能正常输出版本号，说明安装成功。

Windows（PowerShell）¶

在 PowerShell 中执行：

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

同样可以用下面命令检查版本：

claude --version

其他安装方式（可选）¶

如果你更习惯使用包管理器，也可以参考下面方式安装（任选其一）：

npm（Node.js ≥ 18）

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

Homebrew（macOS）

brew install claude-code

3️⃣ 配置环境变量指向 agtcloud 网关¶

为了让 Claude Code 通过 agtcloud 网关访问模型，需要设置以下环境变量。

macOS / Linux（bash / zsh）¶

在终端中执行（把 <您的令牌> 换成在控制台生成的令牌）：

export ANTHROPIC_BASE_URL="https://api-cs-al.naci-tech.com/"
export ANTHROPIC_AUTH_TOKEN="<您的令牌>"
export ANTHROPIC_MODEL="claude-sonnet-4-5-20250929"

提示： - ANTHROPIC_MODEL 可以替换为你需要使用的任意模型名称。
- 也可以在进入 Claude Code 后使用 /model <模型名> 命令临时切换模型，例如：/model claude-3-5-sonnet-20241022。

为了每次打开终端都自动生效，建议将上述三行追加到你的 shell 配置文件中，例如：

echo 'export ANTHROPIC_BASE_URL="https://api-cs-al.naci-tech.com/"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="<您的令牌>"' >> ~/.zshrc
echo 'export ANTHROPIC_MODEL="claude-sonnet-4-5-20250929"' >> ~/.zshrc

source ~/.zshrc

如果你使用的是 bash，将 ~/.zshrc 改为 ~/.bashrc 即可。

Windows（PowerShell）¶

在 PowerShell 中可以使用下面的方式设置（当前会话）：

$env:ANTHROPIC_BASE_URL = "https://api-cs-al.naci-tech.com/"
$env:ANTHROPIC_AUTH_TOKEN = "<您的令牌>"
$env:ANTHROPIC_MODEL = "claude-sonnet-4-5-20250929"

若希望长期生效，可以使用：

[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api-cs-al.naci-tech.com/", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "<您的令牌>", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL", "claude-sonnet-4-5-20250929", "User")

重新打开一个终端窗口后，环境变量即可生效。

4️⃣ 验证是否通过 agtcloud 网关¶

在配置好环境变量的终端中执行：

claude

进入任意项目目录，尝试发起一次对话或运行一个简单命令（例如要求它读取当前目录代码）。
返回到 agtcloud 控制台，在「使用日志」中确认对应调用是否已经记录，并且分组为 claude code。

如果能在控制台看到调用记录，说明 Claude Code 已经成功通过 agtcloud 网关进行访问。