吉格api 文档

切换主题

Claude Code · macOS 使用指南 ​

Claude Code 可通过 Anthropic 兼容网关连接吉格api。模型可用范围以模型广场为准。

（一）安装 Claude Code ​

使用官方安装脚本：

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

也可以使用 Homebrew：

bash
brew install --cask claude-code

确认安装：

bash
claude --version

（二）接入吉格api ​

方法一：配置文件（推荐） ​

创建或编辑 ~/.claude/settings.json：

json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://chickener.cc.cd",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
    "ANTHROPIC_MODEL": "YOUR_MODEL_ID",
    "ANTHROPIC_DEFAULT_FABLE_MODEL": "YOUR_MODEL_ID",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "YOUR_MODEL_ID",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "YOUR_MODEL_ID",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "YOUR_SMALL_MODEL_ID"
  }
}

ANTHROPIC_AUTH_TOKEN 会使用 Bearer 鉴权。配置文件位于用户主目录，不要把包含密钥的文件复制到项目仓库。

方法二：环境变量 ​

将下面内容加入 ~/.zshrc：

bash
export ANTHROPIC_BASE_URL="https://chickener.cc.cd"
export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY"
export ANTHROPIC_MODEL="YOUR_MODEL_ID"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="YOUR_SMALL_MODEL_ID"

重新加载：

bash
source ~/.zshrc

指定模型（可选） ​

  • ANTHROPIC_MODEL：主模型。
  • ANTHROPIC_DEFAULT_FABLE_MODEL、ANTHROPIC_DEFAULT_OPUS_MODEL、ANTHROPIC_DEFAULT_SONNET_MODEL：Claude Code 使用对应模型类别时的映射。
  • ANTHROPIC_DEFAULT_HAIKU_MODEL：后台轻量任务使用的模型映射。

请把 YOUR_MODEL_ID 和 YOUR_SMALL_MODEL_ID 替换为模型广场中的实际模型 ID。旧变量 ANTHROPIC_SMALL_FAST_MODEL 已弃用，不建议写入新配置。

如果希望 SDK 使用 x-api-key 而不是 Bearer，可以把 ANTHROPIC_AUTH_TOKEN 改为 ANTHROPIC_API_KEY，但不要同时设置两者。

（三）开始使用 ​

进入项目目录后启动：

bash
cd /path/to/project
claude

进入 Claude Code 后运行：

text
/status

确认 Anthropic Base URL 为 https://chickener.cc.cd，并确认当前模型和认证变量符合配置，然后发送一条普通消息验证。

常见问题 ​

/status 仍显示其他 Base URL ​

检查 shell 环境变量和 ~/.claude/settings.json 是否同时存在冲突配置。当前 Claude Code 中，settings 文件的 env 值可能覆盖同名 shell 变量。

返回 401 ​

重新复制 API Key，确认没有空格或换行。使用 Bearer 时配置 ANTHROPIC_AUTH_TOKEN；使用 x-api-key 时配置 ANTHROPIC_API_KEY，不要混用。

找不到模型 ​

模型 ID 必须与模型广场完全一致。Claude Code 的自动模型发现只接受特定命名前缀，手工设置 ANTHROPIC_MODEL 通常更稳定。

命令安装后找不到 ​

重新打开终端并再次运行 claude --version。如果仍找不到，请根据安装器输出检查 PATH，而不要假设固定安装目录。