pucoding-cli

Pucoding 官方命令行工具，用于快速配置 Claude Code、Codex 和 VS Code 的 API 连接。

安装

npm install -g pucoding-cli

快速开始

安装完成后，直接运行进入交互式向导：

pucoding

向导会引导你完成以下步骤：

1. 选择要配置的平台（Claude Code 或 Codex）
2. 选择目标（原生客户端 或 VS Code）
3. 输入 API Key（Base URL 已预填 Pucoding 默认地址）

在 pucoding.com 注册账号后即可获取 API Key。

命令列表

交互式向导

pucoding         # 进入主菜单
pucoding init    # 直接进入配置向导

Claude Code 配置

# 配置 Claude Code
pucoding claude configure --api-key 你的KEY

# 配置自定义 Base URL
pucoding claude configure --api-key 你的KEY --base-url https://pucoding.com

# 配置 VS Code 中的 Claude 插件
pucoding claude vscode --api-key 你的KEY

# 删除 Claude Code 配置
pucoding claude delete

Codex 配置

# 配置 Codex
pucoding codex configure --api-key 你的KEY

# 指定模型名（默认 gpt-5.5）
pucoding codex configure --api-key 你的KEY --model gpt-5.5

# 配置 VS Code 中的 Codex 插件
pucoding codex vscode --api-key 你的KEY

# 删除 Codex 配置
pucoding codex delete

其他命令

# 查看所有配置文件路径
pucoding paths

# 查看帮助
pucoding --help

默认地址

| 平台 | Base URL | |------|----------| | Claude Code | https://pucoding.com | | Codex | https://pucoding.com/v1 |

配置文件位置

配置完成后，工具会自动写入以下文件：

| 平台 | 文件路径 | |------|----------| | Claude Code | ~/.claude/settings.json | | Claude VS Code | ~/.claude/config.json | | Codex | ~/.codex/auth.json 和 ~/.codex/config.toml | | VS Code | VS Code 用户设置目录下的 settings.json |

Codex CLI 兼容性

为兼容新版 Codex CLI，工具使用自定义 provider ID openai-custom，鉴权完全通过 ~/.codex/auth.json 的 OPENAI_API_KEY，不写入任何系统或 Shell 环境变量，TOML 里也不会保留 env_key。

model_provider = "openai-custom"
model = "gpt-5.5"
model_reasoning_effort = "high"
disable_response_storage = true

[model_providers.openai-custom]
name = "OpenAI"
base_url = "https://pucoding.com/v1"
wire_api = "responses"
requires_openai_auth = true

如果机器上已存在旧配置（任意一条命中即触发迁移）：

• [model_providers.openai] / [model_providers.pucoding]
• model_provider = "pucoding"
• 缺少 model_provider 或缺少 [model_providers.openai-custom] 的半残配置
• 任意 provider 块带有 env_key = "pucoding" / "key88" / "PUCODING_KEY"

工具会在下一次配置或读取状态时自动迁移为 openai-custom，并删除 env_key、保留 base_url、wire_api、requires_openai_auth 等字段。

默认模型为 gpt-5.5。在 CLI 中你也可以通过 --model 或交互式输入改成任意模型名。

配置生效说明

• Claude Code / Codex：配置在下次启动应用时生效。Codex 直接读取 auth.json，不再依赖 pucoding 等环境变量
• VS Code：配置后需在 VS Code 中执行「重新加载窗口」

系统要求

• Node.js >= 18