Cursor

​

クイック設定

​

1. 設定を開く

​

2. API を設定する

• OpenAI API Key: APIYI のキーを入力します（デフォルトの token をそのまま使えます）
• Override OpenAI Base URL: チェックを入れて https://api.apiyi.com/v1 を入力します
• Verify をクリックして設定を検証します

​

3. モデル設定

​

推奨モデル設定

• claude-sonnet-4-20250514 - Claude 4 Sonnet、プログラミング性能が最強です
• gpt-4.1 - 高速で、総合能力が高いです
• deepseek-v3 - 中国語でのプログラミングに優れ、コストパフォーマンスが高いです

• gpt-4.1-mini - 軽量ですが十分高性能です
• claude-3-haiku - Claude シリーズで最安です
• gemini-2.5-flash - Google の高速応答モデルです

• o4-mini - プログラミングタスク向けの推論モデルとして第一候補です
• o3 - 複雑な推論やアルゴリズム問題に向いています

​

カスタムモデルを追加する

claude-sonnet-4-20250514
gpt-4.1
deepseek-v3
o4-mini
gemini-2.5-pro

​

利用モードの説明

​

チャットモードのワークフロー

1. 対話してコードを生成する
   • Ctrl/Cmd + L を使ってチャットを開く
   • 要件を説明し、AI にコードを生成させる
   • 生成されたコードスニペットを確認する
2. 手動でコードを適用する
   • チャットウィンドウからコードをコピーする
   • 対象ファイルに貼り付ける
   • または「Apply」ボタンを使う（利用可能な場合）
3. 反復して最適化する
   • 会話を続けて修正を依頼する
   • 適用プロセスを繰り返す

​

代替比較

​

コア機能

​

スマートコード補完

• Tab 補完: Tab を押して AI の提案を受け入れます
• 複数行補完: 関数レベルのコード生成に対応しています
• コンテキスト認識: プロジェクト構造に基づいて提案を行います

​

AI 会話

• Ctrl/Cmd + K: コマンドパレットを開きます
• Ctrl/Cmd + L: サイドバーの会話を開きます
• コード説明: コードを選択して AI に質問します

​

コード編集

• コード生成: 要件を記述すると、AI が自動生成します
• リファクタリング提案: 最適化の推奨事項を取得できます
• エラー修正: AI がエラーの特定と修正を支援します

​

キーボードショートカット

​

使い方のヒント

​

1. 明確なコンテキストを提供する

// @context: React component for user authentication
// @requirements: Need to support OAuth2 login
// @constraints: Compatible with NextJS 13+

// AI will generate more accurate code based on this information

​

2. プロンプトを最適化する

// Bad prompt
"Fix this function"

// Good prompt
"Fix floating point precision issue in calculateTotal function, ensure amount calculation accurate to 2 decimal places"

​

3. チャットモードを最大限活用する

• AIに完全なファイル内容を生成させる
• AIに詳細な修正手順を提示してもらう
• AIを使ってコードレビューやリファクタリングの提案を行う

​

トラブルシューティング

​

接続タイムアウト

1. ネットワーク接続を確認する
2. APIアドレスを確認する: https://api.apiyi.com/v1
3. APIキーの有効性を確認する

​

モデルが応答しない

1. 残高を確認する
2. モデルを切り替えてみる
3. Cursor を再起動する

​

コード提案の精度が低い

1. より多くのプロジェクトコンテキストを提供する
2. より具体的なプロンプトを使う
3. 別のモデルを試す

​

ベストプラクティス

​

プロジェクトレベルの設定

{
  "model": "gpt-4.1",
  "temperature": 0.7,
  "contextFiles": ["README.md", "package.json"],
  "rules": [
    "Use TypeScript strict mode",
    "Follow ESLint standards",
    "Add appropriate comments"
  ]
}

​

コード標準

• TypeScriptを使用する
• Airbnbのスタイルに従う
• JSDocコメントを追加する
• 関数型スタイルを使用する

​

セキュリティ意識

• コードに機密情報を含めない
• AI生成コードをレビューする
• サードパーティの依存関係のセキュリティを確認する

​

統合ワークフロー

​

Git連携

# AI generates commit message
git add .
# Use Cursor AI to generate descriptive commit message

​

テスト駆動開発

1. まずテストケースを書きます
2. AIに実装コードを生成させます
3. テストを実行して検証します
4. 繰り返して最適化します

​

コードレビュー

Please review this code, focusing on:
1. Performance issues
2. Security vulnerabilities
3. Code standards
4. Best practices

​

Agentモードが必要ですか？