#Claude Code CLI

Claude Code 通过 Anthropic Messages 协议连接 Geekit。建议使用 Claude 系模型，以获得官方支持的工具调用、思考、缓存和长上下文行为。

核验日期：2026-07-29

#1. 配置永久环境变量

先在 API Keys 页面生成令牌。GEEKIT_API_KEY 是固定的环境变量名，它的值必须替换为生成的真实 Geekit 令牌。默认模型优先使用模型广场当前可用的最新 Claude 模型，本教程使用 claude-opus-5。

将以下内容写入 ~/.zshrc（Zsh）或 ~/.bashrc（Bash）：

export GEEKIT_API_KEY="<生成的真实 Geekit 令牌>"
export GEEKIT_MODEL="claude-opus-5"
export ANTHROPIC_BASE_URL="https://geekit.yryq.top"
export ANTHROPIC_AUTH_TOKEN="$GEEKIT_API_KEY"

保存后重新打开终端，或执行 source ~/.zshrc / source ~/.bashrc。PowerShell 使用用户级永久环境变量：

$geekitApiKey = "<生成的真实 Geekit 令牌>"
[Environment]::SetEnvironmentVariable("GEEKIT_API_KEY", $geekitApiKey, "User")
[Environment]::SetEnvironmentVariable("GEEKIT_MODEL", "claude-opus-5", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://geekit.yryq.top", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", $geekitApiKey, "User")
Remove-Variable geekitApiKey

设置后关闭并重新打开 PowerShell。GEEKIT_API_KEY 用于统一保存 Geekit 令牌，Claude Code 实际读取 ANTHROPIC_AUTH_TOKEN。如果 claude-opus-5 不在你的可用模型中，请把永久环境变量 GEEKIT_MODEL 替换为模型广场展示的最新 Claude 模型 ID。

#2. 安装 Claude Code

如果可以访问 Anthropic 官网，也可以按 Anthropic 官方 Claude Code 安装教程完成安装或更新。

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

安装后执行 claude --version 确认命令可用。随后保留本教程设置的 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN；使用 Geekit 时无需登录 Anthropic，也无需配置 Anthropic API Key。

开始配置前还需确认：

• 已取得 Geekit 根地址、用户令牌和 Claude 模型 ID。
• ANTHROPIC_BASE_URL 使用根地址，不带 /v1。

ANTHROPIC_AUTH_TOKEN 会发送 Authorization: Bearer，最适合 Geekit。也可以用 ANTHROPIC_API_KEY 发送 x-api-key，但不要同时设置多份不一致的令牌。

#3. 验证 Messages

curl "$ANTHROPIC_BASE_URL/v1/messages" \
  -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d "{
    \"model\": \"$GEEKIT_MODEL\",
    \"max_tokens\": 128,
    \"messages\": [
      {\"role\": \"user\", \"content\": \"只回复：连接成功\"}
    ]
  }"

curl 成功后再启动 Claude Code，可快速区分 Geekit 连接问题与客户端配置问题。

#4. 配置用户级设置

Claude Code 支持在 ~/.claude/settings.json 的 env 中设置环境。为避免把令牌长期写入明文文件，建议这里只持久化非敏感地址，并通过系统密钥管理器、加密凭据流程或启动脚本注入 ANTHROPIC_AUTH_TOKEN。

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://geekit.yryq.top"
  }
}

不要把真实令牌写入项目级 .claude/settings.json，该文件可能被提交或分享。

#5. 启动并验证 Claude Code

Bash / Zsh：

claude --model "$GEEKIT_MODEL"

PowerShell：

claude --model $env:GEEKIT_MODEL

进入 Claude Code 后：

1. 运行 /status，确认当前模型和认证状态。
2. 让 Claude Code 读取一个小文件，不立即修改。
3. 再执行一次需要工具调用的简单任务。
4. 在 Geekit 日志中确认请求路径为 /v1/messages。
5. 核对模型、流式状态和 Token。

#VS Code 扩展

Claude Code 的 VS Code 扩展需要配置同一组环境变量。通过扩展设置中的环境变量入口添加 ANTHROPIC_BASE_URL 和安全注入的 ANTHROPIC_AUTH_TOKEN；修改后重启扩展会话。不要把真实令牌提交到工作区设置。

#常见问题

#Base URL 返回 404

ANTHROPIC_BASE_URL 不带 /v1。Claude Code 会自行请求 /v1/messages，填成 https://<地址>/v1 会产生重复路径。

#/v1/messages/count_tokens 不存在

该接口对 Claude Code Gateway 是可选项。Geekit 尚未公开它时，Claude Code 可以在本地估算上下文，不应阻断主请求。

#非 Claude 模型表现异常

Anthropic 官方不支持通过 Gateway 把 Claude Code 路由到非 Claude 模型。请改用 Geekit 中的 Claude 系模型，或为其他模型选择 Codex、OpenClaw、Hermes 等客户端。

#工具流式输出较慢

自定义 Base URL 下，细粒度工具流可能默认关闭。确有需要且已验证模型兼容时，将下面一行加入 ~/.zshrc 或 ~/.bashrc：

export CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING=1

PowerShell 用户可永久设置：

[Environment]::SetEnvironmentVariable("CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING", "1", "User")

#Claude 桌面端

Claude 桌面端不会自动读取 CLI 的 ANTHROPIC_BASE_URL。需要在 Developer 中单独配置 Third-Party Inference；网关模式只支持本地会话，Remote Control 不可用。

#恢复官方连接

Zsh / Bash 用户从 shell 配置文件中删除 Geekit 与 Anthropic 相关行，再重新打开终端。需要同时清理当前终端时执行：

unset GEEKIT_API_KEY
unset GEEKIT_MODEL
unset ANTHROPIC_BASE_URL
unset ANTHROPIC_AUTH_TOKEN
unset ANTHROPIC_API_KEY

PowerShell 用户删除用户级永久变量：

[Environment]::SetEnvironmentVariable("GEEKIT_API_KEY", $null, "User")
[Environment]::SetEnvironmentVariable("GEEKIT_MODEL", $null, "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", $null, "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", $null, "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", $null, "User")
[Environment]::SetEnvironmentVariable("CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING", $null, "User")

如已在用户设置中保存 Base URL，也一并删除。完成后重新打开终端并启动 Claude Code。

#官方资料

• Claude Code 安装、更新与卸载
• 连接 Claude Code 到 LLM Gateway
• Claude Code Gateway 协议参考