このチュートリアルでは、Windows環境での構成フロー、検証方法、問題が発生した場合に優先的に確認すべき場所についてのみ説明します。
モデル名、クライアントバージョン、公式スクリプトの内容は時間とともに更新される場合があります。実際にはDeepSeekの公式ページに表示される情報に従ってください。
参考文献より：
- DeepSeek公式コードアクセスガイド
- DeepSeekの公式設定スクリプト
準備：DeepSeek APIキーの申請
DeepSeekコンソールに移動してAPIキーを作成します。
https://platform.deepseek.com/top_up
APIキーのセキュリティ上の注意事項
古いキーが次の場所に現れた場合：
- スクリーンショット画面
- チャット·レコード
- 記事のチュートリアル
- コードウェアハウス
- ソーシャル·プラットフォーム
DeepSeekコンソールで直ちに取り消し、使用しないでください。
新しいAPIキー：
- 自分のパソコンにのみ入力する
- 誰にも送らない。
- スクリーンショットはなし。
- コードストアにコミットしない
その他の注意事項：
DeepSeekの公式設定スクリプトは、Power Shellのカレントウィンドウで一時的にキーを使用するだけでなく、Codexユーザ設定ディレクトリに認証情報を書き込むことができます。
そのため、以下のディレクトリも機密ディレクトリとして保護する必要があります。
C:\Users\你的用户名\.codex\
全体をアップロードしない。 .codex ファイルを共有しないでください。
チュートリアルのスクリーンショットのAPIキーページの推奨事項：
- コードが必要。
- 相対パスを使用して画像リソースを保存し、コンピュータの交換やリリース後の失敗を避ける
例：
DeepSeekの公式設定スクリプトを実行する
Windows Power Shellを開きます。
irm https://cdn.deepseek.com/api-docs/codex-deepseek-setup-en.ps1 | iex
この命令は、
- DeepSeekからPower Shellスクリプトをダウンロードする
- 今すぐプロビジョニングプロセスを実行
住所は公式のものですが、注意が必要です。
リモートスクリプトの直接実行自体にはまだリスクがあります。
なじみのないチュートリアルから同様のコマンドをコピーしないでください。
安心できない場合：
- まずスクリプトを開きます。
- 出典の確認
- 再実装する。
設定手順
メニューが表示されたら、次の手順に従います。
- 入力：
1
- 選択する：
deepseek-v4-flash
- プロンプトに従って、新しく作成したDeepSeek APIキーを入力します。
- スクリプトが構成を完了するまで待機
Deepseek-V 4-Proについて
スクリプトメニューに表示される特定のモデル名は、現在のクライアントバージョンと公式アクセスステータスが完全にサポートされていることを意味しません。
メニューにモデル名が表示されているからといって選択しないでください。
正しい方法で：
- DeepSeekの現在の公式ドキュメント
- モデル名を確認する
- クライアントバージョン要件の確認
- 推奨アクセス方法の確認
しないで：
- キーをコマンドに入力します。
- キーを公開スクリプトに書き込む
- 記事に本当のキーを表示する
Codexを再起動し、3段階検証を行う
設定完了後：
- Codexデスクトップから完全に終了
- Codexを再起動する
プロジェクトを直接変更しないでください。
次の手順で検証することをお勧めします。
ステップ1：基本モデル要求テスト
入力：
只回复 OK
戻る場合：
OK
コメント：
- APIリクエストはほぼ成功しました
- Providerの構成は正常である可能性がある
出現する場合：
- 401
- モデルは存在しない。
- Providerエラー
Codexにプロジェクトを実行させないでください。
優先検査：
- APIキー
- モデル名モデル名
- Provider設定
- クライアント側のバージョン
ステップ2：読み取り専用ファイルテスト
入力：
只读当前工作区中的一个文本文件，告诉我它主要写了什么，不要修改任何文件
確認のために：
- Codexがワークスペースにアクセスできるかどうか
- ファイル読み取り機能が正常かどうか
ステップ3：簡単なツール呼び出しテスト
入力：
只列出当前工作区中的文件名，不要创建、删除或修改任何文件
確認のために：
- ツール呼び出しは正常かどうか
- ワークスペース権限が正常かどうか
なぜ3段階に分かれるのか？
なぜなら：
- 基本的なリクエストは主にキー、モデル、プロバイダの問題です。
- ファイルの読み込みに失敗→ワークスペースの権限またはクライアント側の問題の可能性がある
- ツール呼び出しに失敗→ Codexツールチェーンの問題の可能性
原因をすばやく特定するために別々のテスト。
四、元の配置バックアップの場所
公式スクリプトは通常、バックアップディレクトリを作成します。
C:\Users\Administrator\.codex\backup-deepseek\
Windowsユーザー名がAdministratorでない場合：
チェックアウト：
C:\Users\你的用户名\.codex\backup-deepseek\
このディレクトリには以下が含まれます。
- Provider設定
- APIアドレス
- 認証情報
しないで：
- WEBにアップロード。
- 他人にチェックを送る
- 公開倉庫に入れ
ターミナルCodex：最初にバージョンを確認する
デスクトップコーデックと端末コーデックを混同しないでください。
ターミナル版を使用する場合：
最初に実装：
codex --version
例えば、いくつかの環境で検出された：
0.117.0
しかし、DeepSeekの公式設定スクリプトは、次のような新しいバージョンを必要とする場合があります。
0.144.0+
バージョン要件は変更される可能性があり、現在の公式指示に従う必要があります。
更新が必要な場合：
npm install -g @openai/codex
アップグレード後の再確認
codex --version
注意点：
デスクトップのみを使用する場合：
デスクトップが正常に接続されたことを証明する端末バージョン番号を使用しないでください。
最終的な基準は：
- デスクトップ側に対応するプロバイダがあるかどうか
- モデル要求が成功したかどうか
- ファイルの読み取りとツールの呼び出しが正常かどうか
6.よくあるエラーのチェック
1. 401または認証失敗
優先検査：
古いキーを使用していますか？
キーが公開された場合：
直ちに削除して再作成する。
コピーエラーかどうか
チェックアウト：
- 前後のスペース
- 改行文字の改行
- 入力は完了です。
誰にも鍵を渡さないでください。
正しい方法で：
キーを再作成します。ネイティブ設定時にのみ入力します。
2.モデルが存在しない、またはバージョンがサポートされていない
最初に確認：
codex --version
確認した。
- デスクトップ版とターミナル版のどちらを使用しているか
- DeepSeekの現在のモデル名
- 公式に必要な最小クライアントバージョン
バージョンが低い場合：
- クライアントのアップグレード
- 構成スクリプトを再実行する
- 再度検証します。
3. Open AIログインプロセスでDeepSeekキーを使用しないでください。
使用しないでください：
codex login --with-api-key
理由は：
DeepSeek API KeyはOpen AIログイン資格情報ではありません。
DeepSeekが採用する：
- プロバイダのカスタマイズ
- APIアドレスの設定
- 対応通信プロトコル
アクセスを行う。
最後に覚えてください。
- 古いキーが公開され、最初に削除されます。
- DeepSeek API KeyはOpen AIログイン資格情報ではありません。
- インターフェイスにモデルが表示されても、モデルリクエスト、ファイル読み取り、ツール呼び出しが完全に正常であることを意味しません。
構成が成功する基準は、“モデル名が表示される”ではなく、次のようなものです。
- リクエスト成功。
- ファイルの読み取りは正常です。
- ツールは正常です。