跳转到内容
悠然 AI 文档

macOS：Claude Code

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

在 macOS 上使用 Claude Code

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

  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 包含 gpt-6.1-sol。

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

  6. 写入用户级配置

    将 API Key 占位符替换为真实值。所有 Claude Code 模型别名与子代理均使用 GPT-6.1 Sol，并显式声明支持推理强度。

    终端
    cat >> ~/.zshrc <<'EOF'
export ANTHROPIC_BASE_URL="https://youran-ai.du-fu.com"
export ANTHROPIC_AUTH_TOKEN="<YOURAN_API_KEY>"
export ANTHROPIC_MODEL="gpt-6.1-sol"
export ANTHROPIC_DEFAULT_OPUS_MODEL="gpt-6.1-sol"
export ANTHROPIC_DEFAULT_OPUS_MODEL_SUPPORTED_CAPABILITIES="effort"
export ANTHROPIC_DEFAULT_SONNET_MODEL="gpt-6.1-sol"
export ANTHROPIC_DEFAULT_SONNET_MODEL_SUPPORTED_CAPABILITIES="effort"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="gpt-6.1-sol"
export ANTHROPIC_DEFAULT_HAIKU_MODEL_SUPPORTED_CAPABILITIES="effort"
export CLAUDE_CODE_SUBAGENT_MODEL="gpt-6.1-sol"
EOF

source ~/.zshrc

  7. 发起第一次请求

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

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

  8. 遇到问题

    优先检查 Base URL 是否为 https://youran-ai.du-fu.com、模型 ID 是否来自实时模型列表，以及终端是否已加载新环境变量。

    前往故障排查