Claude Code 不使用 OpenAI chat endpoint，而是向 /v1/messages 发送 Anthropic Messages 请求，因此其 base URL 和凭据必须使用 Claude Code 的 Anthropic 设置。GetVibe 为特定目录中的模型支持 Messages 格式；GPT-6 Luna、GPT-6 Sol 和 GPT-6.1 Sol 与此 CLI 路径不兼容。本指南基于 GetVibe 的 Claude Code 设置以及现有的自定义 endpoint 参考。
安装并配置 Claude Code
使用 Node.js 22 或更高版本安装 CLI：
npm install -g @anthropic-ai/claude-code
mkdir -p ~/.claude编辑 ~/.claude/settings.json，并使用下面的确切字段。这里的 base URL 特意不包含 /v1；Claude Code 会追加 /v1/messages。空的 ANTHROPIC_API_KEY 很重要：如果不设置为空字符串，Claude Code 可能会优先使用其通常的 Anthropic 直接身份验证，而不是自定义 endpoint。
{
"apiKeyHelper": "echo $GETVIBE_API_KEY",
"env": {
"ANTHROPIC_BASE_URL": "https://getvibeapi.com",
"ANTHROPIC_API_KEY": "",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5.5",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5.5",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4.5"
}
}启动 Claude Code 前，先在 shell 中设置密钥：export GETVIBE_API_KEY='your-dashboard-key'。这是 GetVibe 集成文件使用的环境变量。设置文件只引用该变量，不应包含实际密钥。避免在此配置中放入直接的 Anthropic 凭据，因为凭据优先级可能会绕过自定义 endpoint。
在授予写入权限前验证 endpoint
在临时仓库中启动 claude，然后运行 /status。Anthropic base URL 应为 https://getvibeapi.com。先提出一个只读问题，然后请求执行一项小修改并检查 diff。如果请求仍然直接发送到 Anthropic，请确认 ANTHROPIC_API_KEY 是空字符串，并确认 helper 可以读取 GETVIBE_API_KEY。如果看到重复的 /v1/v1/messages，请从 base URL 中移除 /v1。
哪些模型可以通过 Messages 使用？
GetVibe 当前的集成指南列出了 Claude Opus 5.5、Claude Sonnet 5、DeepSeek V4.1 Flash、Gemini 3.8 Flash、GLM-5.3 和 Kimi K3，作为支持 Anthropic Messages 路由的示例。在更改某个槽位前，请查看当前模型目录；协议支持取决于具体模型。GPT-6 Luna、GPT-6 Sol 和 GPT-6.1 Sol 无法通过 Claude Code 的 Messages endpoint 使用。对于这些兼容 Responses 的模型，请改用 Codex CLI。2026年10月3日查看的公开目录快照显示，Sonnet 5.5 的价格为每百万 token $0.168 输入 · $0.84 输出 每百万 token；显示的价格保持实时更新。
有意识地分配模型槽位
Claude Code 支持 Opus、Sonnet 和 Haiku 槽位。GetVibe 的设置示例为这些槽位选择当前 ID，并使用 CLAUDE_CODE_SUBAGENT_MODEL 执行 subagent 工作。一次只更改一个槽位。重启 CLI 后，运行 /status 确认当前使用的模型，并运行一个无害的测试 prompt。不要假设 OpenAI 模型可以放入 Claude 槽位：两者的协议和模型系列处理方式不同。
在成本方面，请使用相同的任务、仓库快照、权限和输出要求比较 Sonnet 与 Opus。记录所有 agent 轮次和修复步骤。Sonnet 5.5 当前的价格显示为每百万输入和输出 token $0.168 输入 · $0.84 输出 每百万 token。目录快照日期为2026年10月3日；制定新会话预算时，请参考链接的模型页面。
控制长时间会话
Agent 会话会不断生成重复上下文。保持指令简洁，排除构建产物和 vendored 目录；如果提供聚焦的文件列表就足够，不要要求 agent 反复读取大型文件。Claude 请求可以使用 cache breakpoint；GetVibe 在缓存文档中说明了缓存行为。保持前缀稳定，并检查 usage 字段，确认是否确实报告了缓存输入。在会话显示 cache read 之前，不要因为理论上的缓存费率更低就将其视为节省。
设定清晰的任务边界，使用正常的权限提示，并检查命令和 diff。较低的 token 价格不会让不安全的 shell 命令变得安全。为了进行可重复的基准比较，每个模型都使用相同的权限模式和工具访问权限。
常见设置失败
- 401：检查
GETVIBE_API_KEY、helper 输出以及为空的ANTHROPIC_API_KEY。 - 流量绕过 GetVibe：检查 shell profile 中的凭据，并使用
/status验证 base URL。 - 模型不可用：复制准确的当前 ID，并在其模型页面上确认 Messages 兼容性。
- URL 错误：设置不带
/v1的根域名；Claude Code 会添加路由后缀。
建立成本基线
上线前，运行一个简短任务和一个真实的多文件修改任务。记录模型 ID、输入和输出用量、报告的缓存读取量、耗时以及测试是否通过。将密钥保存在 secret manager 中，并设置内部告警。这些观察结果可以让团队获得实际的每次修改成本基线，而不是假设每次 coding session 消耗的上下文都相同。当前价格可以在 Sonnet 5.5 模型页面查看。
明确保留模型槽位
Claude Code 具有 Opus、Sonnet 和 Haiku 槽位。只设置团队计划使用的槽位，并在更改设置后使用 /status 确认当前选择。Claude 槽位名称不是协议适配器：仅支持 OpenAI 的模型不会因为被分配到 Sonnet 槽位，就变得兼容 Messages。
在真实会话中测量缓存
使用相同的稳定指令运行一个简短任务和一个多文件任务。比较后续轮次中的缓存读取用量，并记录整个会话的成本。在重复试验之间保持权限、仓库快照和模型槽位不变；否则，比较结果无法判断成本差异究竟来自缓存、额外的工具调用，还是不同的任务。
保护修改和凭据
第一次执行启用写入权限的任务时，使用临时 worktree；检查命令和 diff，并将凭据保存在由 shell 管理的 secret 中。如果密钥进入终端历史记录或共享的设置文件，请立即轮换。通过这些简单的边界，开发者可以在不让每个 prompt 都访问生产数据或未经审核的工作树的情况下探索 agent。