跳转到内容
悠然 AI 文档

macOS：Claude Code

本页以 macOS 默认的 Zsh 为例，配置只写入当前用户的 ~/.zshrc。

在 macOS 上使用 Claude Code

Claude Code 在这里作为编码客户端，通过 Anthropic Messages 协议调用悠然 AI 提供的 GPT 模型。

  1. 确认适用方式

    适合希望在终端中使用 Claude Code 工作流，同时由悠然 AI 统一提供模型和用量管理的用户。

  2. 安装 Claude Code

    打开 终端，运行官方原生安装命令。Windows 建议同时安装 Git for Windows。

    Shell
    curl -fsSL https://claude.ai/install.sh | bash
    查看 Claude Code 官方安装文档

  3. 验证安装

    终端
    claude --version

    如果提示命令不存在，请关闭并重新打开终端后再次验证。

  4. 创建悠然 AI API Key

    前往控制台的访问密钥页面创建独立 Key。请勿把完整 Key 写入项目文件或提交到 Git。

    打开访问密钥页面

  5. 查询可用模型

    替换命令中的 API Key，执行后从返回的 data[].id 中选择一个模型 ID。

    终端
    curl -sS https://youran-ai.du-fu.com/api/models \\
  -H "Authorization: Bearer <YOURAN_API_KEY>"

  6. 写入用户级配置

    将占位符替换为真实 API Key 和模型 ID。所有 Claude Code 模型别名与子代理都映射到同一 GPT 模型。

    终端
    cat >> ~/.zshrc <<'EOF'
export ANTHROPIC_BASE_URL="https://youran-ai.du-fu.com/api"
export ANTHROPIC_AUTH_TOKEN="<YOURAN_API_KEY>"
export ANTHROPIC_MODEL="<MODEL_ID>"
export ANTHROPIC_DEFAULT_OPUS_MODEL="<MODEL_ID>"
export ANTHROPIC_DEFAULT_SONNET_MODEL="<MODEL_ID>"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="<MODEL_ID>"
export CLAUDE_CODE_SUBAGENT_MODEL="<MODEL_ID>"
EOF

source ~/.zshrc

  7. 发起第一次请求

    终端
    claude "请只回复：连接成功"

    收到模型回复后，可前往控制台的请求记录确认模型、Token 和状态。

  8. 遇到问题

    优先检查 Base URL 是否包含 /api、模型 ID 是否来自实时模型列表，以及终端是否已加载新环境变量。

    前往故障排查