Freecode 接入指南#
更新日期：2026-10-13
Freecode 提供统一的 AI 模型接口。你可以通过命令行编程工具、配置切换工具，或 Python / JavaScript SDK 接入。
先准备这三项#
界面默认使用繁体中文：API 密钥显示为「API 金鑰」，模型广场显示为「模型廣場」。本文示例中的 sk-your-freecode-api-key 都是占位符，使用时替换成自己的完整密钥。
地址速查#
| 用途 | 填写内容 |
|---|---|
| 网站 / 控制台入口 | https://api.freecode.cc |
| OpenAI SDK、Codex 的 API Base URL | https://api.freecode.cc/v1 |
| Claude Code、Anthropic SDK 的 Base URL | https://api.freecode.cc |
| 模型发现接口 | GET https://api.freecode.cc/v1/models |
| OpenAI Responses 请求 | POST https://api.freecode.cc/v1/responses |
| OpenAI Chat Completions 请求 | POST https://api.freecode.cc/v1/chat/completions |
| Anthropic Messages 请求 | POST https://api.freecode.cc/v1/messages |
客户端配置中的 Base URL 不要填写完整的 /responses、/messages 或 /chat/completions 地址，客户端会自行追加接口路径。
按使用方式阅读#
| 你想做什么 | 文档 |
|---|---|
| 创建密钥，发出第一个请求 | 01 · 快速开始 |
| 从 Freecode 一键导入 CC Switch | 03 · CC Switch |
| 配置 Claude Code | 04 · Claude Code |
| 配置 Codex CLI | 05 · Codex CLI |
| 在 Python / JavaScript 中调用 OpenAI 格式接口 | 06 · OpenAI SDK |
| 在 Python / JavaScript 中调用 Claude 格式接口 | 07 · Anthropic SDK |
| 给多个密钥设置分组优先顺序和备用分组 | 分组链使用指南 |
| 遇到鉴权、分组、地址或模型问题 | 常见问题 |
示例模型#
本文使用 gpt-6.1-sol、gpt-4o、claude-sonnet-4-6、claude-opus-4-6、claude-haiku-4-5。这些名称已在整理时的线上模型广场核对。模型能否调用，还取决于你所选密钥的分组、模型限制和对应接口；配置时复制完整模型 ID，保留大小写和后缀。
分组与分组链#
首次接入建议先选择一个包含目标模型的分组，跑通后再按需要配置分组链。
在 API 密钥页打开「分組鏈」，新建链并选择分组，按希望尝试的顺序排列、保存；再编辑目标 API 密钥，在分组选择中选中这条链。客户端仍使用同一把密钥和相同 Base URL，不需要把分组名写进请求。
分组链复用你设定的分组顺序进行路由与重试，不保证所有类型的错误都会切换。请在使用日志中核对实际使用的模型、分组和费用。
完整步骤、切换规则及修改和删除的影响，见 分组链使用指南。
使用与分享#
每个工具使用独立密钥，方便查看用量、撤销或调整额度。「无限额度」仅表示不额外设置密钥额度上限，调用仍使用账户余额并正常计费。
本目录提供分篇 Markdown 和合订版；PDF 可直接发给接入方。不要在文档、截图或公开仓库中填入真实密钥。遇到问题时只提供时间、模型、工具版本、HTTP 状态和 request ID。