Claude Code

使用 Codzen 与 Claude Code 来获得提供商故障转移、预算控制和使用情况可见性。

为什么使用 Codzen 与 Claude Code？

Codzen 在 Claude Code 和 Anthropic API 之间添加了可靠性和管理层，为您和您的组织提供了几个关键优势。

快速开始

本指南将在几分钟内让您使用 Codzen 运行 Claude Code。

步骤 1: 安装 Claude Code

macOS、Linux、WSL:

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

Windows PowerShell:

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

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

步骤 2: 将 Claude 连接到 Codzen

不是直接使用 Anthropic 登录，而是将 Claude Code 连接到 Codzen。这需要设置几个环境变量。

要求:

使用 https://codzen.ai 作为基础 URL
提供您的 Codzen API 密钥作为身份验证令牌
重要: 明确将 Anthropic API 密钥留空以防止冲突

将这些环境变量添加到您的 shell 配置文件:

# 用 nano 打开您的 shell 配置文件
nano ~/.zshrc # 或 Bash 用户的 ~/.bashrc

# 将这些行添加到文件:
export CODZEN_API_KEY="<your-codzen-api-key>"
export ANTHROPIC_BASE_URL="https://codzen.ai"
export ANTHROPIC_AUTH_TOKEN="$CODZEN_API_KEY"
export ANTHROPIC_API_KEY="" # 重要: 必须明确为空

# 保存后，重启终端以使更改生效

持久性: 我们建议将这些行添加到您的 shell 配置文件 (~/.bashrc、~/.zshrc 或 ~/.config/fish/config.fish)。

在您的项目目录中创建 .claude/settings.json 文件:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://codzen.ai",
    "ANTHROPIC_AUTH_TOKEN": "<your-codzen-api-key>",
    "ANTHROPIC_API_KEY": ""
  }
}

变量位置: 不要将这些放在项目级别的 .env 文件中。原生 Claude Code 安装程序不读取标准 .env 文件。

之前的登录: 如果您之前使用 Anthropic 登录过 Claude Code，请在 Codzen 配置生效之前在 Claude Code 会话中运行 /logout 以清除缓存的凭据。

步骤 3: 启动您的会话

导航到您的项目目录并启动 Claude Code:

cd /path/to/your/project
claude

您现在已连接！您发送的任何提示都将通过 Codzen 路由。

步骤 4: 验证

您可以通过在 Claude Code 内运行 /status 命令来确认您的连接。

> /status
Auth token: ANTHROPIC_AUTH_TOKEN
Anthropic base URL: https://codzen.ai

您也可以检查您的 Codzen 仪表板以查看您的请求实时出现。

工作原理

Codzen 公开了与 Anthropic Messages API 兼容的端点。

直接连接: 当您将 ANTHROPIC_BASE_URL 设置为 https://codzen.ai 时，Claude Code 直接使用其原生协议与 Codzen 通信。不需要本地代理服务器。
Anthropic 兼容性: Codzen 的 Anthropic 兼容端点的行为与 Anthropic API 完全相同。它处理模型映射并传递"Thinking"块和原生工具使用等高级功能。
计费: 您使用 Codzen 积分进行计费。使用情况 (包括推理令牌) 显示在您的 Codzen 仪表板中。

Agent SDK

Anthropic Agent SDK 允许您使用 Python 或 TypeScript 以编程方式构建 AI 代理。由于 Agent SDK 使用 Claude Code 作为其运行时，您可以使用上述相同的环境变量将其连接到 Codzen。

GitHub Action

您可以在官方 Claude Code GitHub Action 中使用 Codzen。要为 Codzen 调整示例工作流，请对操作步骤进行两项更改:

通过 anthropic_api_key 传递您的 Codzen API 密钥 (将其存储为名为 CODZEN_API_KEY 的 GitHub 密钥)
将 ANTHROPIC_BASE_URL 环境变量设置为 https://codzen.ai

- name: Run Claude Code
  uses: anthropics/claude-code-action@v1
  with:
    anthropic_api_key: ${{ secrets.CODZEN_API_KEY }}
  env:
    ANTHROPIC_BASE_URL: https://codzen.ai

故障排除

身份验证错误: 确保 ANTHROPIC_API_KEY 设置为空字符串 ("")。如果未设置 (null)，Claude Code 可能会回退到其默认行为并尝试使用 Anthropic 服务器进行身份验证。
上下文长度错误: 如果您达到上下文限制，请考虑将您的任务分解为较小的块或启动新会话。
隐私: 除非您在帐户设置中明确选择加入提示日志记录，否则 Codzen 不会记录您的源代码提示。有关详细信息，请参阅我们的隐私政策。

Claude Code

On this page