跳转到主要内容

安装 Codex CLI

用 npm 全局安装(需要先安装 Node.js):

配置老张API

1

设置密钥环境变量

把老张API密钥写进 shell 配置文件,让每次打开终端都能读到:
使用 bash 时改为 ~/.bashrc。Windows PowerShell 可执行 setx LAOZHANG_API_KEY "你的老张API密钥",然后重新打开终端。
2

编辑 config.toml

打开或新建 ~/.codex/config.toml,写入:
  • model_provider 要与 [model_providers.laozhang] 中的名字一致。
  • provider 名字不能用 Codex 保留的 openai、ollama、lmstudio。
  • env_key 填环境变量的名字,不是密钥本身。
3

发一条测试请求

在任意目录运行:
输出 connected 说明配置正确。之后在项目目录运行 codex 进入交互模式。

选择模型

Codex CLI 通过 Responses 接口调用模型,GPT-6 系列可以直接调用工具,不需要额外设置推理强度。 临时换模型时加 -m,例如 codex -m gpt-6-astra。Codex 不认识的模型 ID(例如 gpt-5.4-mini)会提示 Model metadata ... not found,可以正常使用,但上下文长度等信息按默认值处理。各模型价格见模型与价格总表。

常见问题

报 401 或提示缺少环境变量?

Codex 只从 env_key 指定的环境变量读密钥。在运行 Codex 的同一个终端执行 test -n "$LAOZHANG_API_KEY" && echo 已设置,确认变量已设置;修改 shell 配置后要重新打开终端。

报 404 或 stream disconnected?

检查 base_url 是否为 https://api.laozhang.ai/v1,末尾不要多加 / 或 /responses。仍然失败时,在调用日志查看请求是否到达,排查方法见 API Key 无效与 Base URL。

一次任务花了很多 token,正常吗?

正常。Codex 每一步都会带上对话历史、文件内容和工具定义,一次任务可能消耗几十万 tokens。给这个令牌设置授权额度,并在调用日志中查看每次请求的用量;重复的上下文会按缓存价计费,见提示词缓存计费。

相关文档