开发者资源

Claude Code

安装 Claude Code，将其接入 RunAPI，选择模型并验证配置。

查看 Markdown

概览

Claude Code 是在终端中运行的 agentic coding tool。本指南将安装 CLI，把 Anthropic-compatible 请求指向 RunAPI，选择 RunAPI 模型并验证连接。

开始前准备

使用 Claude Code 官方安装指南支持的平台。
在身份验证指南中创建标准 RunAPI API key。不要将密钥提交到源码仓库。
从模型目录复制支持 Anthropic Messages 的 model identifier。

安装

在 macOS、Linux 或 WSL 上使用官方 native installer，然后确认命令可用：

SHELL

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

Homebrew、WinGet 和各平台的完整要求请查看官方安装指南。

配置 RunAPI

首次验证时，在当前 shell 中导出 Base URL、API key 和模型：

SHELL

export ANTHROPIC_BASE_URL=https://runapi.ai
export ANTHROPIC_API_KEY=YOUR_RUNAPI_API_KEY
export ANTHROPIC_MODEL=YOUR_RUNAPI_MODEL_ID

如需对当前用户的所有 Claude Code session 生效，请把这些值写入 ~/.claude/settings.json 的 env object：

JSON

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://runapi.ai",
    "ANTHROPIC_API_KEY": "YOUR_RUNAPI_API_KEY",
    "ANTHROPIC_MODEL": "YOUR_RUNAPI_MODEL_ID"
  }
}

不要把真实密钥写入可能提交到仓库的 .claude/settings.json。配置作用域和优先级请查看 Claude Code settings reference。

选择模型

将 YOUR_RUNAPI_MODEL_ID 替换为模型目录中的准确 identifier。ANTHROPIC_BASE_URL 只改变请求目标，不会选择模型。你也可以用 claude --model YOUR_RUNAPI_MODEL_ID 启动单次 session，或在 session 中运行 /model。

验证

依次验证安装和配置，再发送一条短 prompt：

SHELL

claude --version
claude doctor
claude

在 Claude Code 中运行 /status，确认加载的 settings 和当前模型。向 用一句话描述这个仓库。 收到正常响应，即表示 RunAPI 连接可用。

排查问题

找不到 claude： 重新打开终端，并按官方安装排障指南检查。
settings 未加载： 用 claude doctor 验证 ~/.claude/settings.json，再用 /status 查看已加载的来源。
身份验证失败： 确认 ANTHROPIC_API_KEY 是有效的 RunAPI key。通过身份验证指南创建或轮换密钥。
模型不可用： 从模型目录复制准确 identifier，然后新建 session。恢复的旧 session 可能保留之前的模型。
请求仍使用其他 endpoint： 修改环境变量后打开新终端，并检查是否存在优先级更高的 Claude Code setting。

下一步

协议行为请查看 LLM API 快速开始，请求字段请查看 Anthropic Messages API 参考。如需在 Claude Code 中添加 RunAPI tools，请继续查看 MCP 概览。