Claude Code 与 Codex CLI 教程：安装、首次运行和 API 接入

想找“Claude 教程”“Codex 教程”的开发者，常常会遇到一个混淆点：Claude Code 和 Codex CLI 都能参与代码任务，但它们不是同一个 API 客户端，登录方式、服务地址与权限配置也不能互相照搬。

这篇按两个独立流程说明如何开始。安装命令以官方文档为准；第三方接入只在服务商明确支持对应客户端时配置。示例命令不会发起模型调用，也不代表在此环境中完成了实测。

资料核验日期：2026 年 10 月 21 日。安装器、模型列表和接入规则可能变化，执行前请再次查看官方文档。

一、Claude Code 教程：安装后先确认认证来源

Anthropic 官方把 Claude Code CLI 的安装与 Messages API SDK 分成不同使用方式。若目的是让 Claude Code 在本地项目协助编码，可按其安装指南安装；若目的是在自己的 Python 程序里调用 Claude 模型，则使用Python SDK 快速开始，不要把 CLI 设置当成 SDK 配置。

官方 Python SDK 快速开始示例：

python -m pip install anthropic

PowerShell 当前会话设置官方 API Key 的示例：

$env:ANTHROPIC_API_KEY = "替换为你的官方API密钥"

Anthropic SDK 会读取 ANTHROPIC_API_KEY，随后可在 Python 代码中创建客户端并调用 client.messages.create(...)。调用前从模型目录选择当前可用模型 ID；不要把旧教程里的模型名称当成永久不变的值。

如果使用第三方服务，请以其专门针对 Claude Code 的教程配置认证变量和 Base URL。DDS Hub 当前公开教程展示 Claude Code 的配置入口，使用 ANTHROPIC_AUTH_TOKEN 和 ANTHROPIC_BASE_URL；官方 SDK 的 ANTHROPIC_API_KEY 是另一种环境变量约定，不能因为名字相似就混用。先在 DDS Hub 对应教程确认当前值、令牌分组和客户端限制，再开始调用。DDS Hub 教程

常见检查：

• Key 是否来自你实际选择的服务，变量名是否符合该客户端文档。
• ANTHROPIC_BASE_URL 是否指向正确服务；不要猜测或重复增加路径前缀。
• 目标令牌是否绑定了包含该模型的分组。
• 服务分组是否允许 Claude Code；DDS Hub FAQ 明确列有仅允许 Claude Code 客户端的限制提示，也列有 Key 未绑定分组的错误。DDS Hub FAQ
• 请求失败时先记录状态码和请求 ID，日志不要输出完整密钥。

二、Codex 教程：CLI 是编码代理，不是通用 API 模型名

OpenAI 的 Codex CLI 可在终端中面向本地仓库工作，也支持通过 codex exec 用于脚本化流程。它需要按 Codex 官方文档安装并登录；首次使用可从项目目录启动，阅读计划并审查文件改动后再允许执行高影响命令。Codex CLI 官方文档

Codex 安装器提供 Windows、macOS/Linux 等方式，且命令可能随发行版本调整。请在官方 quickstart 中选对应系统和安装方法，避免复制过期命令。官方说明的基础流程是：安装 CLI、登录、进入项目目录并运行任务。比如先在终端查看安装器给出的当前命令，然后按文档启动：

codex

首次任务可写清目标、允许修改的目录、测试命令和不能触碰的配置。例如：“先检查当前目录的单元测试失败原因；先给出计划，确认后再改动；不要访问 .env 或提交任何密钥。”让工具先检查，再审阅它提出的变更。

Codex 可选模型会随产品更新。应以OpenAI 模型目录和 Codex 自身的模型选择界面为准。不要假设“Codex 模型”就是一个稳定、可直接用于任意 API 的模型 ID；Codex CLI 产品、ChatGPT 计划和 OpenAI API 的计费/认证路径也应分别核对。

三、把 AI 中转站接进来前，先做兼容性验证

“模型页面上有 Claude 或 GPT”不足以证明 Claude Code、Codex CLI、Python SDK 和自建应用都能使用。对每种客户端单独核实：

尤其不要把 DDS Hub 的 Claude Code 环境变量直接放进 Codex 配置。本文核对到 DDS Hub 的 Claude Code 公开配置，但没有据此验证 Codex CLI 通过 DDS Hub 的完整认证、请求路径、模型选择与账单链路。若要使用第三方服务，先查看该服务是否发布了当前 Codex 专用教程；没有明确文档时，使用官方登录流程或向服务商确认，不要臆造 Base URL 和变量名。

四、从一个低风险任务开始

不论使用哪种工具，第一轮都选无敏感信息的小任务：让 Claude Code 解释一个函数，或让 Codex CLI 阅读项目并建议测试命令。确认模型、认证和权限正常后，再扩大任务范围。检查工具实际读取了哪些文件、调用了什么命令、是否产生了可接受的改动，并从平台账单确认请求确实使用了预期模型。

做完后，将 Key 放在环境变量或受控密钥存储中，避免提交到 Git；不再使用的 Key 应撤销。遇到连接问题先区分本地安装、认证、分组权限和上游故障，避免通过随意更换配置扩大暴露面。

Claude Code 和 Codex CLI 都可以进入编码工作流，但配置入口和权限边界各自独立。把“模型 API 怎么调用”和“编码代理怎么登录、授权及执行任务”分开核对，教程才容易照做，问题也更容易定位。

本作品采用《CC 协议》，转载必须注明作者和本文链接