DeepSeek 接入教程

通过 CC Switch 或手动配置，将 DeepSeek 分别接入 Codex 和 Claude Code CLI

≡ ON THIS PAGE

适合什么场景一、开始前准备二、接入 Codex 方式一：通过 CC Switch 接入方式二：手动配置三、接入 Claude Code CLI 方式一：通过 CC Switch 接入方式二：手动配置四、验证是否成功五、常见问题六、官方兼容性参考

适合什么场景

这篇教程适合已经准备使用 DeepSeek 模型做代码工作的用户。你可以通过 CC Switch 或手动配置，把 DeepSeek 模型接入 Codex 或 Claude Code CLI，用来阅读项目、生成代码、排查报错、重构和做代码审查。

一、开始前准备

Base URL

https://ai-api.itapi.com

API Key

服务平台控制台创建的真实密钥。

模型 ID

登录服务平台，进入模型广场，复制当前账户可用的 DeepSeek 模型 ID。

Codex / Claude Code CLI

接入 Codex 前确认 Codex 客户端或 codex CLI 可用；接入 Claude Code CLI 前确认 claude CLI 命令可用。

CC Switch

若通过 CC Switch 接入，先安装并确认 CC Switch 可以正常打开。

二、接入 Codex

这里分成两种方式：通过 CC Switch 接入，或者直接手动配置。

方式一：通过 CC Switch 接入

打开 CC Switch，进入 Codex 对应的配置入口。

登录服务平台，进入模型广场，筛选 DeepSeek 并复制要使用的模型 ID。

选择或新增 DeepSeek Provider，填写 API 地址 https://ai-api.itapi.com、API Key 和刚复制的模型 ID。

保存并启用该配置。

完全退出 Codex 桌面客户端，或关闭当前终端后重新打开，再启动 Codex。

方式二：手动配置

如果你更习惯直接改文件，可以按现有 Codex 接入教程的手动配置方式来做。这里要做的事情很简单，就是把 Codex 配置里的模型、Base URL 和密钥换成 DeepSeek 对应值。

打开 Codex 使用的用户目录 .codex。

按现有 Codex 配置结构写入 auth.json 和 config.toml。

登录服务平台，进入模型广场，复制要使用的 DeepSeek 模型 ID。

把 Base URL 改成 https://ai-api.itapi.com，把模型改成刚复制的模型 ID。

保存后完全退出 Codex，再重新启动。

三、接入 Claude Code CLI

这里也分成两种方式：通过 CC Switch 接入，或者直接手动配置。

方式一：通过 CC Switch 接入

打开 CC Switch，进入 Claude Code CLI 对应的配置入口。

登录服务平台，进入模型广场，筛选 DeepSeek 并复制要使用的模型 ID。

选择或新增 DeepSeek Provider，填写 API 地址 https://ai-api.itapi.com、API Key 和刚复制的模型 ID。

保存并启用配置。

关闭旧终端，重新打开终端后进入项目目录，运行 claude。

方式二：手动配置

如果你更习惯直接改 settings.json，就按现有 Claude Code 接入教程的手动配置方式来做。核心是把 Anthropic 兼容入口换成服务平台提供的 DeepSeek 地址。

{
  "alwaysThinkingEnabled": false,
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "your_api_key",
    "ANTHROPIC_BASE_URL": "https://ai-api.itapi.com",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "your_model_id",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "your_model_id",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "your_model_id",
    "ANTHROPIC_MODEL": "your_model_id",
    "CLAUDE_CODE_ATTRIBUTION_HEADER": "0",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  },
  "permissions": {
    "allow": [],
    "deny": []
  }
}

四、验证是否成功

配置完成后，不建议第一步就让工具改代码。先在一个低风险项目中执行只读任务，确认认证、模型和项目读取都正常。

在项目目录中启动 Codex：

codex

然后输入：

请只阅读当前项目，不要修改任何文件。先说明这个项目的目录结构和主要技术栈。

在项目目录中启动 Claude Code CLI：

claude

然后输入：

请只阅读当前项目，不要修改任何文件。先说明这个项目的目录结构和主要技术栈。

五、常见问题

Q.CC Switch 配置后 Codex 仍然没有变化

先完全退出 Codex 桌面客户端，或关闭当前终端重新打开。仍不生效时，检查 CC Switch 写入的是不是当前 Codex 真正读取的用户目录。Windows PowerShell、WSL、远程服务器通常是不同环境。

Q.Claude Code CLI 仍然走旧模型

关闭旧终端，重新打开新终端后运行 claude。进入 Claude Code CLI 后可以用 /status 查看当前状态；如果模型映射没有变化，回到 CC Switch 或 settings.json 检查 Claude Code CLI 配置是否已经切换到 DeepSeek Provider。

Q.提示模型不存在

回到服务平台的模型广场，确认该模型对当前账户可用，并重新复制完整模型 ID。模型 ID 区分大小写、连字符和后缀，不能用展示名称代替。

Q.提示认证失败或接口地址错误

检查 API Key 是否完整复制、Base URL 是否为 https://ai-api.itapi.com，以及密钥是否仍有可用额度。Codex 使用手动配置时，还要确认 auth.json 中的键名是 OPENAI_API_KEY。

六、官方兼容性参考

DeepSeek 官方文档说明其 API 兼容 OpenAI 和 Anthropic 调用方式，因此可以通过兼容配置接入 Codex 和 Claude Code CLI。具体可使用的模型 ID、价格和可用性仍以服务平台模型广场为准。

DeepSeek 官方 API 文档