前置安装

Windows 也推荐在 WSL 下进行，因为 WSL 的 Linux 命令对于 AI 来说更加熟悉。

安装 Node.js，推荐使用 pnpm 包管理器，速度更快。
Node.js — Download Node.js®

下载并安装 nvm

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash

代替重启 shell：

\. "$HOME/.nvm/nvm.sh"

下载并安装 Node.js：

nvm install 24

验证 Node.js 版本：

node -v   # 应输出 "v24.11.0"

验证 npm 版本：

npm -v    # 应输出 "11.6.1"
npm install -g pnpm

验证 pnpm 版本：

pnpm -v
pnpm setup

AI 喜欢的文件工具

sudo apt install ripgrep tree

如果你有读 PDF 需求

sudo apt install poppler-utils -y

别名 python -> python3

软连接更方便，新版 Linux 不会用到系统 python：

sudo ln -s /usr/bin/python3 /usr/bin/python

修改 ~/.bashrc：

alias python='python3'

自用批量更新脚本

pnpm add -g @anthropic-ai/claude-code
pnpm add -g @openai/codex@latest
pnpm add -g @google/gemini-cli

推荐中转站（按量付费）

https://duckcoding.com/register?aff=Z9U7

Claude Code

安装/更新命令

安装

pnpm install -g @anthropic-ai/claude-code

更新

pnpm add -g @anthropic-ai/claude-code

修改配置文件

写入 key 和 baseurl。

配置位置（Windows）：%USERPROFILE%\.claude\settings.json
配置位置（Linux）：~/.claude/settings.json

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "粘贴为Claude Code专用分组令牌key",
    "ANTHROPIC_BASE_URL": "https://jp.duckcoding.com"
  }
}

修改配置方便 VSCode 使用：~/.claude/config.json

{
  "primaryApiKey": "duckcoding"
}

设置记忆，比如让他强制说中文，直接编辑文件 ~/.claude/CLAUDE.md

安装 VSCode 插件（推荐）

安装之后在 Windows 的 WSL 中可以更方便地粘贴来自 Windows 的截图，可以类似 Cursor 的对话使用，而不是在命令行使用。

搜索 Claude Code 安装这个官方的插件：

用 Ctrl + , 打开设置，允许自动跳过（类似 Codex 的 full access）：

之后就有这个功能：

Codex

安装/更新命令

安装

pnpm install -g @openai/codex@latest

更新

pnpm add -g @openai/codex@latest

修改配置文件

写入 key 和 baseurl。

mkdir -p ~/.codex
cd ~/.codex

创建配置文件 config.toml：

cat > config.toml << 'EOF'
model_provider = "duckcoding"
model = "gpt-5-codex"
model_reasoning_effort = "high"
network_access = "enabled"
disable_response_storage = true

[model_providers.duckcoding]
name = "duckcoding"
base_url = "https://jp.duckcoding.com/v1"
wire_api = "responses"
requires_openai_auth = true
EOF

创建认证文件 auth.json：

cat > auth.json << 'EOF'
{
  "OPENAI_API_KEY": "**粘贴为CodeX专用分组令牌key**"
}
EOF

安装 VSCode 插件（推荐）

安装之后在 Windows 的 WSL 中可以更方便地粘贴来自 Windows 的截图，可以类似 Cursor 的对话使用，而不是在命令行使用。

搜索 Codex 安装这个官方的插件：

安装 happy 方便远程手机 vibe coding

项目地址：https://github.com/slopus/happy

pnpm install -g happy-coder

启动 Claude：

happy

启动 Codex：

happy codex

可以选择在手机 App 或者 Web 浏览器授权：

扫描二维码即可。

opencode

pnpm install -g opencode-ai

更新：

pnpm add -g opencode-ai

Gemini CLI

使用较少，只记录安装方法。Gemini 适合对困难任务分析（在我的认知里），官方的 VSCode 插件比较拉跨，不能 WSL 上传 Windows 图片。

pnpm install -g @google/gemini-cli

更新：

pnpm add -g @google/gemini-cli

Codex Windows 乱码修复

参考文档：Codex在windows系统下乱码问题

1. 按下快捷键 Win + R，打开左下角运行窗口，输入以下命令后回车：

intl.cpl

2. 点击上侧选项卡“管理”，再点击红色箭头所示的“更改系统区域设置”按钮：

3. 勾选红色箭头所指选项，点击确定。然后在刚才的窗口也点击确定，之后重启一下你的电脑再使用 Codex，即可避免乱码：