claude code api 接入指南：Claude Code 如何连接第三方 API

核心要点（TL;DR）

如果你正在搜索 claude code api，真正要分清的是两件事：第一，怎么让 Claude Code 通过第三方模型 API 运行；第二，怎么让 Claude Code 连接你自己的业务 API。很多人把这两类接法混在一起，结果 claude code api 配了半天还是不能用。

这篇文章给你一个直接可落地的结论：如果你的目标是替换官方模型入口，优先看 Bedrock、Vertex AI 和 LLM Gateway；如果你的目标是让 Claude Code 调用外部系统、数据库或内部接口，优先用 MCP。从部署成本、权限管理到命令示例，本文都会按 claude code api 的实操顺序讲清楚。

claude code api 到底有哪两种接法

讨论这个问题时，最常见的误区就是把“模型接入”与“工具接入”混为一谈。前者决定 Claude Code 用哪个模型提供方；后者决定 Claude Code 能不能访问你的第三方业务接口。

你可以这样理解：

场景	你要解决的问题	推荐方案
Claude Code 不想直连官方接口	让 Claude Code 走第三方模型通道	Bedrock、Vertex AI、LLM Gateway
Claude Code 要访问内部系统或 SaaS API	让 Claude Code 具备外部工具能力	MCP

如果你只是想把 Claude Code 切到第三方提供商，重点看环境变量和模型版本固定；如果你要让 Claude Code 调 CRM、工单系统、支付系统或内部服务，重点看 MCP server 的暴露方式与鉴权。

方案一：让 claude code api 走第三方模型 API

官方文档已经明确给出 Claude Code 的第三方提供商接法，当前最稳的三条路径是 Amazon Bedrock、Google Vertex AI 和 LLM Gateway。这三种方式都属于 Claude Code 的“模型入口替换”。

1. claude code api 通过 Bedrock 接入

如果你的公司本来就在 AWS 上，Bedrock 通常是最顺的一种方案。Anthropic 官方文档给出的核心环境变量是：

export CLAUDE_CODE_USE_BEDROCK=1
export AWS_REGION=us-east-1

# 可选：为小模型单独指定区域
export ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION=us-west-2

# 可选：走自定义端点或网关
# export ANTHROPIC_BEDROCK_BASE_URL=https://your-bedrock-gateway.example.com

这里有三个操作重点：

AWS_REGION 不能省，Claude Code 不会自动从 .aws 配置里替你补这个值。
生产环境建议固定模型版本，不要只用 sonnet、opus 这类别名，否则新版本发布后，已有配置可能突然失效。
如果你的组织有统一网关，可以额外配置 ANTHROPIC_BEDROCK_BASE_URL。

对很多团队来说，Claude Code 走 Bedrock 的优势不是“更强”，而是审计、权限、账单都更容易纳入现有云体系。¹

2. claude code api 通过 Vertex AI 接入

如果你使用 GCP，Vertex AI 是另一条官方支持的路线。官方文档给出的最小配置是：

export CLAUDE_CODE_USE_VERTEX=1
export CLOUD_ML_REGION=global
export ANTHROPIC_VERTEX_PROJECT_ID=YOUR-PROJECT-ID

# 可选：走自定义端点或网关
# export ANTHROPIC_VERTEX_BASE_URL=https://aiplatform.googleapis.com

# 可选：需要时关闭 prompt caching
export DISABLE_PROMPT_CACHING=1

这里要注意两点：

Vertex AI 不同区域支持的模型不同，别默认任何区域都能直接跑。
团队部署时也应该固定模型版本，避免 Claude Code 在版本漂移后出现“昨天能用、今天报错”的情况。

如果你本来就把权限、配额、计费集中在 GCP，Vertex AI 往往比临时拼接脚本更适合作为长期入口。²

3. claude code api 通过 LLM Gateway 接入

如果你手里已经有代理层、统一计费层，或者希望把多个模型提供方挂在同一入口后面，那么 LLM Gateway 很适合企业化部署。Anthropic 官方文档里给了 LiteLLM 的示例。

最简单的统一入口写法是：

export ANTHROPIC_AUTH_TOKEN=sk-litellm-static-key
export ANTHROPIC_BASE_URL=https://litellm-server:4000

如果你不想用固定 key，而是想做动态令牌，也可以用 apiKeyHelper。官方文档还说明了：

{
  "apiKeyHelper": "~/bin/get-litellm-key.sh"
}

export CLAUDE_CODE_API_KEY_HELPER_TTL_MS=3600000

这一类接法的核心价值在于：统一认证、成本控制、日志审计、模型路由和回退策略都能在网关层处理。需要注意的是，Anthropic 也明确提醒 LiteLLM 属于第三方服务，安全性和维护责任不由官方兜底。³

方案二：让 claude code api 连接你自己的业务 API

