Codex クイックスタート

5分で Codex CLI のインストールと設定を完了 — QCode.cc で今すぐ AI プログラミングを始めましょう

Codex クイックスタート ¶

すでに Claude Code を使っている方も、AI コーディングツールが初めての方も、このガイドで 5 分以内に Codex CLI を使い始められます。

前提条件 ¶

Node.js v22 LTS 以上
Git 2.x 以上
QCode.cc アカウント（ダッシュボードで API キーを取得）

ステップ 1：インストール ¶

# npm（推奨、全OS対応）
npm install -g @openai/codex

# macOS の場合は Homebrew も可
brew install openai-codex

中国のユーザーは淘宝ミラーを使用できます：npm install -g @openai/codex --registry=https://registry.npmmirror.com

ステップ 2：QCode.cc 設定 ¶

config.toml を作成 ¶

mkdir -p ~/.codex
cat > ~/.codex/config.toml << 'EOF'
model = "gpt-5.4"
provider = "openai"

[providers.openai]
base_url = "https://asia.qcode.cc/openai"
EOF

環境変数を設定 ¶

# ~/.bashrc または ~/.zshrc に追加
export CRS_OAI_KEY=cr_あなたのAPIキー

API キーは QCode.cc ダッシュボードで取得できます。cr_ で始まるキーは Claude Code と共有です。

ステップ 3：動作確認 ¶

# バージョン確認
codex --version

# 簡単なタスクでテスト
codex "現在のディレクトリのファイル一覧を表示して"

正常に応答が返ってくれば設定完了です。

ステップ 4：最初の実践タスク ¶

# プロジェクトディレクトリに移動
cd ~/my-project

# Codex にタスクを依頼
codex "README.md を読んで、このプロジェクトの概要を教えて"

その他の実践例 ¶

# テスト作成
codex "src/utils.ts のユニットテストを書いて"

# バグ修正
codex "TypeScript のコンパイルエラーを修正して"

# コード生成
codex "ユーザー認証用の Express ミドルウェアを作成して"

権限モード ¶

Codex には 3 つの権限モードがあります：

モード	説明	適用場面
Suggest	提案のみ、実行しない	コードレビュー、学習
Auto Edit	ファイル編集は自動、コマンドは確認	日常開発（推奨）
Full Auto	すべて自動実行	CI/CD、バッチ処理

codex --approval-mode suggest "コードを分析して改善点を提案して"
codex --approval-mode full-auto "全テストを実行して失敗を修正して"

よく使うコマンド ¶

コマンド	説明
`codex "タスク"`	タスクを実行
`codex --model gpt-5.3-codex "タスク"`	モデルを指定
`codex --approval-mode full-auto "タスク"`	完全自動モード
`codex --quiet "タスク"`	簡潔な出力