> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dropcv.work/llms.txt
> Use this file to discover all available pages before exploring further.

# Codex CLI

> OpenAI 代码模型命令行工具，支持 Skills 系统。

Codex CLI 是 OpenAI 官方的代码模型命令行工具，支持 Skills 系统和 AGENTS.md 项目指令。

## 安装

<Steps>
  <Step title="安装 Codex CLI">
    ```bash theme={null}
    npm install -g @openai/codex
    ```
  </Step>

  <Step title="配置 API Key">
    ```bash theme={null}
    export OPENAI_API_KEY="你的 API Key"
    ```
  </Step>

  <Step title="创建项目指令文件">
    在项目根目录创建 `AGENTS.md`，告诉 Codex 如何使用 DropCV：

    ```markdown theme={null}
    # 项目说明

    这是一个使用 DropCV 人才库的项目。

    ## DropCV API

    DropCV 提供 Skills API，基础地址：https://api.dropcv.work/api/external/v1

    ### 常用端点

    - POST /skills/candidate_search/invoke - 搜索候选人
    - POST /skills/jd_parse/invoke - JD 文本结构化解析
    - POST /skills/candidate_profile_read/invoke - 候选人详情
    - POST /skills/save_candidate/invoke - 保存候选人
    - POST /skills/candidate_update/invoke - 更新候选人

    ### 认证

    所有请求需要 Header: Authorization: Bearer <API Key>
    ```
  </Step>

  <Step title="开始使用">
    ```bash theme={null}
    codex
    ```

    在对话中：

    * "帮我调用 DropCV API，搜索所有 React 经验 3 年以上的候选人"
    * "写一个脚本，批量调用 DropCV 的 JD 匹配接口"
  </Step>
</Steps>

## 注意

这里通过 AGENTS.md 告诉 AI 如何调用 DropCV 的 RESTful API。完整接口见 [Skills API](/integration/skills/overview) 文档。若你的 Codex CLI 版本支持 MCP，也可参照 [MCP Server](/integration/mcp) 配置。