很多人搜 claude code api，其实真正想做的不是“换模型入口”，而是“让 Claude Code 直接调用我的接口”。这时最合适的路线不是硬写 prompt，而是用 MCP。

Anthropic 官方文档对 MCP 的定义很直接：Claude Code 可以通过 Model Context Protocol 连接外部工具、数据库和 API。对于云端服务，官方推荐优先使用 HTTP 方式，而不是旧的 SSE。⁴

1. 用远程 HTTP MCP 把 claude code api 接到业务系统

如果你的第三方 API 已经有一个 MCP Server 包装层，最简单的方式是直接添加远程 HTTP server。例如：

claude mcp add --transport http notion https://mcp.notion.com/mcp

如果你希望把自己的 API 以 JSON 方式加入 Claude Code，也可以使用：

claude mcp add-json weather-api '{"type":"http","url":"https://api.example.com/mcp","headers":{"Authorization":"Bearer your-token"}}'

然后再执行：

claude mcp get weather-api
claude mcp list

这一类配置完成后，Claude Code 的能力就不再只是“写代码”，而是可以真正调用你的外部系统，去查数据、提工单、发请求、拿结果。

2. 用本地 stdio MCP 把 claude code api 接到脚本或内网服务

如果你的接口不方便直接暴露到公网，或者你已经有本地脚本封装，也可以把 Claude Code 接到 stdio 类型的 MCP server。官方示例写法是：

claude mcp add --transport stdio --env AIRTABLE_API_KEY=YOUR_KEY airtable -- npx -y airtable-mcp-server

这里最容易踩坑的是参数顺序。官方文档特别提醒：--transport、--env、--scope、--header 这些参数都必须写在 server name 前面，然后用 -- 分隔 Claude Code 参数和你的 server 命令。

如果你是企业内网场景，这种接法很实用，因为你不需要把内部接口直接暴露出去，只需要让 Claude Code 通过本地进程访问受控能力。⁴

claude code api 接入第三方 API 的推荐顺序

如果你不想一上来就走弯路，可以按下面的顺序判断：

你只是想让 claude code api 换一个模型提供商：先选 Bedrock 或 Vertex。
你已经有统一代理层或预算控制需求：优先上 LLM Gateway。
你想让 Claude Code 调企业系统、数据库、工单、支付、知识库：直接走 MCP。
你要给团队长期使用：固定模型版本、单独做凭证管理、不要把敏感 key 直接写死到仓库里。

这四步基本能覆盖大部分真实接入需求。

claude code api 常见问题与排障

1. 配好了环境变量，Claude Code 还是不走第三方 API

先检查 Claude Code 是不是在同一个 shell 里启动的；再检查环境变量有没有真正导出；最后用 /status 或当前 provider 信息确认它是否已经切换成功。

2. Bedrock 或 Vertex 可以连上，但模型报错

高概率不是命令写错，而是模型版本或区域不匹配。官方文档已经多次强调固定模型版本，这一点很关键。

3. MCP 加进去了，但 Claude Code 调不到工具

优先执行 claude mcp list、claude mcp get <server-name> 和 Claude Code 内的 /mcp 检查状态；其次确认你的 MCP server 是否真的暴露了工具、资源或 prompts。

4. 网关方案为什么经常鉴权失败

如果你在用 Gateway 模式，先确认到底是静态 token、动态 helper 还是云厂商签名在生效。很多这类网关故障，本质上是鉴权链路混用了两套配置。

FAQ

Q1：claude code api 一定要用官方 API 吗？

不一定。当前官方文档明确支持 Bedrock、Vertex AI，以及通过 LLM Gateway 做第三方模型入口配置。¹²³

Q2：claude code api 接第三方 API，MCP 是必须的吗？

如果你要接的是“业务系统 API”，MCP 基本是最标准的方案；如果你只是换模型提供商，则不一定要 MCP。

Q3：claude code api 最适合个人还是团队？

都可以，但团队场景更应该关注模型版本固定、权限边界、动态密钥和审计日志。尤其是它一旦进入生产流程，稳定性比“临时能跑通”更重要。

Q4：claude code api 接入第三方 API 的最低成本方案是什么？

个人开发者通常可以从官方支持的 Bedrock、Vertex 或一个简单的 Gateway 开始；如果只是要把一个内部脚本给 Claude Code 用，那么本地 stdio MCP 往往是最低成本方案。

结语

你可以把 claude code api 的接入问题浓缩成一句话：换模型入口，用 Bedrock / Vertex / Gateway；接业务能力，用 MCP。只要先把这两类路径分开，Claude Code 的配置会立刻清晰很多。

如果你准备今天就动手，最稳的做法不是一次全上，而是先跑通一条链路：要么先把 Claude Code 切到第三方模型提供商，要么先把一个最小 MCP server 接进来。先验证，再扩展，远比一开始堆满配置有效。